| Klasse java.util.logging.SocketHandler | 1.4 |
java.lang.Object
|
+--java.util.logging.Handler
|
+--java.util.logging.StreamHandler
|
+--java.util.logging.SocketHandler
Deklaration
public class SocketHandler
extends java.util.logging.StreamHandler
Beschreibung
Diese Klasse veröffentlicht Protokolleinträge, indem sie über Netzwerk verschickt werden. Per
Voreinstellungen werden die Protokolleinträge im vordefinierten XML-Format formatiert.
Bei der Erzeugung eines SocketHandler werden folgende Properties
vom LogManager ermittelt, wenn nicht gesetzt werden die entsprechenden Default-Einstellungen
benutzt:
- java.util.logging.SocketHandler.level
gibt die Default-Log-Ebene an
(voreingestellt ist Level.ALL).
- java.util.logging.SocketHandler.filter
gibt den vollqualifizierten Klassennamen des Filters an, der benutzt werden soll
(per Voreinstellung wird kein Filter benutzt).
- java.util.logging.SocketHandler.formatter
gibt den vollqualifizierten Namen der Klasse des Formatieres an, der benutzt werden soll
(voreingestellt ist java.util.logging.XMLFormatter).
- java.util.logging.SocketHandler.encoding
gibt den Namen des Zeichensatzes an, in dem die Protokolleinträge geschrieben werden sollen
(voreingestellt ist der Default-Zeichensatz der verwendeten Plattform).
- java.util.logging.SocketHandler.host
gibt den Zielrechner an (keine Voreinstellung verfügbar).
- java.util.logging.SocketHandler.port
gibt den Port auf dem Zielrechner an (keine Voreinstellung verfügbar).
Konstruktoren im Detail
-
public SocketHandler()
-
Erzeugt einen SocketHandler, der alle seine Einstellungen
vom LogManager ermittelt. Einstellungen, die nicht im LogManager
verfügbar sind, werden mit Default-Werten belegt.
- Exception: IOException
- Wenn der Zielrechner unter dem angegebenen Port
nicht kontaktiert werden kann.
-
public SocketHandler(String host, int port)
-
Erzeugt einen SocketHandler, der seine Protokolleinträge zum
angegebenen Zielrechner unter dem angegebenen Port schickt.
Alle Einstellungen (mit Ausnahme von Zielrechner und Port) werden
vom LogManager ermittelt. Einstellungen, die nicht im LogManager
verfügbar sind, werden mit Default-Werten belegt.
- Exception: IOException
- Wenn der Zielrechner unter dem angegebenen Port
nicht kontaktiert werden kann.
Methoden im Detail
-
public synchronized void close()
-
Schließt den Ausgabestream.
- Exception: SecurityException
- Wenn ein SecurityManager gesetzt ist und
der Aufruf keine
LoggingPermission"control" besitzt.
-
public synchronized void publish(LogRecord record)
-
Formatiert und veröffentlicht einen Protokolleintrag.
Copyright © 2002 dpunkt.Verlag, Heidelberg. Alle Rechte vorbehalten.