java.lang.Object
   |
   +--java.util.logging.LogRecord

Deklaration

Beschreibung

Klassenname und Methodenname des Erzeugers werden automatisch beim Aufruf der Zugriffsmethoden ermittelt, wenn sie nicht explizit gesetzt werden. Dadurch kann es sein, dass ein Aufruf dieser Methoden nicht das erwartete Ergebnis liefert, wenn sie in einem anderen Thread aufgerufen werden, als der, in dem sie erzeugt wurden.

Der Protokolleintrag ist selbst serialisierbar, um z. B. über RMI übertragen zu können muss die Anwendung darauf achten, dass auch alle darin gespeicherten Parameter serialisierbar sind.

Konstruktoren im Detail

public LogRecord(Level level, String msg)

Erzeugt einen neuen Protokolleintrag mit dem Log-Level level und der Nachricht msg. Bei der Initialisierung wird die Sequenznummer mit einer neuen, fortlaufenden, Nummer belegt, der Zeit wird die aktuelle Zeit zugewiesen, die ID des aktuellen Threads wird gespeichert und alle anderen Parameter werden mit dem Wert null belegt.

Methoden im Detail

public Level getLevel()

Liefert die Log-Ebene, der diesem Protokolleintrag zugeordnet ist, z. B. Level.INFO.

public String getLoggerName()

Liefert den Namen des Protokollieres, der diesen Protokolleintrag erzeugt hat.

public String getMessage()

Liefert die Nachricht vor der Formatierung und Lokalisierung. Die Nachricht kann entweder einen endgültigen Text enthalten, oder einen Wert, der bei der Lokalisierung in einen Anzeigetext umgewandelt wird. Hierzu muß in den zugehörigen Lokalisierungs-Ressourcen dem hier gespeicherten Text ein Anzeigetext zugeordnet sein.

public long getMillis()

Liefert die Zeit, zu der sich das Ereignis ereignete (in Millisekunden seit dem 1.1.1970)

public Object[] getParameters()

Liefert die Parameter, die diesem Protokolleintrag zugeordnet sind.

public ResourceBundle getResourceBundle()

Liefert die zugeordneten Lokalisierungs-Ressourcen zurück, die zur Lokalisierung der Nachricht benutzt wird. Die Methode kann den Wert null zurückliefern, wenn die Nachricht nicht lokalisierbar ist oder keine entsprechenden Ressourcen zugeordnet sind.

public String getResourceBundleName()

Liefert den Namen der zugeordneten Lokalisierungs-Ressourcen zurück, die zur Lokalisierung der Nachricht benutzt werden. Die Methode kann den Wert null zurückliefern, wenn die Nachricht nicht lokalisierbar ist.

public long getSequenceNumber()

Liefert die Sequenznummer zurück. Die Sequenznummern werden üblcherweise im Konstruktor in aufsteigender Reihenfolge vergeben.

public String getSourceClassName()

Liefert den Name der Klasse zurück, die den Protokolleintrag erzeugt hat. Wenn der Name der Klasse nicht explizit gesetzt wurde, wird versucht ihn beim Aufruf dieser Methode automatisch ermittelt. Dadurch kann es zu Ungenauigkeiten kommen oder die Klasse kann überhaupt nicht ermittelt werden. Im letzteren Fall liefert die Methodenull als Ergebnis zurück.

public String getSourceMethodName()

Liefert den Name der Methode zurück, aus der der Protokolleintrag erzeugt wurde. Wenn der Name der Methode nicht explizit gesetzt wurde, wird versucht ihn beim Aufruf dieser Methode automatisch ermittelt. Dadurch kann es zu Ungenauigkeiten kommen oder die Methode kann überhaupt nicht ermittelt werden. Im letzteren Fall wird null als Ergebnis zurück geliefert.

public int getThreadID()

Liefert die ID des Threads, in dem der Protokolleintrag erzeugt wurde.

public Throwable getThrown()

Liefert ein Throwable-Objekt zurück, das mit diesem Protokolleintrag zugeordnet ist. Üblicherweise ist das das Exception-Exemplar, durch den der Protokolleintrag hervorgerufen wurde. Wenn der Protokolleintrag nicht durch eine Fehlersituation hervorgerufen wurde, kann die Methode null zurückliefern.

public void setLevel(Level level)

Setzt die Log-Ebene der Nachricht, z. B. Level.INFO.

public void setLoggerName(String name)

Setzt den Namen des Protokollieres, von dem der Eintrag erzeugt wurde.

public void setMessage(String message)

Setzt die Nachricht. Formattierung und Lokalisierung werden dabei später bei der Verarbeitung des Protokolleintrags durchgeführt.

public void setMillis(long millis)

Setzt die Zeit, zu der das Ereignis eingetreten ist.

public void setParameters(Object[] parameters)

Setzt zusätzliche Parameter, die diesem Protokolleintrag zugeordnet werden.

public void setResourceBundle(ResourceBundle bundle)

Setzt die Ressourcen, mit denen die Lokalisierung von Protokolleinträgen durchgeführt wird.

public void setResourceBundleName(String name)

Setzt den Namen der Ressourcen, mit denen die Lokalisierung von Protokolleinträgen durchgeführt wird.

public void setSequenceNumber(long seq)

Setzt die Sequenznummer dieses Protokolleintrags. Üblicherweise werden die Nummern über den Konstruktor zugewiesen, so dass diese Methode meist nicht benötigt wird.

public void setSourceClassName(String sourceClassName)

Setzt den Namen der Klasse, aus der der Protokolleintrag erzeugt wurde.

public void setSourceMethodName(String sourceMethodName)

Setzt den Namen der Methode, aus der der Protokolleintrag erzeugt wurde.

public void setThreadID(int threadID)

Setzt eine ID zur Identifiezierungs des Threads, von dem die Nachricht erzeugt wurde.

public void setThrown(Throwable thrown)

Setzt ein Throwable-Objekt, das mit diesem Protokolleintrag assoziiert wurde (z. B. beim Eintritt einer Fehlersituation).