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.FATAL)记录的事件自动创建公共基本事件。这些公共基本事件是使用与记录消息的记录器相关联的事件工厂创建的。如果未指定事件工厂,那么 WebSphere Application Server 将使用缺省事件工厂,它将自动填入特定于 WebSphere Application Server 的信息。

WebSphere Application Server 将使用 java.util.logging.Logger 类的特殊实现,该类为下列方法自动创建公共基本事件:
  • config
  • 信息
  • 警告
  • severe
  • 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 实现,也不会自动创建公共基本事件来记录对它们的请求。WebSphere Application Server 记录器不会将直接使用 Logger.log(LogRecord) 方法记录的日志记录自动转换为公共基本事件。

下图说明应用程序代码如何记录公共基本事件:

应用程序代码如何记录 CBE

指定的记录器和消息级别事件的 Java 记录 API 处理按如下所示继续进行:
  1. 应用程序代码使用特定于事件的数据来调用指定的记录器(WsLevel.DETAIL 或更高级别)。
  2. 该记录器在与其相关联的事件工厂上使用 createCommonBaseEvent 方法来创建公共基本事件。
  3. 该记录器使用与其相关联的事件工厂来创建公共基本事件。
  4. 该记录器将公共基本事件合并到 CommonBaseEventLogRecord 记录中,并且添加特定于事件的数据。
  5. 该记录器调用公共基本事件 complete 方法。
  6. 公共基本事件调用 ContentHandler completeEvent 方法。
  7. 内容处理程序将 XML 模板数据添加至公共基本事件(例如,包括组件名称)。并非所有内容处理程序都支持模板。
  8. 内容处理程序将运行时数据添加至公共基本事件(例如,包括当前线程名称)。
  9. 记录器将 CommonBaseEventLogRecord 记录传递至处理程序。
  10. 处理程序将数据格式化并写至输出设备。

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rtrb_cbejavaapi
文件名:rtrb_cbejavaapi.html