java.util.logging -- Java 日志记录编程接口

java.util.logging.Logger 类提供各种方法来记录数据。

在 WebSphere® Application Server中,使用基本日志和跟踪方式时, Java™ 日志记录 API (java.util.logging) 会自动为在 WsLevel上记录的事件创建公共基本事件。DETAIL 级别或更高版本 (包括 WsLevel)。DETAIL , Level.CONFIG, Level.INFO, WsLevel。AUDIT , Level.WARNING, Level.SEVERE和 WsLevel。)。 这些公共基本事件是使用与记录消息的记录器相关联的事件工厂创建的。 如果未指定任何事件工厂,那么 WebSphere Application Server 将使用自动填充特定于 WebSphere Application Server的信息的缺省事件工厂。

WebSphere Application Server 使用 java.util.logging.Logger 类的特殊实现,该类自动为以下方法创建公共基本事件:
  • config
  • info
  • 警告
  • 严重
  • log:在与 WsLevel.DETAIL 级别或更严重级别配合使用时除 log(LogRecord) 以外的所有变体
  • logp:在与 WsLevel.DETAIL 级别或更严重级别配合使用时
  • logrb:在与 WsLevel.DETAIL 级别或更严重级别配合使用时
WebSphere Application Server 记录器实现仅用于指定的记录器,例如,通过调用 (例如 Logger.getLogger(com.xyz.SomeLoggerName)) 实例化的记录器。 使用对 Logger.getAnonymousLogger 和 Logger.getLogger或 Logger.global 方法的调用实例化的记录器不会使用 WebSphere Application Server 实现,并且不会自动创建公共基本事件来记录对它们发出的请求。 直接使用 Logger.log(LogRecord) 方法记录的日志记录不会由 WebSphere Application Server 记录器自动转换为公共基本事件。
下图说明了应用程序代码如何记录公共基本事件:
应用程序代码如何记录 CBE
指定记录器和消息级事件的 Java 日志记录 API 处理如下所示:
  1. 应用程序代码使用特定于事件的数据来调用指定的记录器(WsLevel.DETAIL 或以上级别)。
  2. 该记录器在与其相关联的事件工厂上使用 createCommonBaseEvent 方法来创建公共基本事件。
  3. 该记录器使用与其相关联的事件工厂来创建公共基本事件。
  4. 该记录器将公共基本事件合并到 CommonBaseEventLogRecord 记录中,并且添加特定于事件的数据。
  5. 该记录器调用公共基本事件 complete 方法。
  6. 公共基本事件调用 ContentHandler completeEvent 方法。
  7. 内容处理程序将 XML 模板数据添加至公共基本事件(例如,包括组件名称)。 并非所有内容处理程序都支持模板。
  8. 内容处理程序将运行时数据添加至公共基本事件(例如,包括当前线程名称)。
  9. 记录器将 CommonBaseEventLogRecord 记录传递至处理程序。
  10. 处理程序将数据格式化并写至输出设备。