compact1, compact2, compact3

java.util.logging

Class FileHandler

java.lang.Object

java.util.logging.Handler

java.util.logging.StreamHandler

java.util.logging.FileHandler

public class FileHandler
extends StreamHandler

简单的文件记录 Handler。

的FileHandler可以写入指定的文件，也可以写一个旋转的文件。

对于一个旋转的文件集，因为每个文件达到一个给定的大小限制，它是关闭的，旋转，和一个新的文件打开。先后旧的文件被命名为添加“0”，“1”，“2”，等。到基地文件名。

默认情况下，在“输入输出”库中启用默认缓冲区，但当它完成时，每个日志记录都会被刷新出来。

默认情况下，XMLFormatter类用于格式化。

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

• <程序名称> 。级别指定的 Handler默认级别（默认为 Level.ALL）。
• <程序名称> 。过滤器指定使用一个 Filter类的名称（默认为无 Filter）。
• <程序名称> 。格式化指定使用一个 Formatter类的名称（默认为 java.util.logging.XMLFormatter）
• 编码使用的字符集的名称（默认为默认平台编码）。
• 指定一个在任何一个文件中写入（以字节为单位）的近似最大值。如果这是零，那么就没有极限。（默认为无限制）。
• 指定要循环的输出文件（默认为1）。
• 指定一个用于生成输出文件名的模式。详情见下文。（默认为“% h / java % u.log”）。
• <程序名称> 。追加指定filehandler应该追加到现有文件（默认为false）。

例如，对于FileHandler性能会：

• java util。记录。filehandler水平=信息。
• java util。记录。filehandler格式化= java.util.logging.simpleformatter。

对于自定义处理程序，例如com.foo.myhandler，性能会：

• com。foo。myhandler水平=信息。
• com。foo。myhandler格式化= java.util.logging.simpleformatter。

一个模式由一个字符串组成，该字符串包括以下特殊组件，在运行时将被替换：

• ”/“本地路径分隔符
• “t”系统临时目录
• “用户”系统属性的值““”“”“”“”
• “%克”的生成号来区分旋转日志
• “% U”是解决冲突的唯一号码
• “%”转换为一个单一的百分比符号“%”

如果没有“%”字段已被指定的文件数大于一个，然后生成数量将被添加到生成的文件名结束，后一点。

因此，例如一个模式“% % / java g.log”2个数通常会导致日志文件被写在Solaris /var/tmp / java0.log和/var/tmp / java1.log而在Windows 95上他们会通常写C：\温度\ java0.log和C：\温度“java1.log

生成数按照序列0、1、2等。

通常情况下，“U”唯一字段设置为0。然而，如果FileHandler试图打开文件，发现文件被另一个程序会增加独特的数域，再试一次。这将重复直到FileHandler发现当前不在使用的文件名。如果有一个冲突，没有“% U”字段已被指定，它将被添加在文件名结束后的一个点。（这将是在任何自动添加的生成数。）

因此，如果三个进程都试图登录弗莱德% % g.txt然后他们可能最终使用fred0.0.txt，fred1.0.txt，fred2.0.txt在旋转序列的第一个文件。

请注意，使用唯一的标识来避免冲突，只保证在使用本地磁盘文件系统时能够可靠地工作。

从以下版本开始：

一点四

构造方法摘要

构造方法

Constructor and Description
FileHandler() 构建一个默认的 FileHandler。
FileHandler(String pattern) 初始化一个 FileHandler写入给定的文件名。
FileHandler(String pattern, boolean append) 初始化一个 FileHandler写入给定的文件名，可选的附加。
FileHandler(String pattern, int limit, int count) 初始化一个 FileHandler写入的文件集。
FileHandler(String pattern, int limit, int count, boolean append) 初始化一个 FileHandler写一组可选的附加文件。

方法摘要

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

Constructor Detail

FileHandler

public FileHandler()
            throws IOException,
                   SecurityException

构建一个默认的 FileHandler。这将配置完全从 LogManager性质（或默认值）。

异常

IOException -如果有问题的文件IO口。

SecurityException -如果存在一个安全管理，如果对方没有 LoggingPermission("control"))。

NullPointerException如果模式属性为空字符串。

FileHandler

public FileHandler(String pattern)
            throws IOException,
                   SecurityException

初始化一个 FileHandler写入给定的文件名。

的FileHandler配置基于LogManager性质（或默认值）除了给定的模式参数作为文件名模式，文件限制设置为无限制，而文件数设置为一个。

有没有限制的数据量，可以写的，所以使用这个护理。

参数

pattern -输出文件的名称

异常

IOException -如果有问题的文件IO口。

SecurityException -如果存在一个安全管理，如果对方没有 LoggingPermission("control")。

IllegalArgumentException如果模式是一个空字符串

FileHandler

public FileHandler(String pattern,
                   boolean append)
            throws IOException,
                   SecurityException

初始化一个 FileHandler写入给定的文件名，可选的附加。

的FileHandler配置基于LogManager性质（或默认值）除了给定的模式参数作为文件名模式，文件限制设置为无限制，文件数设置为一个，并追加模式设置为给定的append论点。

有没有限制的数据量，可以写的，所以使用这个护理。

参数

pattern -输出文件的名称

append -指定附加模式

异常

IOException -如果有问题的文件IO口。

SecurityException -如果存在一个安全管理，如果对方没有 LoggingPermission("control")。

IllegalArgumentException如果模式是一个空字符串

FileHandler

public FileHandler(String pattern,
                   int limit,
                   int count)
            throws IOException,
                   SecurityException

初始化一个 FileHandler写入的文件集。当（约）给定的限制已被写入到一个文件，另一个文件将被打开。输出将循环通过一组计数文件。

的FileHandler配置基于LogManager性质（或默认值）除了给定的模式参数作为文件名模式，文件限制设置为极限的说法，和文件数设置为给定的计算参数。

计数必须至少1。

参数

pattern -命名输出文件格式

limit -的最大字节数写入任何文件

count -文件使用的数量

异常

IOException -如果有问题的文件IO口。

SecurityException -如果存在一个安全管理，如果对方没有 LoggingPermission("control")。

IllegalArgumentException -如果 limit < 0，或 count < 1。

IllegalArgumentException如果模式是一个空字符串

FileHandler

public FileHandler(String pattern,
                   int limit,
                   int count,
                   boolean append)
            throws IOException,
                   SecurityException

初始化一个 FileHandler写一组可选的附加文件。当（约）给定的限制已被写入到一个文件，另一个文件将被打开。输出将循环通过一组计数文件。

的FileHandler配置基于LogManager性质（或默认值）除了给定的模式参数作为文件名模式，文件限制设置为极限的说法，和文件数设置为给定数的说法，和添加模式设置为给定的append论点。

计数必须至少1。

参数

pattern -命名输出文件格式

limit -的最大字节数写入任何文件

count -文件使用的数量

append -指定附加模式

异常

IOException -如果有问题的文件IO口。

SecurityException -如果存在一个安全管理，如果对方没有 LoggingPermission("control")。

IllegalArgumentException -如果 limit < 0，或 count < 1。

IllegalArgumentException如果模式是一个空字符串

方法详细信息

publish

public void publish(LogRecord record)

格式和发布 LogRecord。

重写：

publish 方法重写，继承类 StreamHandler

参数

record -日志事件描述。一个空记录被忽略，并没有被发布

close

public void close()
           throws SecurityException

关闭所有文件。

重写：

close 方法重写，继承类 StreamHandler

异常

SecurityException -如果存在一个安全管理，如果对方没有 LoggingPermission("control")。