compact1, compact2, compact3

java.util.logging

Class SocketHandler

java.lang.Object

java.util.logging.Handler

java.util.logging.StreamHandler

java.util.logging.SocketHandler

public class SocketHandler
extends StreamHandler

简单网络记录Handler 。

LogRecords被发布到网络流连接。 默认情况下， XMLFormatter类用于格式化。

配置：默认情况下，每个SocketHandler使用以下LogManager 配置属性进行初始化，其中<handler-name>引用处理程序的完全限定类名。 如果未定义属性（或具有无效值），则使用指定的默认值。

• <处理程序名> .LEVEL指定了Handler（默认为Level.ALL）的默认级别。
• <handler-name> .filter指定要使用的Filter类的名称（默认为Filter ）。
• <handler-name> .formatter指定要使用的Formatter类的名称（默认为java.util.logging.XMLFormatter ）。
• <handler-name>。编码要使用的字符集编码的名称（默认为默认平台编码）。
• <handler-name> .host指定要连接的目标主机名（不是默认值）。
• <handler-name> .port指定要使用的目标TCP端口（不使用默认值）。

例如，SocketHandler的SocketHandler将是：

• java.util.logging.SocketHandler.level = INFO
• java.util.logging.SocketHandler.formatter = java.util.logging.SimpleFormatter

对于自定义处理程序，例如com.foo.MyHandler，属性将是：

• com.foo.MyHandler.level = INFO
• com.foo.MyHandler.formatter = java.util.logging.SimpleFormatter

输出IO流被缓冲，但在写入每个LogRecord之后被刷新。

从以下版本开始：

1.4

构造方法摘要

构造方法

Constructor and Description
SocketHandler() 创建一个 SocketHandler ，仅使用 LogManager属性（或其默认值）。
SocketHandler(String host, int port) 使用指定的主机和端口构建一个 SocketHandler 。

方法摘要

Modifier and Type	Method and Description
void	close() 关闭此输出流。
void	publish(LogRecord record) 格式化并发布 LogRecord 。

Methods inherited from class java.util.logging.StreamHandler

flush, isLoggable, setEncoding, setOutputStream

Methods inherited from class java.util.logging.Handler

getEncoding, getErrorManager, getFilter, getFormatter, getLevel, reportError, setErrorManager, setFilter, setFormatter, setLevel

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

SocketHandler

public SocketHandler()
              throws IOException

创建一个 SocketHandler ，仅使用 LogManager属性（或其默认值）。

异常

IllegalArgumentException - 如果主机或端口无效或未指定为LogManager属性。

IOException - 如果我们无法连接到目标主机和端口。

SocketHandler

public SocketHandler(String host,
                     int port)
              throws IOException

使用指定的主机和端口构造一个SocketHandler 。 所述SocketHandler是基于不同的是给定的目标主机和端口参数用于LogManager个属性（或它们的默认值），被配置。 如果host参数为空，而不是空String，则使用localhost。

参数

host - 目标主机。

port - 目标端口。

异常

IllegalArgumentException - 如果主机或端口无效。

IOException - 如果我们无法连接到目标主机和端口。

方法详细信息

close

public void close()
           throws SecurityException

关闭此输出流。

重写：

close在 StreamHandler

异常

SecurityException - 如果存在安全管理员，并且呼叫方没有 LoggingPermission("control") 。

publish

public void publish(LogRecord record)

格式化并发布 LogRecord 。

重写：

publish在类别 StreamHandler

参数

record - 日志事件的描述。 空值记录被默认忽略并且未发布