logmanager.html
来自「j2se5-api-zh,java文档的中文版本」· HTML 代码 · 共 634 行 · 第 1/3 页
HTML
634 行
<!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:10 CST 2005 --><META http-equiv="Content-Type" content="text/html; charset=gb2312"><TITLE>LogManager (Java 2 Platform SE 5.0)</TITLE><META NAME="keywords" CONTENT="java.util.logging.LogManager class"><LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style"><SCRIPT type="text/javascript">function windowTitle(){ parent.document.title="LogManager (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/LogManager.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="LoggingPermission.html" title="java.util.logging 中的类"><B>上一个类</B></A> <A HREF="LogRecord.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_2FLogManager.html" target="_top"><B>框架</B></A> <A HREF="LogManager.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="#field_summary">字段</A> | <A HREF="#constructor_summary">构造方法</A> | <A HREF="#method_summary">方法</A></FONT></TD><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">详细信息： <A HREF="#field_detail">字段</A> | <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>类 LogManager</H2><PRE><A HREF="../../lang/Object.html" title="java.lang 中的类">java.lang.Object</A> <IMG SRC="../../../resources/inherit.gif" ALT="继承者 "><B>java.util.logging.LogManager</B></PRE><HR><DL><DT><PRE>public class <B>LogManager</B><DT>extends <A HREF="../../lang/Object.html" title="java.lang 中的类">Object</A></DL></PRE><P>存在一个单一的全局 LogManager 对象，它可用于维护 Logger 和日志服务的一组共享状态。 <p>此 LogManager 对象： <ul><li> 管理 Logger 对象的层次结构命名空间。所有指定的 Logger 均存储在此命名空间中。<li> 管理一组日志控制属性。这些是供 Handler 及其他日志对象用于自我配置的简单键-值对。 </ul> <p>可以使用 LogManager.getLogManager() 检索全局 LogManager 对象。LogManager 对象是在类初始化过程中创建的，过后便不能更改。 <p>在启动时，使用 java.util.logging.manager 系统属性定位 LogManager 类。 <p>默认情况下，LogManager 从 JRE 目录的属性文件 "lib/logging.properties" 中读取其初始配置。如果编辑该属性文件，则可更改此 JRE 的所有用户的默认日志配置。 <p>另外，LogManager 使用两个可选的允许更好地控制初始配置读取的系统属性： <ul> <li>"java.util.logging.config.class" <li>"java.util.logging.config.file" </ul>这两个属性可以通过 Preferences API 来设置，既可作为 "java" 命令的命令行属性定义，也可作为传递到 JNI_CreateJavaVM 的系统属性定义。 <p>如果设置了 "java.util.logging.config.class" 属性，则会把属性值当作类名。给定的类将会被加载，并会实例化一个对象，该对象的构造方法负责读取初始配置。（此对象可以使用其他系统属性来控制自己的配置。）此备用配置类可使用 <tt>readConfiguration(InputStream)</tt> 来定义 LogManager 中的属性。 <p>如果<b>未</b>设置 "java.util.logging.config.class" 属性，则会使用 "java.util.logging.config.file" 系统属性来指定一个属性文件（以 java.util.Properties 格式）。从此文件读取初始日志配置。 <p>如果这两个属性都没有定义，则如上所述，LogManager 将从 JRE 目录的属性文件 "lib/logging.properties" 中读取其初始配置。 <p>Logger 和 Handler 的属性名称是以圆点分隔的 Logger 或 Handler 的名称开头。 <p>全局日志属性可以包括： <ul><li>属性 "handlers"。该属性为 handler 类定义类名的空白分隔列表，以便作为处理程序在根 Logger（该 Logger 名为 ""）中加载和注册。每个类名必须用于具有默认构造方法的 Handler 类。注意，刚开始使用这些 Handler 时，它们可能是惰性创建的。<li>属性 "<logger>.handlers"。该属性为 handler 类定义空白分隔或逗号分隔的列表，以便作为处理程序加载和注册到指定的 logger。每个类名必须用于一个具有默认构造方法的 Handler 类。注意，刚开始使用这些 Handler 时，它们可能是惰性创建的。<li>属性 "<logger>.useParentHandlers"。该属性定义一个 boolean 值。默认情况下，每个 logger 除了自己处理日志消息外，还可能调用其父级来处理，这往往也会导致根 logger 来处理消息。将此属性设置为 false 时，需要为此 logger 配置 Handler，否则不传递任何消息。<li>属性 "config"。此属性允许运行任意配置代码。该属性定义类名的空白分隔的列表。为每个指定类创建新实例。每个类的默认构造方法都可以执行任意代码来更新日志配置，如设置 logger 级别、添加处理程序、添加过滤器，等等。 </ul> <p>注意，在 LogManager 配置期间加载的所有类，其搜索顺序是先从系统类路径中搜索，然后才从用户类中搜索。这包括 LogManager 类、任何 config 类和任何 handler 类。 <p>Logger 是按其圆点分隔的名称被组织到命名层次结构中的。因此，"a.b.c" 是 "a.b" 的子级，但 "a.b1" 和 a.b2" 属于同一级。 <p>假定所有以 ".level" 结尾的名称的属性为 Logger 定义日志级别。因此，"foo.level" 就为名称为 "foo" 的 logger 定义了日志级别，进而为指定层次结构中它的所有子级也逐个定义了日志级别。日志级别是按其在属性文件中的定义顺序应用的。因此，树中子节点的级别设置应该迟于其父级设置。属性名 ".level" 可用于设置树的根级。 <p> LogManager 对象上的所有方法都是多线程安全的。<P><P><DL><DT><B>从以下版本开始：</B></DT> <DD>1.4</DD></DL><HR><P><!-- =========== FIELD SUMMARY =========== --><A NAME="field_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>static <A HREF="../../lang/String.html" title="java.lang 中的类">String</A></CODE></FONT></TD><TD><CODE><B><A HREF="LogManager.html#LOGGING_MXBEAN_NAME">LOGGING_MXBEAN_NAME</A></B></CODE><BR> <A HREF="LoggingMXBean.html" title="java.util.logging 中的接口"><CODE>LoggingMXBean</CODE></A> 的 <CODE>ObjectName</CODE> 的字符串表示形式。</TD></TR></TABLE> <!-- ======== 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 ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>protected </CODE></FONT></TD><TD><CODE><B><A HREF="LogManager.html#LogManager()">LogManager</A></B>()</CODE><BR> 受保护的构造方法。</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> boolean</CODE></FONT></TD><TD><CODE><B><A HREF="LogManager.html#addLogger(java.util.logging.Logger)">addLogger</A></B>(<A HREF="Logger.html" title="java.util.logging 中的类">Logger</A> logger)</CODE><BR> 添加指定的 logger。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?