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