“日志和跟踪分析器”提供了对下列记录实用程序的独立支持和插件支持:
此支持包括:
此支持是由下列插件提供的:
记录实用程序 |
插件 |
---|---|
Java Logging(JSR-047) |
org.eclipse.hyades.logging.java14 |
Apache Jakarta Commons Logging |
org.eclipse.hyades.logging.commons |
Apache Jakarta Log4J Logging |
org.eclipse.hyades.logging.log4j |
下列各节描述了每一类记录实用程序支持的详细信息并提供了指向一些样本的指针,那些样本演示了如何使用记录实用程序。
org.eclipse.hyades.logging.java14 包中 java.util.logging.LogRecord 类的扩展使您能够创建定制日志记录,以在 java.util.logging.LogRecord 中记录 org.eclipse.hyades.logging.events.cbe.CommonBaseEvent。这个 org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord 扩展 java.util.logging.LogRecord 并包含对 org.eclipse.hyades.logging.events.cbe.CommonBaseEvent 的引用。所有 java.util.logging.LogRecord 属性都映射到一个或多个公共基本事件属性,以保持非公共基本事件处理程序和格式化程序的自反性。
org.eclipse.hyades.logging.java14 包中 java.util.logging.Filter 接口的实现只能成功地记录 org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord。
org.eclipse.hyades.logging.java14 包中 java.util.logging.Formatter 抽象类的扩展允许您配置处理程序以将 org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord 和 java.util.logging.LogRecord 日志消息格式化为 XML。这个 org.eclipse.hyades.logging.java14.XmlFormatter 格式化程序根据公共基本事件 v1.0.1 模式将 org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord 或 java.util.logging.LogRecord 日志消息转换为 XML。进行格式化时,将检查日志消息以了解它是否实现了 org.eclipse.hyades.logging.core.IExternalizableToXml 接口(例如 org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord)。如果实现了该接口,就调用 externalizeCanonicalXmlString() API,而不进行 XML 序列化。否则,使用 org.eclipse.hyades.logging.events.cbe.CommonBaseEvent 中的映射将 java.util.logging.LogRecord 日志消息转换为公共基本事件对象并通过调用 externalizeCanonicalXmlString() API 将那些对象序列化为 XML。
org.eclipse.hyades.logging.java 包中
java.util.logging.Handler 抽象类的扩展允许配置记录器以将
org.eclipse.hyades.logging.events.cbe.CommonBaseEvent 和
java.util.logging.LogRecord 日志消息记录到记录代理程序。
这个 org.eclipse.hyades.logging.java.LoggingAgentHandler 处理程序将检查:能否根据记录器和处理程序的过滤器和记录级别,来记录已经记录到记录器的 org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord 或 java.util.logging.LogRecord 日志消息。如果将要记录日志消息,则使用与记录消息的记录器同名的记录代理程序。否则,可以使用 org.eclipse.hyades.logging.java.SingleLoggingAgentHandler 处理程序,该处理程序将创建一个名为“记录代理程序处理程序”的记录代理程序。使用 org.eclipse.hyades.logging.java.XmlFormatter 将消息格式化为 XML 并将其写至记录代理程序。
演示样本
提供了一个样本,该样本通过演示 Java Logging(JSR-047)的独立支持和插件支持的配置和检测,来告诉新用户及现有用户如何利用 Java Logging(JSR-047)支持。要了解更多信息,请打开文件 > 新建 > 示例... > Hyades 记录 > Hyades JSR-047 Logging 样本。
org.eclipse.hyades.logging.commons 包中 org.apache.commons.logging.Log 接口的实现使您能够创建记录器以便记录 org.eclipse.hyades.logging.events.cbe.CommonBaseEvent、java.lang.Object 和 java.lang.Throwable 日志消息。这个 org.eclipse.hyades.logging.commons.Logger 将检查:能否根据记录器的记录级别,来记录已记录至记录器的 org.eclipse.hyades.logging.events.cbe.CommonBaseEvent、java.lang.Object 或 java.lang.Throwable 日志消息。如果将要记录日志消息,则格式化并记录 org.eclipse.hyades.logging.events.cbe.CommonBaseEvent、java.lang.Object 或 java.lang.Throwable 日志消息。提供了 org.apache.commons.logging.LogFactory 抽象类的实现,它代表 org.eclipse.hyades.logging.commons.Logger 实例的专用代理工厂。这个 org.eclipse.hyades.logging.commons.LoggerFactory 代理工厂旨在用于多类装入器环境,在该环境中,每个独立的类装入器都需要一种或多种不同类型的记录器及其工厂,它们全都利用同一个 Apache Commons 二进制文件。
org.eclipse.hyades.logging.commons.Logger 根据公共基本事件 v1.0.1 模式将 org.eclipse.hyades.logging.events.cbe.CommonBaseEvent、java.lang.Object 和 java.lang.Throwable 日志消息格式化为 XML。进行格式化时,将检查日志消息以了解它是否实现了 org.eclipse.hyades.logging.core.IExternalizableToXml 接口(例如 org.eclipse.hyades.logging.events.cbe.CommonBaseEvent)。如果实现了该接口,就调用 externalizeCanonicalXmlString() API,而不进行 XML 序列化。否则,将使用 org.eclipse.hyades.internal.logging.core.XmlGenerator 将 java.lang.Object 或 java.lang.Throwable 日志消息转换为公共基本事件对象并通过调用 externalizeCanonicalXmlString() API 将其序列化为 XML。
org.eclipse.hyades.logging.commons.Logger 将 org.eclipse.hyades.logging.events.cbe.CommonBaseEvent、java.lang.Object 和 java.lang.Throwable 日志消息记录至记录代理程序。如果将要记录日志消息,则使用与记录消息的记录器同名的记录代理程序。消息将被格式化为 XML 并写至记录代理程序。
org.eclipse.hyades.logging.commons 包中 org.apache.commons.logging.Log 接口的实现使您能够创建记录器,以便将 org.eclipse.hyades.logging.events.cbe.CommonBaseEvent、java.lang.Object 和 java.lang.Throwable 日志消息记录到本地文件。这个 org.eclipse.hyades.logging.commons.FileLogger 将检查:能否根据记录器的记录级别,来记录已记录至记录器的 org.eclipse.hyades.logging.events.cbe.CommonBaseEvent、java.lang.Object 或 java.lang.Throwable 日志消息。如果将要记录日志消息,则将 org.eclipse.hyades.logging.events.cbe.CommonBaseEvent、java.lang.Object 或 java.lang.Throwable 日志消息格式化为 XML,并将其记录到本地文件。提供了 org.apache.commons.logging.LogFactory 抽象类的实现,它代表 org.eclipse.hyades.logging.commons.FileLogger 实例的专用代理工厂。这个 org.eclipse.hyades.logging.commons.FileLoggerFactory 代理工厂旨在用于多类装入器环境,在该环境中,每个独立的类装入器都需要一种或多种不同类型的记录器及其工厂,它们全都利用同一个 Apache Commons 二进制文件。
演示样本
提供了一个样本,该样本通过演示 Apache Jakarta Commons Logging 的独立支持和插件支持的配置和检测,来告诉新用户及现有用户如何利用 Apache Jakarta Commons Logging 支持。要了解更多信息,请参阅文件 > 新建 > 示例... > Hyades 记录 > Hyades Apache Commons Logging 样本。
org.apache.log4j.spi.LoggingEvent 日志消息的消息属性允许您记录 org.eclipse.hyades.logging.events.cbe.CommonBaseEvent。
org.eclipse.hyades.logging.log4j 包中 org.apache.log4j.spi.Filter 抽象类的扩展只能成功地记录 org.eclipse.hyades.logging.events.cbe.CommonBaseEvent。
org.eclipse.hyades.logging.log4j 包中 org.apache.log4j.Layout 抽象类的扩展允许您配置追加程序以将 org.eclipse.hyades.logging.events.cbe.CommonBaseEvent 和 org.apache.log4j.spi.LoggingEvent 日志消息格式化为 XML。这个 org.eclipse.hyades.logging.log4j.XmlLayout 格式化程序根据公共基本事件 v1.0.1 模式将 org.eclipse.hyades.logging.events.cbe.CommonBaseEvent 或 org.apache.log4j.spi.LoggingEvent 日志消息转换为 XML。进行格式化时,将检查日志消息以了解 org.apache.log4j.spi.LoggingEvent 的消息属性是否实现了 org.eclipse.hyades.logging.core.IExternalizableToXml 接口(例如 org.eclipse.hyades.logging.events.cbe.CommonBaseEvent)。如果实现了该接口,就调用 externalizeCanonicalXmlString() API,而不进行 XML 序列化。否则,将使用 org.eclipse.hyades.internal.logging.core.XmlGenerator 将 org.apache.log4j.spi.LoggingEvent 日志消息转换为公共基本事件对象并通过调用 externalizeCanonicalXmlString() API 将其序列化为 XML。
org.eclipse.hyades.logging.log4j 包中
org.apache.log4j.AppenderSkeleton 抽象类的扩展允许配置记录器以将
org.eclipse.hyades.logging.events.cbe.CommonBaseEvent 和
org.apache.log4j.spi.LoggingEvent 日志消息记录到记录代理程序。
这个 org.eclipse.hyades.logging.log4j.LoggingAgentAppender 追加程序将检查:能否根据记录器和追加程序的过滤器和记录级别,来记录已记录到记录器的 org.eclipse.hyades.logging.events.cbe.CommonBaseEvent 和 org.apache.log4j.spi.LoggingEvent 日志消息。如果将要记录日志消息,则使用与记录消息的记录器同名的记录代理程序。否则,您可以使用 org.eclipse.hyades.logging.log4j.SingleLoggingAgentAppender 追加程序,它将创建一个名为“记录代理程序追加程序”的记录代理程序。使用 org.eclipse.hyades.logging.log4j.XmlLayout 将消息格式化为 XML 并将其写至记录代理程序。
演示样本
提供了一个样本,该样本通过演示 Apache Jakarta Log4J Logging 的独立支持和插件支持的配置和检测,来告诉新用户及现有用户如何利用 Apache Jakarta Log4J Logging 支持。要了解更多信息,请参阅文件 > 新建 > 示例... > Hyades 记录 > Hyades Apache Log4J Logging 样本。
相关概念
公共基本事件模型
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.