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 ：

19.3.2. 配置日志输出

概述

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

表 19.1. java.util.logging Handler 类
处理程序类	输出到
`ConsoleHandler`	输出到控制台的日志消息
`FileHandler`	输出日志消息到文件

重要

处理程序类必须在系统类路径上，以便在 Java 虚拟机启动时由 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 格式ter 类。默认设置为 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 格式ter 类。默认设置为 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