FileHandler

public class FileHandler
extends StreamHandler

简单的文件记录 Handler 。

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

对于一组旋转的文件，当每个文件达到给定的大小限制时，它将被关闭，旋出，并打开一个新文件。 通过将“0”，“1”，“2”等添加到基本文件名中，相继更旧的文件被命名。

默认情况下，IO库中启用了缓冲，但每个日志记录完成后都会刷新。

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

配置：默认情况下，每个FileHandler都使用以下LogManager配置属性进行初始化。 如果属性未定义（或者具有无效值），则使用指定的默认值。

• java.util.logging.FileHandler.level specifies the default level for the Handler (defaults to Level.ALL).
• java.util.logging.FileHandler.filter specifies the name of a Filter class to use (defaults to no Filter).
• java.util.logging.FileHandler.formatter specifies the name of a Formatter class to use (defaults to java.util.logging.XMLFormatter)
• java.util.logging.FileHandler.encoding the name of the character set encoding to use (defaults to the default platform encoding).
• java.util.logging.FileHandler.limit specifies an approximate maximum amount to write (in bytes) to any one file. If this is zero, then there is no limit. (Defaults to no limit).
• java.util.logging.FileHandler.count specifies how many output files to cycle through (defaults to 1).
• java.util.logging.FileHandler.pattern specifies a pattern for generating the output file name. See below for details. (Defaults to "%h/java%u.log").
• java.util.logging.FileHandler.append specifies whether the FileHandler should append onto any existing files (defaults to false).

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

• "/" the local pathname separator
• "%t" the system temporary directory
• "%h" the value of the "user.home" system property
• "%g" the generation number to distinguish rotated logs
• "%u" a unique number to resolve conflicts
• "%%" translates to a single percent sign "%"

因此，例如，计数为2的“％t / java％g.log”模式通常会导致日志文件在Solaris上写入/var/tmp/java0.log和/var/tmp/java1.log，而在Windows 95上，它们通常会写入C：\ TEMP \ java0.log和C：\ TEMP \ java1.log

世代数字遵循序列0,1,2等。

通常情况下，“％u”唯一字段设置为0.但是，如果FileHandler试图打开文件名并发现该文件当前正在被另一个进程使用，它将递增唯一编号字段并再次尝试。 这将重复，直到FileHandler找到一个当前未使用的文件名。 如果发生冲突并且没有指定“％u”字段，它将在文件名的末尾添加一个点。 （这将在任何自动添加的世代号后面。）

因此，如果三个进程都尝试登录到fred％u。％g.txt，那么他们最终可能会使用fred0.0.txt，fred1.0.txt，fred2.0.txt作为其旋转序列中的第一个文件。

请注意，只有在使用本地磁盘文件系统时，才能保证使用唯一标识符来避免冲突。

Summary

Inherited methods
From class java.util.logging.StreamHandler void close() 关闭当前的输出流。 void flush() 刷新所有缓冲的消息。 boolean isLoggable(LogRecord record) 检查这个 Handler是否会记录给定的 LogRecord 。 void publish(LogRecord record) 格式并发布 LogRecord 。 void setEncoding(String encoding) 设置（或更改）此 Handler使用的字符编码。 void setOutputStream(OutputStream out) 更改输出流。
From class java.util.logging.Handler abstract void close() 关闭 Handler并释放所有关联的资源。 abstract void flush() 冲洗任何缓冲输出。 String getEncoding() 返回此 Handler的字符编码。 ErrorManager getErrorManager() 检索此处理程序的ErrorManager。 Filter getFilter() 获取当前 Filter这 Handler 。 Formatter getFormatter() 返回 Formatter这个 Handler。 Level getLevel() 获取日志级别，指定此 Handler将记录哪些消息。 boolean isLoggable(LogRecord record) 检查这个 Handler是否会记录给定的 LogRecord 。 abstract void publish(LogRecord record) 发布一个 LogRecord 。 void reportError(String msg, 异常 ex, int code) 受保护的便捷方法向此Handler的ErrorManager报告错误。 void setEncoding(String encoding) 设置此 Handler使用的字符编码。 void setErrorManager(ErrorManager em) 为此处理程序定义一个ErrorManager。 void setFilter(Filter newFilter) 设置 Filter以控制此 Handler上的输出。 void setFormatter(Formatter newFormatter) 设置一个 Formatter 。 void setLevel(Level newLevel) 设置日志级别，指定此 Handler将记录哪些消息级别。
From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为该对象调用 notify()方法或 notifyAll()方法，或者其他线程中断当前线程，或者经过一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。

Public constructors

FileHandler ()

FileHandler (String pattern)

FileHandler (String pattern, 
                boolean append)

FileHandler (String pattern, 
                int limit, 
                int count)

FileHandler (String pattern, 
                int limit, 
                int count, 
                boolean append)

Public methods

void close ()

void publish (LogRecord record)