19.3. 默认日志记录配置文件

19.3.1. 日志配置概述

默认日志记录配置文件 logging.properties 位于 InstallDir/etc 目录中。它将 Apache CXF loggers 配置为向控制台打印 WARNING 级别的消息。如果此级别的日志记录适用于您的应用程序，在使用前不必对该文件进行任何更改。但是，您可以在日志消息中更改详细级别。例如，您可以把日志消息发送到控制台，或更改为文件或两者。另外，您可以在独立软件包的级别上指定日志记录。

注意

本节讨论在默认的 logging.properties 文件中显示的配置属性。然而，还有许多其他 java.util.logging 配置属性可以设置。有关 java.util.logging API 的更多信息，请参见 java.util.logging javadoc，网址为： http://download.oracle.com/javase/1.5/docs/api/java/util/logging/package-summary.html。

19.3.2. 配置日志输出

概述

Java 日志记录实用程序 java.util.logging 使用处理程序类输出日志消息。表 19.1 “Java.util.logging Handler Classes” 显示在默认的 logging.properties 文件中配置的处理程序。

表 19.1. Java.util.logging Handler Classes
处理器类	输出到
`ConsoleHandler`	将日志信息输出到控制台
`FileHandler`	输出日志消息到文件中

重要

处理程序类必须在系统类路径上，才能在启动时由 Java 虚拟机安装。设置 Apache CXF 环境时会完成此操作。

配置控制台处理程序

例 19.2 “配置控制台处理程序” 显示配置控制台日志记录器的代码。

例 19.2. 配置控制台处理程序

handlers= java.util.logging.ConsoleHandler

控制台处理程序也支持例 19.3 “控制台处理程序属性” 中显示的配置属性。

例 19.3. 控制台处理程序属性

java.util.logging.ConsoleHandler.level = WARNING
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter

例 19.3 “控制台处理程序属性” 中显示的配置属性可以解释如下：

控制台处理程序支持单独的日志级别配置属性。这可让您将打印的日志信息限制为控制台，而全局日志记录设置可能会不同（请参阅第 19.3.3 节 “配置日志记录级别”）。默认设置为 WARNING。

指定 console handler 类用于格式化日志消息的 java.util.logging formatter 类。默认设置为 java.util.logging.SimpleFormatter。

配置文件处理程序

例 19.4 “配置文件处理程序” 显示配置文件处理程序的代码。

例 19.4. 配置文件处理程序

handlers= java.util.logging.FileHandler

文件处理程序也支持例 19.5 “文件处理程序配置属性” 中显示的配置属性。

例 19.5. 文件处理程序配置属性

java.util.logging.FileHandler.pattern = %h/java%u.log
java.util.logging.FileHandler.limit = 50000
java.util.logging.FileHandler.count = 1
java.util.logging.FileHandler.formatter = java.util.logging.XMLFormatter

例 19.5 “文件处理程序配置属性” 中显示的配置属性可以解释如下：

指定输出文件的位置和模式。默认设置为您的主目录。

以字节为单位，日志记录器写入任何一个文件的最大数量。默认设置为 50000。如果将其设置为零，则日志记录器写入任何一个文件的数量没有限制。

指定循环要循环多少个输出文件。默认设置为 1。

指定文件处理器类格式化日志消息的 java.util.logging formatter 类。默认设置为 java.util.logging.XMLFormatter。

配置控制台处理程序和文件处理程序

您可以通过指定控制台处理程序和文件处理程序（以逗号分隔）来设置日志记录工具，以将日志消息输出到控制台和文件处理程序，如配置两个控制台日志和文件所示。

配置两个控制台日志和文件

Logging

handlers= java.util.logging.FileHandler, java.util.logging.ConsoleHandler

19.3.3. 配置日志记录级别

日志级别

java.util.logging 框架支持以下日志级别，从最小到详细值：

严重
WARNING
INFO
CONFIG
FINE
FINER
FINEST

配置全局日志记录级别

要配置在所有日志记录器中记录的事件类型，请配置全局日志记录级别，如例 19.6 “配置全局日志记录级别” 所示。

例 19.6. 配置全局日志记录级别

.level= WARNING

在独立软件包中配置日志记录

level

java.util.logging 框架支持在单个软件包的级别上配置日志记录。例如：例 19.7 “在软件包级别配置日志记录” 中显示的代码行在 com.xyz.foo 软件包中的类中配置 SEVERE 级别的日志。

例 19.7. 在软件包级别配置日志记录

com.xyz.foo.level = SEVERE