Referenz: java.util.logging.Formatter

Weitere aktuelle Java-Titel finden Sie bei dpunkt.

Klasse java.util.logging.Formatter

1.4

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

Deklaration

public abstract class Formatter extends java.lang.Object

Beschreibung

Diese Klasse stellt einen abstrakten Formatierer dar. Die Aufgabe von Formatieren ist es, Protokolleinträge in eine Zeichenketten zu konvertieren, und zu lokalisieren. Jedem Handler ist ein Formatierer zugeordnet.

Einige Formatierer (wie z. B. XML-Formatierer) benötigen zu Beginn und Ende einer Menge von formatierten Protokolleinträgen Zeichenketten, die den Beginn und das Ende markieren (bei XML-Formatieren Start- und Ende-Tag).

Konstruktoren
protected	Formatter()

Methoden
public abstract String	format(LogRecord record)
public synchronized String	formatMessage(LogRecord record)
public String	getHead(Handler h)
public String	getTail(Handler h)

Konstruktoren im Detail

protected Formatter()
Liefert einen neuen Formatierer zurück.

Methoden im Detail

public abstract String format(LogRecord record)
Formatiert den übergebenen Protokolleintrag als String mit der vordefinierten Lokalisierung.

public synchronized String formatMessage(LogRecord record)
Lokalisiert und formatiert einen Protokolleintrag in einen String. Diese Methode wird üblicherweise von Unterklassen zur Formatierung von Protokolleinträgen aufgerufen.

public String getHead(Handler h)
Liefert den Text zurück, der einer Menge formatierter Protokolleinträge vorangestellt wird. Dies ist bei Formatierern wichtig, die vor Beginn und nach Ende der formatierten Protokolleinträge noch zusätzlichen Text benötigen wie z. B. das Beginn- und Ende-Tag bei einem XML-Formatierer. Die vordefinierte Implementierung liefert einen leeren String zurück, dieses Verhalten sollte bei Bedarf von Unterklassen verändert werden.

public String getTail(Handler h)
Liefert den Text zurück, der an eine Menge formatierter Protokolleinträge angefügt wird. Dies ist bei Formatierern wichtig, die vor Beginn und nach Ende der formatierten Protokolleinträge noch zusätzlichen Text benötigen wie z. B. das Beginn- und Ende-Tag bei einem XML-Formatierer. Die vordefinierte Implementierung liefert einen leeren String zurück, dieses Verhalten sollte bei Bedarf von Unterklassen verändert werden.