“日志和跟踪分析器”提供了对下列日志记录实用程序的独立支持和插件支持:
此支持包括:
此支持是由下列插件提供的:
日志记录实用程序 |
插件 JAR |
---|---|
Java 日志记录(JSR-047) |
org.eclipse.hyades.logging.core\hl14.jar |
Apache Jakarta Commons 日志记录 |
org.eclipse.hyades.logging.core\hlcommons.jar |
Apache Jakarta Log4J 日志记录 |
org.eclipse.hyades.logging.core\hllog4j.jar |
EMF 公共基本事件 V1.0.1 |
org.eclipse.hyades.logging.core\hlcbe101.jar |
下列各节描述了每一类日志记录实用程序支持的详细信息并提供了样本指示信息以演示如何使用记录实用程序。
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 并将其写至此日志记录代理程序。
演示样本
提供了一个样本,该样本通过举例说明 JSR-047 Java 日志记录的独立支持和插件支持的新用户及现有用户所需的配置和检测,来说明如何利用 JSR-047 Java 日志记录的支持。要了解更多信息,请打开文件 > 新建 > 示例... > JSR-047 日志记录样本。
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.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent() 方法将 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 日志记录的独立支持和插件支持的新用户及现有用户所需的配置和检测,来说明如何利用 Apache Jakarta Commons 日志记录的支持。要了解更多信息,请参阅文件 > 新建 > 示例... > Apache Commons 日志记录样本。
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.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent() 方法将 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 日志记录的独立支持和插件支持的新用户及现有用户所需的配置和检测,来说明如何利用 Apache Jakarta Log4J 日志记录的支持。要了解更多信息,请参阅文件 > 新建 > 示例... > Apache Log4J 日志记录样本。
演示样本
提供了一个样本来说明如何使用公共基本事件 XML 文件模板事件工厂来创建和配置公共基本事件,从而利用 EMF 公共基本事件支持。要了解更多信息,请参阅文件 > 新建 > 示例... > EMF 公共基本事件 V1.0.1 样本。
相关概念
公共基本事件模型
(C) Copyright IBM Corporation 2000, 2006. All Rights Reserved.