public class SocketHandler extends StreamHandler
LogRecords are published to a network stream connection. By default the XMLFormatter class is used for formatting.
Configuration: By default each SocketHandler is initialized using the following LogManager configuration properties where <handler-name> refers to the fully-qualified class name of the handler. If properties are not defined (or have invalid values) then the specified default values are used.
For example, the properties for SocketHandler would be:
For a custom handler, e.g. com.foo.MyHandler, the properties would be:
The output IO stream is buffered, but is flushed after each LogRecord is written.
| Constructor and Description |
|---|
SocketHandler()
Create a SocketHandler, using only LogManager properties
(or their defaults).
|
SocketHandler(String host,
int port)
Construct a SocketHandler using a specified host and port.
|
| Modifier and Type | Method and Description |
|---|---|
void |
close()
Close this output stream.
|
void |
publish(LogRecord record)
Format and publish a LogRecord.
|
flush, isLoggable, setEncoding, setOutputStreamgetEncoding, getErrorManager, getFilter, getFormatter, getLevel, reportError, setErrorManager, setFilter, setFormatter, setLevelpublic SocketHandler()
throws IOException
IllegalArgumentException - if the host or port are invalid or
are not specified as LogManager properties.IOException - if we are unable to connect to the target
host and port.public SocketHandler(String host, int port) throws IOException
host - target host.port - target port.IllegalArgumentException - if the host or port are invalid.IOException - if we are unable to connect to the target
host and port.public void close()
throws SecurityException
close in class StreamHandlerSecurityException - if a security manager exists and if
the caller does not have LoggingPermission("control").public void publish(LogRecord record)
publish in class StreamHandlerrecord - description of the log event. A null record is
silently ignored and is not published Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2016, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.