This documentation differs from the official API. Jadeite adds extra features to the API including: variable font sizes, constructions examples, placeholders for classes and methods, and auto-generated “See Also” links. Additionally it is missing some items found in standard Javadoc documentation, including: generics type information, “Deprecated” tags and comments, “See Also” links, along with other minor differences. Please send any questions or feedback to bam@cs.cmu.edu.


java.util.logging
class SocketHandler

java.lang.Object extended by java.util.logging.Handler extended by java.util.logging.StreamHandler extended by java.util.logging.SocketHandler

public class SocketHandler
extends StreamHandler

Simple network logging Handler.

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. If properties are not defined (or have invalid values) then the specified default values are used.

The output IO stream is buffered, but is flushed after each LogRecord is written.


Constructor Summary

          Create a SocketHandler, using only LogManager properties (or their defaults).
SocketHandler(String host, int port)

          Construct a SocketHandler using a specified host and port.
 
Method Summary
 void

          Close this output stream.
 void

          Format and publish a LogRecord.
 
Methods inherited from class java.util.logging.StreamHandler
close, flush, isLoggable, publish, setEncoding, setOutputStream
 
Methods inherited from class java.util.logging.Handler
close, flush, getEncoding, getErrorManager, getFilter, getFormatter, getLevel, isLoggable, publish, reportError, setEncoding, setErrorManager, setFilter, setFormatter, setLevel
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SocketHandler

public SocketHandler()
              throws IOException
Create a SocketHandler, using only LogManager properties (or their defaults).

Throws:
IOException - if we are unable to connect to the target host and port.

SocketHandler

public SocketHandler(String host,
                     int port)
              throws IOException
Construct a SocketHandler using a specified host and port. The SocketHandler is configured based on LogManager properties (or their default values) except that the given target host and port arguments are used. If the host argument is empty, but not null String then the localhost is used.

Parameters:
host - target host.
port - target port.
Throws:
IOException - if we are unable to connect to the target host and port.
Method Detail

close

public synchronized void close()
                        throws SecurityException
Close this output stream.

Overrides:
close in class StreamHandler
Throws:
SecurityException - if a security manager exists and if the caller does not have LoggingPermission("control").

publish

public synchronized void publish(LogRecord record)
Format and publish a LogRecord.

Overrides:
publish in class StreamHandler
Parameters:
record - description of the log event. A null record is silently ignored and is not published


This documentation differs from the official API. Jadeite adds extra features to the API including: variable font sizes, constructions examples, placeholders for classes and methods, and auto-generated “See Also” links. Additionally it is missing some items found in standard Javadoc documentation, including: generics type information, “Deprecated” tags and comments, “See Also” links, along with other minor differences. Please send any questions or feedback to bam@cs.cmu.edu.
This page displays the Jadeite version of the documention, which is derived from the offical documentation that contains this copyright notice:
Copyright 2008 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
The official Sun™ documentation can be found here at http://java.sun.com/javase/6/docs/api/.