LogManager Klasse

Definition

[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

Vererbung

Object

JavaObject

Object

LogManager

Attribute

RegisterAttribute

Hinweise

Es gibt ein einzelnes globales LogManager-Objekt, das verwendet wird, um einen Satz freigegebener Status zu Loggers und Protokolldiensten zu verwalten.

Dieses LogManager-Objekt: <ul><li> Verwaltet einen hierarchischen Namespace von Logger-Objekten. Alle benannten Logger werden in diesem Namespace gespeichert. <li> Verwaltet eine Reihe von Protokollierungssteuerelementeigenschaften. Hierbei handelt es sich um einfache Schlüsselwertpaare, die von Handlern und anderen Protokollierungsobjekten verwendet werden können, um sich selbst zu konfigurieren. </ul>

Das globale LogManager-Objekt kann mit LogManager.getLogManager() abgerufen werden. Das LogManager-Objekt wird während der Klasseninitialisierung erstellt und kann anschließend nicht mehr geändert werden.

Beim Start befindet sich die LogManager-Klasse mithilfe der Systemeigenschaft "java.util.logging.manager".

Der LogManager definiert zwei optionale Systemeigenschaften, die die Kontrolle über die anfängliche Konfiguration ermöglichen: <ul><li>"java.util.logging.config.class" <li>"java.util.logging.config.file" </ul> Diese beiden Eigenschaften können in der Befehlszeile an den Befehl "java" angegeben werden, oder als Systemeigenschaftendefinitionen, die an JNI_CreateJavaVM übergeben werden.

Wenn die Eigenschaft "java.util.logging.config.class" festgelegt ist, wird der Eigenschaftswert als Klassenname behandelt. Die angegebene Klasse wird geladen, ein Objekt wird instanziiert, und der Konstruktor dieses Objekts ist für das Lesen in der anfänglichen Konfiguration verantwortlich. (Dieses Objekt kann andere Systemeigenschaften verwenden, um seine Konfiguration zu steuern.) Die alternative Konfigurationsklasse kann zum Definieren von Eigenschaften im LogManager verwendet werden readConfiguration(InputStream) .

Wenn die Eigenschaft "java.util.logging.config.class" nicht</b> festgelegt ist<>, kann die Systemeigenschaft "java.util.logging.config.file" verwendet werden, um eine Eigenschaftendatei (im Java.util.Properties-Format) anzugeben. Die anfängliche Protokollierungskonfiguration wird aus dieser Datei gelesen.

Wenn keine dieser Eigenschaften definiert ist, verwendet der LogManager seine Standardkonfiguration. Die Standardkonfiguration wird in der Regel aus der Eigenschaftendatei "lib/logging.properties" im Java Installationsverzeichnis geladen.

Die Eigenschaften für Logger und Handler verfügen über Namen, die mit dem punkttrennten Namen für den Handler oder Logger beginnen.

Die globalen Protokollierungseigenschaften können folgendes enthalten: <ul><li>A-Eigenschaft "handlers". Dadurch wird eine durch Trennzeichen getrennte Liste von Klassennamen für Handlerklassen definiert, die als Handler für den Stammprotokollierer (der Logger mit dem Namen "") geladen und registriert werden. Jeder Klassenname muss für eine Handlerklasse sein, die über einen Standardkonstruktor verfügt. Beachten Sie, dass diese Handler möglicherweise lazily erstellt werden, wenn sie zum ersten Mal verwendet werden.

liA-Eigenschaft "< Logger>. Handler". Dadurch wird eine Leerzeichen- oder kommagetrennte Liste von Klassennamen für Handler definiert, die als Handler für den angegebenen Logger geladen und registriert werden. Jeder Klassenname muss für eine Handlerklasse sein, die über einen Standardkonstruktor verfügt. Beachten Sie, dass diese Handler möglicherweise lazily erstellt werden, wenn sie zum ersten Mal verwendet werden.

liA-Eigenschaft "< Logger>. useParentHandlers". Dadurch wird ein boolescher Wert definiert. Standardmäßig ruft jeder Logger sein übergeordnetes Element zusätzlich zur Verarbeitung der Protokollierungsnachricht selbst auf, was häufig dazu führt, dass auch Nachrichten vom Stammprotokollierer behandelt werden. Wenn Sie diese Eigenschaft auf "false" festlegen, muss ein Handler für diesen Logger konfiguriert werden, andernfalls werden keine Protokollierungsmeldungen übermittelt.

<li>A property "config". Diese Eigenschaft soll das Ausführen von beliebigem Konfigurationscode ermöglichen. Die Eigenschaft definiert ein Leerzeichen oder eine durch Trennzeichen getrennte Liste von Klassennamen. Für jede benannte Klasse wird eine neue Instanz erstellt. Der Standardkonstruktor jeder Klasse kann beliebigen Code ausführen, um die Protokollierungskonfiguration zu aktualisieren, z. B. Protokollierebenen festlegen, Handler hinzufügen, Filter hinzufügen usw. </ul>

Beachten Sie, dass alle während der LogManager-Konfiguration geladenen Klassen zuerst auf dem Systemklassenpfad vor jedem Benutzerklassenpfad durchsucht werden. Dazu gehören die LogManager-Klasse, alle Konfigurationsklassen und alle Handlerklassen.

Logger sind basierend auf ihren punkttrennten Namen in einer Benennungshierarchie angeordnet. Daher ist "a.b.c" ein untergeordnetes Element von "a.b", aber "a.b1" und a.b2 sind Peers.

Alle Eigenschaften, deren Namen mit ".level" enden, werden angenommen, um Protokollebenen für Loggers zu definieren. Daher definiert "foo.level" eine Protokollebene für den Logger namens "foo" und (rekursiv) für eines seiner untergeordneten Elemente in der Benennungshierarchie. Protokollebenen werden in der Reihenfolge angewendet, in der sie in der Eigenschaftendatei definiert sind. Daher sollten Die Ebeneneinstellungen für untergeordnete Knoten in der Struktur nach den Einstellungen für ihre Eltern kommen. Der Eigenschaftsname ".level" kann verwendet werden, um die Ebene für den Stamm der Struktur festzulegen.

Alle Methoden für das LogManager-Objekt sind multithreadsicher.

In 1.4 hinzugefügt.

Java Dokumentation für java.util.logging.LogManager.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.