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

19.3.1. 日志配置概述

默认日志记录配置文件 logging.properties 位于 InstallDir/etc 目录中。它将 Apache CXF 日志记录器配置为将 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 类” 显示默认 logging.properties 文件中配置的处理程序。

表 19.1. java.util.logging Handler 类
处理程序类	输出信息
`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。

指定控制台处理器类用来格式化日志消息的 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