「日誌和追蹤分析器」為下列記載公用程式提供獨立式和外掛式支援:
這項支援需要:
下列外掛程式提供這項支援:
記載公用程式 |
外掛程式 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 Common Base Event 1.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 內容對映至一或多個 Common Base Event 內容,以維護非 Common Base Event 專用的處理常式和格式製作程式的反映性。
在 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 格式製作程式會根據 Common Base Event 1.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 日誌訊息轉換成 Common Base Event 物件, 並呼叫 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 處理常式來將建立一個日誌記載代理程式,命名為 Logging Agent Handler。 訊息會以 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 實例的特定 Proxy Factory。 這個 org.eclipse.hyades.logging.commons.LoggerFactory Proxy Factory 主要用於多重類別載入器環境,每一個類別載入器需要一或多個不同類型的日誌程式和 Factory, 全部都使用相同的 Apache Commons 二進位檔。
org.eclipse.hyades.logging.commons.Logger 會根據 Common Base Event 1.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 日誌訊息轉換成 Common Base Event 物件,並呼叫 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 實例的特定 Proxy Factory。 這個 org.eclipse.hyades.logging.commons.FileLoggerFactory Proxy Factory 主要用於多重類別載入器環境,每一個類別載入器需要一或多個不同類型的日誌程式和 Factory, 全部都使用相同的 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 格式製作程式會根據 Common Base Event 1.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 日誌訊息轉換成 Common Base Event 物件,並呼叫 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 附加程式來建立一個日誌記載代理程式,命名為 Logging Agent Appender。 訊息會以 org.eclipse.hyades.logging.log4j.XmlLayout 來格式化為 XML,並寫入此日誌記載代理程式。
解說範例
提供的範例會說明「Apache Jakarta Log4J 記載功能」的獨立式和外掛程式支援之新使用者和現有使用者所需要的配置和設備,以顯示如何運用「Apache Jakarta Log4J 記載功能」的支援。 如需詳細資訊,請參閱檔案 > 新建 > 範例... > Apache Log4J 記載範例。
解說範例
提供的範例會利用 Common Base Event XML 檔範本 Event Factory 來建立和配置 Common Base Events,以顯示如何運用 EMF Common Base Event 的支援。 如需詳細資訊,請參閱檔案 > 新建 > 範例... > EMF Common Base Event 1.0.1 版範例。
相關概念
Common Base Event 模型
(C) Copyright IBM Corporation 2000, 2006. All Rights Reserved.