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

Deklaration

Beschreibung

Die Verarbeitung von bestimmten Protokolleinträgen durch einen Handler kann durch das Setzen einer Log-Ebene oder durch einen geeigneten Filter deaktiviert werden.

Konstruktoren im Detail

protected Handler()

Erzeugt einen Handler, der keine Filterung nach Log-Ebene durchführt, keinen Formatierer und keinen Filter gesetzt hat. Zur Verarbeitung der Fehler wird ein Standard-ErrorManager gesetzt.

Methoden im Detail

public abstract void close()

Schließt diesen Handler und gibt alle mit ihm assoziierten Ressourcen frei. Zur Freigabe eines Handler gehöhrt z. B. das Schließen von benutzten Netzwerkverbindungen, Datenbankverbindungen oder Streams. Beim Aufruf von close() wird zunächstflush() aufgerufen, um noch zwischengepufferte Protokolleinträge vor dem Schließen herauszuschreiben. Geschlossene Handler sollten nicht mehr benutzt werden.

Exception: SecurityException

• Wenn ein SecurityManager gesetzt ist und der Aufruf keine LoggingPermission("control" besitzt.

public abstract void flush()

Schreibt alle zwischengepufferten Protokolleintr6ae;ge heraus.

public String getEncoding()

Liefert den Zeichensatz zurück, der von diesem Handler benutzt wird.

public ErrorManager getErrorManager()

Liefert das ErrorManager-Exemplar zurück, das diesem Handler-Exemplar zugeordnet ist.

public Filter getFilter()

Liefert das Filter-Exemplar zurück, das diesem Handler-Exemplar zugeordnet ist.

public Formatter getFormatter()

Liefert das Formatter-Exemplar zurück, das diesem Handler-Exemplar zugeordnet ist.

public synchronized Level getLevel()

Liefert die Log-Ebene zurück, bis zu der Protokolleinträge von diesem Handler-Exemlar verarbeitet werden. Protokolleinträge, mit tieferen als der gesetzten Log-Ebene werden verworfen.

public boolean isLoggable(LogRecord record)

Prüft, ob der übergebene Protokolleintrag von diesem Handler verarbeitet wird, indem geprüft wird, ob die Log-Ebene des Handlers nicht zu tief ist und ob die Verarbeitung nicht durch einen gesetzten Filter unterbunden wird.

Abgeleitete Handler-Klassen können in dieser Methode ihre eigenen Prüfungen implementieren.

public abstract void publish(LogRecord record)

Verarbeitet den übergebenen Protokolleintrag. Diese Methode wird üblicherweise von Logger-Exemplaren aufgeruen, um die Verarbeitung eines Protokolleintrags zu beginnen.

protected void reportError(String msg, Exception ex, int code)

Diese Methode wird von abgeleiteten Klassen dazu benutzt, um einen Fehler bei der Verarbeitung zu melden.

public void setEncoding(String encoding)

Setzt den Zeichensatz, der von diesem Handler-Exemplar gesetzt wird. Der Zeichensatz sollte gesetzt werden, bevor der erste Protokolleintrag verarbeitet wird.

Exception: SecurityException

• Wenn ein SecurityManager gesetzt ist und der Aufruf keine LoggingPermission("control" besitzt.

Exception: UnsupportedEncodingException

public void setErrorManager(ErrorManager em)

Setzt den ErrorManager für diesen Handler. Immer wenn ein Fehler bei der Verarbeitung von Protokolleinträgen auftritt, die error()-Methode des gesetzten ErrorManager-Exemplars aufgerufen.

public void setFilter(Filter newFilter)

Setzt einen Filter für diesen Handler. Per Voreinstellung ist einem Handler kein Filter zugeordnet. Ist ein Filter gesetzt, wird vor dem Publizieren von Protokolleinträgen geprüft, ob der gesetzte Filter das publizieren zuläßt.

Exception: SecurityException

• Wenn ein SecurityManager gesetzt ist und der Aufruf keine LoggingPermission("control" besitzt.

public void setFormatter(Formatter newFormatter)

Setzt einen Formatierer, der zur Formatierung von Protokolleinträgen benutzt wird.

Exception: SecurityException

• Wenn ein SecurityManager gesetzt ist und der Aufruf keine LoggingPermission("control" besitzt.

public synchronized void setLevel(Level newLevel)

Setzt die Log-Ebene, bis zu der Protokolleinträge von diesem Handler verarbeitet werden. Per Voreinstellung werden Protokolleinträge aller Ebenen verarbeitet. Durch die Einstellung einer Log-Ebene kann man eine einfache Filterung durchführen.

Exception: SecurityException

• Wenn ein SecurityManager gesetzt ist und der Aufruf keine LoggingPermission("control") besitzt.