Analyzátor protokolů a trasování nabízí samostatnou podporu i podporu ve formě modulu plug-in pro následující utility protokolování:
Tato podpora představuje:
Tato podpora je poskytována následujícími moduly plug-in:
Utilita protokolování |
Soubory JAR modulů plug-in |
---|---|
Protokolování Java Logging (JSR-047) |
org.eclipse.hyades.logging.core\hl14.jar |
Protokolování Apache Jakarta Commons Logging |
org.eclipse.hyades.logging.core\hlcommons.jar |
Protokolování Apache Jakarta Log4J Logging |
org.eclipse.hyades.logging.core\hllog4j.jar |
EMF Common Base Event V1.0.1 |
org.eclipse.hyades.logging.core\hlcbe101.jar |
Následující sekce popisují podrobnosti každého typu podpory utility protokolování a poskytují odkazy na ukázky, které demonstrují jejich použití.
Rozšíření třídy java.util.logging.LogRecord v rámci balíčku org.eclipse.hyades.logging.java14 umožňuje vytváření přizpůsobených záznamů protokolu pro protokolování org.eclipse.hyades.logging.events.cbe.CommonBaseEvent v java.util.logging.LogRecord. org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord rozšiřuje java.util.logging.LogRecord a obsahuje odkaz na org.eclipse.hyades.logging.events.cbe.CommonBaseEvent. Všechny vlastnosti java.util.logging.LogRecord jsou mapovány na jednu nebo více vlastností události, aby se zachovala reflexivita pro popisovače a formátovače událostí non-Common Base Event.
Pouze implementace rozhraníjava.util.logging.Filter v rámci balíčku org.eclipse.hyades.logging.java14 povolí úspěšné protokolování záznamů org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord.
Rozšíření abstraktní třídy java.util.logging.Formatter v balíčku org.eclipse.hyades.logging.java14 vám umožňuje konfigurovat popisovače, aby formátovaly zprávy protokolu org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord a java.util.logging.LogRecord do formátu XML. Tento formátovač org.eclipse.hyades.logging.java14.XmlFormatter převádí zprávu protokolu org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord nebo java.util.logging.LogRecord na XML na základě schématu Common Base Event v1.0.1. Během formátování se kontroluje zpráva protokolu, zda implementuje rozhraní org.eclipse.hyades.logging.core.IExternalizableToXml (např. org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord). Pokud ano, volá se rozhraní API externalizeCanonicalXmlString() namísto serializace XML. V opačném případě je zpráva protokolujava.util.logging.LogRecord převedena na objekt události Common Base Event pomocí stejného mapování jako v org.eclipse.hyades.logging.events.cbe.CommonBaseEvent a serializována do XML voláním rozhraní API externalizeCanonicalXmlString().
Rozšíření abstraktní třídy java.util.logging.Handler
v balíčku org.eclipse.hyades.logging.java umožňuje konfigurovat registrátory tak, aby
protokolovaly zprávy protokolu
org.eclipse.hyades.logging.events.cbe.CommonBaseEvent a
java.util.logging.LogRecord do agenta protokolování.
Tento popisovač, tj. org.eclipse.hyades.logging.java.LoggingAgentHandler, kontroluje, zda lze zprávu protokolu org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord nebo java.util.logging.LogRecord, zapsanou do registrátoru, protokolovat na základě filtru registrátoru a popisovače a na základě úrovně protokolování. Má-li být zpráva protokolu zaznamenána do protokolu, vyřeší se agent protokolování s názvem shodným s registrátorem, který zprávu protokoluje. Jinak můžete použít popisovač org.eclipse.hyades.logging.java.SingleLoggingAgentHandler nazvaný Popisovač agenta protokolování (Logging Agent Handler), který vytváří jednoho agenta protokolování. Zpráva je formátována v XML pomocí formátovačeorg.eclipse.hyades.logging.java.XmlFormatter a zapsána do agenta protokolování.
Ilustrativní ukázka
Ukázka má předvést, jak ovlivnit podporu protokolování JSR-047 Java Logging, a ilustruje konfiguraci a přípravu nástrojů potřebných pro nové a stávající uživatele podpory protokolování JSR-047 Java Logging samostatně i v podobě modulu plug-in. Další informace získáte, když otevřete Soubor > Nový > Příklad... > Ukázka protokolování JSR-047.
Implementace rozhraní org.apache.commons.logging.Log v rámci balíčku org.eclipse.hyades.logging.commons vám umožní vytvořit registrátor pro protokolování zpráv protokolu org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object a java.lang.Throwable. Tento registrátor, tj. org.eclipse.hyades.logging.commons.Logger, kontroluje, zda lze zprávu protokolu org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object nebo java.lang.Throwable, zapsanou do registrátoru, protokolovat na základě úrovně protokolování registrátoru. Má-li se zpráva protokolu zaprotokolovat, zpráva protokolu org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object nebo java.lang.Throwable je zformátována a zaprotokolována. Je k dispozici implementace abstraktní třídy org.apache.commons.logging.LogFactory, která představuje továrnu na zástupce proxy specifickou pro instance org.eclipse.hyades.logging.commons.Logger. Tato továrna na zástupce proxy org.eclipse.hyades.logging.commons.LoggerFactory je určena pro použití ve více prostředích zaváděče tříd, kde je požadován jeden nebo více různých typů registrátorů a jejich továren pro každý oddělený zaváděč tříd, přičemž všechny používají stejné binární soubory Apache Commons.
Registrátor org.eclipse.hyades.logging.commons.Logger formátuje zprávy protokoluorg.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object a java.lang.Throwable do XML na základě schématu události Common Base Event v1.0.1. Během formátování se kontroluje zpráva protokolu, zda implementuje rozhraní org.eclipse.hyades.logging.core.IExternalizableToXml (například org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Pokud ano, volá se rozhraní API externalizeCanonicalXmlString() namísto serializace XML. V opačném případě je zpráva protokolu java.lang.Object nebo java.lang.Throwable převedena na objekt události Common Base Event pomocí metod org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent() a serializována do XML voláním rozhraní API externalizeCanonicalXmlString().
Registrátor org.eclipse.hyades.logging.commons.Logger protokoluje zprávy protokolu org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object a java.lang.Throwable do agenta protokolování. Má-li být zpráva protokolu zaznamenána do protokolu, vyřeší se agent protokolování s názvem shodným s registrátorem, který zprávu protokoluje. Zpráva je formátována do XML a zapsána do agenta protokolování.
Implementace rozhraní org.apache.commons.logging.Log v rámci balíčku org.eclipse.hyades.logging.commons package vám umožní vytvořit registrátor pro protokolování zpráv protokolu org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object a java.lang.Throwable do lokálního souboru. Tento registrátor, tj. org.eclipse.hyades.logging.commons.FileLogger kontroluje, zda lze zprávu protokolu org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object nebo java.lang.Throwable, zapsanou do registrátoru, protokolovat na základě úrovně protokolování registrátoru. Má-li se zpráva protokolu zaprotokolovat, zpráva protokolu org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object nebo java.lang.Throwable je zformátována do XML a zaprotokolována do lokálního souboru. Je k dispozici implementace abstraktní třídy org.apache.commons.logging.LogFactory, která představuje továrnu na zástupce proxy specifickou pro instance org.eclipse.hyades.logging.commons.FileLogger. Tato továrna na zástupce proxy org.eclipse.hyades.logging.commons.FileLoggerFactory je určena pro použití ve více prostředích zaváděče tříd, kde je požadován jeden nebo více různých typů registrátorů a jejich továren pro každý oddělený zaváděč tříd, přičemž všechny používají stejné binární soubory Apache Commons.
Ilustrativní ukázka
Ukázka má předvést, jak ovlivnit podporu protokolování Apache Jakarta Commons Logging, a ilustruje konfiguraci a přípravu nástrojů potřebných pro nové a stávající uživatele podpory protokolování Apache Jakarta Commons Logging samostatně i v podobě modulu plug-in. Další informace viz Soubor > Nový > Příklad... > Ukázka protokolování Apache Commons.
Vlastnost zprávy protokolu org.apache.log4j.spi.LoggingEvent vám umožní protokolovat org.eclipse.hyades.logging.events.cbe.CommonBaseEvent.
Pouze rozšíření abstraktní třídy org.apache.log4j.spi.Filter v balíčku org.eclipse.hyades.logging.log4j povolí úspěšné protokolování událostí org.eclipse.hyades.logging.events.cbe.CommonBaseEvent.
Rozšíření abstraktní třídy org.apache.log4j.Layout v balíčku org.eclipse.hyades.logging.log4j vám umožňuje konfigurovat apendery, aby formátovaly zprávy protokolu org.eclipse.hyades.logging.events.cbe.CommonBaseEvent a org.apache.log4j.spi.LoggingEvent do XML. Tento formátovač org.eclipse.hyades.logging.log4j.XmlLayout převádí zprávu protokolu org.eclipse.hyades.logging.events.cbe.CommonBaseEvent nebo org.apache.log4j.spi.LoggingEvent na XML na základě schématu Common Base Event v1.0.1. Během formátování se kontroluje zpráva protokolu, zda vlastnost zprávy události org.apache.log4j.spi.LoggingEvent implementuje rozhraní org.eclipse.hyades.logging.core.IExternalizableToXml (například org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Pokud ano, volá se rozhraní API externalizeCanonicalXmlString() namísto serializace XML. V opačném případě je zpráva protokolu org.apache.log4j.spi.LoggingEvent převedena na objekt události Common Base Event pomocí metod org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent() a serializována do XML voláním rozhraní API externalizeCanonicalXmlString().
Rozšíření abstraktní třídy org.apache.log4j.AppenderSkeleton
v balíčku org.eclipse.hyades.logging.log4j umožňuje konfigurovat registrátory tak, aby
protokolovaly zprávy protokolu
org.eclipse.hyades.logging.events.cbe.CommonBaseEvent a
org.apache.log4j.spi.LoggingEvent do agenta protokolování.
Tento apender, tj. org.eclipse.hyades.logging.log4j.LoggingAgentAppender kontroluje, zda lze zprávu protokolu org.eclipse.hyades.logging.events.cbe.CommonBaseEvent a org.apache.log4j.spi.LoggingEvent, zapsanou do registrátoru, protokolovat na základě filtru registrátoru a apenderu a na základě úrovně protokolování. Má-li být zpráva protokolu zaznamenána do protokolu, vyřeší se agent protokolování s názvem shodným s registrátorem, který zprávu protokoluje. Jinak můžete použít apender org.eclipse.hyades.logging.log4j.SingleLoggingAgentAppender nazvaný Appender agenta protokolování (Logging Agent Appender), který vytváří jednoho agenta protokolování. Zpráva je formátována v XML pomocí org.eclipse.hyades.logging.log4j.XmlLayout a zapsána do agenta protokolování.
Ilustrativní ukázka
Ukázka má předvést, jak využít podporu protokolování Apache Jakarta Log4J Logging, a ilustruje konfiguraci a přípravu nástrojů potřebných pro nové a stávající uživatele podpory protokolování Apache Jakarta Log4J Logging samostatně i v podobě modulu plug-in. Další informace viz Soubor > Nový > Příklad... > Ukázka protokolování Apache Log4J.
Ilustrativní ukázka
Ukázka má předvést, jak využít podporu protokolování EMF Common Base Events vytvářením a konfigurací událostí Common Base Event pomocí souboru XML šablony události Common Base Event pro Továrnu událostí. Další informace viz Soubor > Nový > Příklad... > Ukázka modulu EMF Common Base Event v1.0.1.
Související pojmy
Model události Common Base Event
(C) Copyright IBM Corporation 2000, 2006. Všechna práva vyhrazena.