filehandler.html
来自「j2se5-api-zh,java文档的中文版本」· HTML 代码 · 共 490 行 · 第 1/2 页
HTML
490 行
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><!--NewPage--><HTML><HEAD><!-- Generated by javadoc (build 1.5.0_03) on Wed Nov 02 09:52:07 CST 2005 --><META http-equiv="Content-Type" content="text/html; charset=gb2312"><TITLE>FileHandler (Java 2 Platform SE 5.0)</TITLE><META NAME="keywords" CONTENT="java.util.logging.FileHandler class"><LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style"><SCRIPT type="text/javascript">function windowTitle(){ parent.document.title="FileHandler (Java 2 Platform SE 5.0)";}</SCRIPT><NOSCRIPT></NOSCRIPT></HEAD><BODY BGCOLOR="white" onload="windowTitle();"><!-- ========= START OF TOP NAVBAR ======= --><A NAME="navbar_top"><!-- --></A><A HREF="#skip-navbar_top" title="跳过导航链接"></A><TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""><TR><TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"><A NAME="navbar_top_firstrow"><!-- --></A><TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> <TR ALIGN="center" VALIGN="top"> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>概述</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>软件包</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>类</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/FileHandler.html"><FONT CLASS="NavBarFont1"><B>使用</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>树</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>已过时</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>索引</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>帮助</B></FONT></A> </TD> </TR></TABLE></TD><TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM><b>Java<sup><font size=-2>TM</font></sup> 2 Platform<br>Standard Ed. 5.0</b></EM></TD></TR><TR><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="ErrorManager.html" title="java.util.logging 中的类"><B>上一个类</B></A> <A HREF="Filter.html" title="java.util.logging 中的接口"><B>下一个类</B></A></FONT></TD><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../index.html@java_2Futil_2Flogging_2FFileHandler.html" target="_top"><B>框架</B></A> <A HREF="FileHandler.html" target="_top"><B>无框架</B></A> <SCRIPT type="text/javascript"> <!-- if(window==top) { document.writeln('<A HREF="../../../allclasses-noframe.html"><B>所有类</B></A>'); } //--></SCRIPT><NOSCRIPT> <A HREF="../../../allclasses-noframe.html"><B>所有类</B></A></NOSCRIPT></FONT></TD></TR><TR><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 摘要： 嵌套 | 字段 | <A HREF="#constructor_summary">构造方法</A> | <A HREF="#method_summary">方法</A></FONT></TD><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">详细信息： 字段 | <A HREF="#constructor_detail">构造方法</A> | <A HREF="#method_detail">方法</A></FONT></TD></TR></TABLE><A NAME="skip-navbar_top"></A><!-- ========= END OF TOP NAVBAR ========= --><HR><!-- ======== START OF CLASS DATA ======== --><H2><FONT SIZE="-1">java.util.logging</FONT><BR>类 FileHandler</H2><PRE><A HREF="../../lang/Object.html" title="java.lang 中的类">java.lang.Object</A> <IMG SRC="../../../resources/inherit.gif" ALT="继承者 "><A HREF="Handler.html" title="java.util.logging 中的类">java.util.logging.Handler</A> <IMG SRC="../../../resources/inherit.gif" ALT="继承者 "><A HREF="StreamHandler.html" title="java.util.logging 中的类">java.util.logging.StreamHandler</A> <IMG SRC="../../../resources/inherit.gif" ALT="继承者 "><B>java.util.logging.FileHandler</B></PRE><HR><DL><DT><PRE>public class <B>FileHandler</B><DT>extends <A HREF="StreamHandler.html" title="java.util.logging 中的类">StreamHandler</A></DL></PRE><P>简单的文件日志记录 <tt>Handler</tt>。 <p><tt>FileHandler</tt> 可以写入指定的文件，也可以写入轮换文件集合。 <p>对于循环文件集合而言，到达每个文件的给定大小限制后，就关闭该文件，将其轮换出去，并打开新的文件。通过在基本文件名中添加 "0"、"1"、"2" 等来依次命名旧文件。 <p>默认情况下，IO 库中启用了缓冲，但当缓冲完成时，每个日志记录都要被刷新。 <p><tt>XMLFormatter</tt> 类默认用于格式化。 <p><b>配置:</b> 默认情况下，每个 <tt>FileHandler</tt> 都是使用以下 <tt>LogManager</tt> 配置属性执行初始化的。如果没有定义属性（或者属性具有非法值），则使用指定的默认值。 <ul><li> java.util.logging.FileHandler.level 为 <tt>Handler</tt> 指定默认的级别（默认为 <tt>Level.ALL</tt>）。<li> java.util.logging.FileHandler.filter 指定要使用的 <tt>Filter</tt> 类的名称（默认为无 <tt>Filter</tt>）。<li> java.util.logging.FileHandler.formatter 指定要使用的 </tt>Formatter</tt> 类的名称（默认为 <tt>java.util.logging.XMLFormatter</tt>）。<li> java.util.logging.FileHandler.encoding 指定要使用的字符集编码的名称（默认使用默认的平台编码）。<li> java.util.logging.FileHandler.limit 指定要写入到任意文件的近似最大量（以字节为单位）。如果该数为 0，则没有限制（默认为无限制）。<li> java.util.logging.FileHandler.count 指定有多少输出文件参与循环（默认为 1）。<li> java.util.logging.FileHandler.pattern 为生成的输出文件名称指定一个模式。有关细节请参见以下内容（默认为 "%h/java%u.log"）。<li> java.util.logging.FileHandler.append 指定是否应该将 FileHandler 追加到任何现有文件上（默认为 false）。 </ul> <p> <p>模式由包括以下特殊组件的字符串组成，则运行时要替换这些组件： <ul><li> "/" 本地路径名分隔符<li> "%t" 系统临时目录<li> "%h" "user.home" 系统属性的值<li> "%g" 区分循环日志的生成号<li> "%u" 解决冲突的惟一号码<li> "%%" 转换为单个百分数符号"%" </ul>如果未指定 "%g" 字段，并且文件计数大于 1，那么生成号将被添加到所生成文件名末尾的小数点后面。 <p> 例如，文件计数为 2 的 "%t/java%g.log" 模式通常导致在 Solaris 系统中将日志文件写入 /var/tmp/java0.log 和 /var/tmp/java1.log，而在 Windows 95 中，则将其写入 C:\TEMP\java0.log 和 C:\TEMP\java1.log。 <p> 按照 0、1、2 等的序列安排生成号。 <p>通常，将惟一字段 "%u" 设置为 0。但是如果 <tt>FileHandler</tt> 试图打开文件名并查找当前被另一个进程使用的文件，则增加惟一的字段号并再次重试。重复此操作直到 <tt>FileHandler</tt> 找到当前没有被使用的文件名。如果有冲突并且没有指定 "%u" 字段，则将该字段添加到文件名末尾的小数点后（它将位于所有自动添加的生成号后面）。 <p>因此，如果三个进程都试图将日志记录到 fred%u.%g.txt，那么它们可能将 fred0.0.txt、fred1.0.txt、fred2.0.txt 作为其循环序列中的首个文件而结束。 <p>注意，使用本地磁盘文件系统时，使用惟一的 id 以避免冲突是系统可靠运行的惟一保证。<P><P><DL><DT><B>从以下版本开始：</B></DT> <DD>1.4</DD></DL><HR><P><!-- ======== CONSTRUCTOR SUMMARY ======== --><A NAME="constructor_summary"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"><B>构造方法摘要</B></FONT></TH></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><B><A HREF="FileHandler.html#FileHandler()">FileHandler</A></B>()</CODE><BR> 构造一个默认的 <tt>FileHandler</tt>。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><B><A HREF="FileHandler.html#FileHandler(java.lang.String)">FileHandler</A></B>(<A HREF="../../lang/String.html" title="java.lang 中的类">String</A> pattern)</CODE><BR> 初始化要写入给定文件名的 <tt>FileHandler</tt> 。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><B><A HREF="FileHandler.html#FileHandler(java.lang.String, boolean)">FileHandler</A></B>(<A HREF="../../lang/String.html" title="java.lang 中的类">String</A> pattern, boolean append)</CODE><BR> 初始化要写入给定文件名的 <tt>FileHandler</tt>（使用可选的 append）。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><B><A HREF="FileHandler.html#FileHandler(java.lang.String, int, int)">FileHandler</A></B>(<A HREF="../../lang/String.html" title="java.lang 中的类">String</A> pattern, int limit, int count)</CODE><BR> 初始化要写入文件集合的 <tt>FileHandler</tt>。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><B><A HREF="FileHandler.html#FileHandler(java.lang.String, int, int, boolean)">FileHandler</A></B>(<A HREF="../../lang/String.html" title="java.lang 中的类">String</A> pattern, int limit, int count, boolean append)</CODE><BR> 初始化要写入文件集合的 <tt>FileHandler</tt>（使用可选的 append）。</TD></TR></TABLE> <!-- ========== METHOD SUMMARY =========== --><A NAME="method_summary"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"><B>方法摘要</B></FONT></TH></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> void</CODE></FONT></TD><TD><CODE><B><A HREF="FileHandler.html#close()">close</A></B>()</CODE><BR> 关闭所有文件。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> void</CODE></FONT></TD><TD><CODE><B><A HREF="FileHandler.html#publish(java.util.logging.LogRecord)">publish</A></B>(<A HREF="LogRecord.html" title="java.util.logging 中的类">LogRecord</A> record)</CODE><BR> 格式化并发布 <tt>LogRecord</tt>。</TD></TR></TABLE> <A NAME="methods_inherited_from_class_java.util.logging.StreamHandler"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"><TH ALIGN="left"><B>从类 java.util.logging.<A HREF="StreamHandler.html" title="java.util.logging 中的类">StreamHandler</A> 继承的方法</B></TH></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><A HREF="StreamHandler.html#flush()">flush</A>, <A HREF="StreamHandler.html#isLoggable(java.util.logging.LogRecord)">isLoggable</A>, <A HREF="StreamHandler.html#setEncoding(java.lang.String)">setEncoding</A>, <A HREF="StreamHandler.html#setOutputStream(java.io.OutputStream)">setOutputStream</A></CODE></TD></TR></TABLE> <A NAME="methods_inherited_from_class_java.util.logging.Handler"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"><TH ALIGN="left"><B>从类 java.util.logging.<A HREF="Handler.html" title="java.util.logging 中的类">Handler</A> 继承的方法</B></TH></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><A HREF="Handler.html#getEncoding()">getEncoding</A>, <A HREF="Handler.html#getErrorManager()">getErrorManager</A>, <A HREF="Handler.html#getFilter()">getFilter</A>, <A HREF="Handler.html#getFormatter()">getFormatter</A>, <A HREF="Handler.html#getLevel()">getLevel</A>, <A HREF="Handler.html#reportError(java.lang.String, java.lang.Exception, int)">reportError</A>, <A HREF="Handler.html#setErrorManager(java.util.logging.ErrorManager)">setErrorManager</A>, <A HREF="Handler.html#setFilter(java.util.logging.Filter)">setFilter</A>, <A HREF="Handler.html#setFormatter(java.util.logging.Formatter)">setFormatter</A>, <A HREF="Handler.html#setLevel(java.util.logging.Level)">setLevel</A></CODE></TD></TR>⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?