模块 java.logging

软件包 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类用于格式化。

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

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

例如， 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

构造方法摘要

构造方法

构造器	描述
SocketHandler()	创建 SocketHandler ，仅使用 LogManager属性（或其默认值）。
SocketHandler(String host, int port)	使用指定的主机和端口构造 SocketHandler 。

方法摘要

变量和类型	方法	描述
void	close()	关闭此输出流。
void	publish(LogRecord record)	格式化并发布 LogRecord 。

声明方法的类 java.util.logging.StreamHandler

flush, isLoggable, setEncoding, setOutputStream

声明方法的类 java.util.logging.Handler

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

声明方法的类 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参数为空，但不是null 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 - 日志事件的描述。 静默忽略空记录，不会发布