java.util.logging.SocketHandler
A handler that writes log messages to a socket connection.
This handler reads the following properties from the log manager to
initialize itself:
- java.util.logging.ConsoleHandler.level specifies the logging level,
defaults to
Level.ALL
if this property is not found or has an
invalid value;
- java.util.logging.SocketHandler.filter specifies the name of the filter
class to be associated with this handler, defaults to
null
if
this property is not found or has an invalid value;
- java.util.logging.SocketHandler.formatter specifies the name of the
formatter class to be associated with this handler, defaults to
java.util.logging.XMLFormatter
if this property is not found
or has an invalid value;
- java.util.logging.SocketHandler.encoding specifies the encoding this
handler will use to encode log messages, defaults to
null
if
this property is not found or has an invalid value.
- java.util.logging.SocketHandler.host specifies the name of the host that
this handler should connect to. There's no default value for this property.
- java.util.logging.SocketHandler.encoding specifies the port number that
this handler should connect to. There's no default value for this property.
This handler buffers the outgoing messages, but flushes each time a log
record has been published.
This class is not thread-safe.
Summary
Public Constructors
Public Methods
close,
flush,
getEncoding,
getErrorManager,
getFilter,
getFormatter,
getLevel,
isLoggable,
publish,
reportError,
setEncoding,
setErrorManager,
setFilter,
setFormatter,
setLevel
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait
Details
Public Constructors
public
SocketHandler()
Constructs a
SocketHandler
object using the properties
read by the log manager, including the host name and port number.
Throws
IOException
| If failed to connect to the specified host and port. |
IllegalArgumentException
| If the host name or port number is illegal. |
SecurityException
| If a security manager determines that the caller does not
have the required permission to control this handler.
|
public
SocketHandler(String host, int port)
Constructs a
SocketHandler
object using the specified host
name and port number together with other properties read by the log
manager.
Parameters
host
| the host name |
port
| the port number |
Throws
IOException
| If failed to connect to the specified host and port. |
IllegalArgumentException
| If the host name or port number is illegal. |
SecurityException
| If a security manager determines that the caller does not
have the required permission to control this handler.
|
Public Methods
public
void
close()
Closes this handler. The network connection to the host is also closed.
Throws
SecurityException
| If a security manager determines that the caller does not
have the required permission to control this handler.
|
public
void
publish(LogRecord record)
Logs a record if necessary. A flush operation will be done afterwards.
Parameters
record
| the log record to be logged
|