LogManager Classe

Définition

[Android.Runtime.Register("java/util/logging/LogManager", DoNotGenerateAcw=true)]
public class LogManager : Java.Lang.Object

[<Android.Runtime.Register("java/util/logging/LogManager", DoNotGenerateAcw=true)>]
type LogManager = class
    inherit Object

Héritage

Object

JavaObject

Object

LogManager

Attributs

RegisterAttribute

Remarques

Il existe un seul objet LogManager global utilisé pour conserver un ensemble d’états partagés sur les enregistreurs d’événements et les services de journal.

Cet objet LogManager : <ul><li> Gère un espace de noms hiérarchique d’objets Logger. Tous les enregistreurs nommés sont stockés dans cet espace de noms. <li> Gère un ensemble de propriétés de contrôle de journalisation. Il s’agit de paires clé-valeur simples qui peuvent être utilisées par des gestionnaires et d’autres objets de journalisation pour se configurer. </ul>

L’objet LogManager global peut être récupéré à l’aide de LogManager.getLogManager(). L’objet LogManager est créé pendant l’initialisation de la classe et ne peut pas être modifié par la suite.

Au démarrage, la classe LogManager se trouve à l’aide de la propriété système java.util.logging.manager.

LogManager définit deux propriétés système facultatives qui autorisent le contrôle sur la configuration initiale : ul li< »java.util.logging.config.class » ><java.util.logging.config.file » >/ul<>< Ces deux propriétés peuvent être spécifiées sur la ligne de commande à la commande « java » ou en tant que définitions de propriétés système passées à JNI_CreateJavaVM. >

Si la propriété «java.util.logging.config.class » est définie, la valeur de la propriété est traitée comme un nom de classe. La classe donnée est chargée, un objet est instancié et le constructeur de cet objet est responsable de la lecture dans la configuration initiale. (Cet objet peut utiliser d’autres propriétés système pour contrôler sa configuration.) La classe de configuration alternative peut être utilisée readConfiguration(InputStream) pour définir des propriétés dans LogManager.

Si la propriété «java.util.logging.config.class » n’est <>pas</b> définie, la propriété système «java.util.logging.config.file » peut être utilisée pour spécifier un fichier de propriétés (au format java.util.Properties). La configuration de journalisation initiale sera lue à partir de ce fichier.

Si aucune de ces propriétés n’est définie, LogManager utilise sa configuration par défaut. La configuration par défaut est généralement chargée à partir du fichier de propriétés «lib/logging.properties » dans le répertoire d’installation Java.

Les propriétés des enregistreurs d’événements et des gestionnaires auront des noms commençant par le nom séparé par des points pour le gestionnaire ou l’enregistreur d’événements.

Les propriétés de journalisation globales peuvent inclure : <ul><li>A, propriété « gestionnaires ». Cela définit une liste d’espaces blancs ou de noms de classes séparés par des virgules pour que les classes de gestionnaires chargent et s’inscrivent en tant que gestionnaires sur l’enregistreur d’événements racine (l’enregistreur d’événements nommé « »). Chaque nom de classe doit être pour une classe de gestionnaire qui a un constructeur par défaut. Notez que ces gestionnaires peuvent être créés de manière différée, lorsqu’ils sont utilisés pour la première fois.

liA, propriété "< logger>. gestionnaires ». Cela définit un espace blanc ou une liste séparée par des virgules de noms de classes pour les classes de gestionnaires à charger et à inscrire en tant que gestionnaires dans l’enregistreur d’événements spécifié. Chaque nom de classe doit être pour une classe de gestionnaire qui a un constructeur par défaut. Notez que ces gestionnaires peuvent être créés de manière différée, lorsqu’ils sont utilisés pour la première fois.

liA, propriété "< logger>. useParentHandlers ». Cela définit une valeur booléenne. Par défaut, chaque enregistreur d’événements appelle son parent en plus de gérer le message de journalisation lui-même, ce qui entraîne souvent la gestion des messages par l’enregistreur d’événements racine. Lorsque vous définissez cette propriété sur false, un gestionnaire doit être configuré pour cet enregistreur d’événements sinon, aucun message de journalisation n’est remis.

<li>A property « config ». Cette propriété est destinée à autoriser l’exécution du code de configuration arbitraire. La propriété définit un espace blanc ou une liste séparée par des virgules de noms de classes. Une nouvelle instance sera créée pour chaque classe nommée. Le constructeur par défaut de chaque classe peut exécuter du code arbitraire pour mettre à jour la configuration de journalisation, comme définir des niveaux d’enregistreur d’événements, ajouter des gestionnaires, ajouter des filtres, etc. </ul>

Notez que toutes les classes chargées pendant la configuration de LogManager sont d’abord recherchées sur le chemin d’accès de classe système avant tout chemin d’accès de classe utilisateur. Cela inclut la classe LogManager, toutes les classes de configuration et toutes les classes de gestionnaire.

Les enregistreurs d’événements sont organisés en hiérarchie d’affectation de noms en fonction de leurs noms séparés par des points. « a.b.c » est donc un enfant de « a.b », mais « a.b1 » et a.b2 sont des pairs.

Toutes les propriétés dont les noms se terminent par . level » sont supposées définir des niveaux de journal pour les enregistreurs d’événements. Ainsi, « foo.level » définit un niveau de journal pour l’enregistreur d’événements appelé « foo » et (de manière récursive) pour l’un de ses enfants dans la hiérarchie d’affectation de noms. Les niveaux de journal sont appliqués dans l’ordre dans lequel ils sont définis dans le fichier de propriétés. Par conséquent, les paramètres de niveau pour les nœuds enfants de l’arborescence doivent venir après les paramètres de leurs parents. Le nom de propriété .level » peut être utilisé pour définir le niveau de la racine de l’arborescence.

Toutes les méthodes de l’objet LogManager sont sécurisées à plusieurs threads.

Ajouté dans la version 1.4.

Java documentation pour java.util.logging.LogManager.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.