De Log and Trace Analyzer levert stand-alone- en pluginondersteuning voor de volgende logboekprogramma's:
Deze ondersteuning omvat:
Deze ondersteuning wordt geleverd door de volgende plugins:
Logboekprogramma |
JAR-bestanden van plugins |
---|---|
Java Logging (JSR-047) |
org.eclipse.hyades.logging.core\hl14.jar |
Apache Jakarta Commons Logging |
org.eclipse.hyades.logging.core\hlcommons.jar |
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 |
In de volgende secties worden de details van elk type ondersteuning voor logboekprogramma's beschreven en vindt u aanwijzers naar voorbeelden van het gebruik.
Een extensie van de klasse java.util.logging.LogRecord onder het pakket org.eclipse.hyades.logging.java14 maakt het mogelijk voor u een aangepast logboekrecord te maken voor het vastleggen in logboeken van een org.eclipse.hyades.logging.events.cbe.CommonBaseEvent in een java.util.logging.LogRecord. Dit org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord breidt java.util.logging.LogRecord uit en bevat een verwijzing naar een org.eclipse.hyades.logging.events.cbe.CommonBaseEvent. Alle java.util.logging.LogRecord-eigenschappen zijn toegewezen aan een of meer Common Base Event-eigenschappen om de reflexiviteit te onderhouden voor de afhandelingsroutines en Indelers die niet gevoelig zijn voor Common Base Events.
Een implementatie van de java.util.logging.Filter-interface onder het org.eclipse.hyades.logging.java14-pakket staat alleen org.eclipse.hyades.logging.java14.CommonBaseEventLogRecords toe voor het vastleggen in logboek.
Een extensie van de abstracte klasse java.util.logging.Formatter onder het pakket org.eclipse.hyades.logging.java14 maakt het mogelijk afhandelingsroutines te configureren om de logboekberichten org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord en java.util.logging.LogRecord in XML in te delen. Dit indelingsprogramma org.eclipse.hyades.logging.java14.XmlFormatter converteert het logboekbericht van org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord of java.util.logging.LogRecord naar XML op basis van het schema van Common Base Event v1.0.1. Tijdens dit indelen, wordt in het logboekbericht gecontroleerd of de org.eclipse.hyades.logging.core.IExternalizableToXml-interface wordt geïmplementeerd (bijvoorbeeld org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord). Als dit zo is, wordt de externalizeCanonicalXmlString()-API aangeroepen in plaats van de XML-serialisering. Als dit niet zo is, wordt het logboekbericht java.util.logging.LogRecord geconverteerd naar een Common Base Event-object met behulp van dezelfde toewijzing als in org.eclipse.hyades.logging.events.cbe.CommonBaseEvent en geserialiseerd naar XML door middel van het aanroepen van de externalizeCanonicalXmlString()-API.
Een extensie van de java.util.logging.Handler-abstractklasse onder het org.eclipse.hyades.logging.java-pakket maakt het mogelijk voor logboekprogramma's om geconfigureerd te worden voor het vastleggen in logboek van
org.eclipse.hyades.logging.events.cbe.CommonBaseEvent en
java.util.logging.LogRecord-logboekberichten in een logboekagent.
Deze afhandelingsroutine org.eclipse.hyades.logging.java.LoggingAgentHandler controleert of het org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord of het java.util.logging.LogRecord-logboekbericht dat is vastgelegd in een logboekprogramma, kan worden vastgelegd op basis van de filter van het logboekprogramma of de afhandelingsroutine en het logboekniveau. Als het logboekbericht moet worden vastgelegd in logboek, wordt een logboekagent omgezet met dezelfde naam als het logboekprogramma dat het bericht vastlegt. Anders kunt u de afhandelingsroutine org.eclipse.hyades.logging.java.SingleLoggingAgentHandler gebruiken, die een logboekagent maakt met de naam Logging Agent Handler. Het bericht wordt in XML ingedeeld met behulp van een org.eclipse.hyades.logging.java.XmlFormatter en wordt geschreven naar de logboekagent.
Voorbeeld
Een voorbeeld om te laten zien hoe u de ondersteuning voor JSR-047 Java Logging verbetert door middel van een beschrijving van de configuratie en werking die vereist zijn voor nieuwe en bestaande gebruikers van stand-alone- en pluginondersteuning voor JSR-047 Java Logging. Kies Bestand > Nieuw > Voorbeeld... > JSR-047 Logging Sample voor meer informatie.
Een implementatie van de org.apache.commons.logging.Log-interface onder het org.eclipse.hyades.logging.commons-pakket maakt het mogelijk voor u een logboekprogramma te maken voor het vastleggen van org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object en java.lang.Throwable-logboekberichten. Deze org.eclipse.hyades.logging.commons.Logger controleert of het logboekbericht org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object of java.lang.Throwable, dat is vastgelegd in een logboekprogramma, kan worden vastgelegd op basis van het logboekniveau van dit programma. Als het logboekbericht moet worden vastgelegd, wordt het logboekbericht van org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object of java.lang.Throwable ingedeeld en vastgelegd. Een implementatie is verstrekt van de abstracte klasse org.apache.commons.logging.LogFactory en deze geeft een proxyfactory weer die specifiek is voor instances van org.eclipse.hyades.logging.commons.Logger. Deze org.eclipse.hyades.logging.commons.LoggerFactory-proxyfactory is bedoeld voor gebruik in omgevingen met meerdere klassenladers waarin een of meer verschillende typen logboekprogramma's en hun factory's vereist zijn voor elke afzonderlijke klassenlader en deze gebruiken alle dezelfde binaire Apache Commons-bestanden.
Het programma org.eclipse.hyades.logging.commons.Logger deelt de logboekberichten van het type org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object en java.lang.Throwable in een XML-indeling in op basis van het schema van het type Common Base Event v1.0.1. Tijdens dit indelen, wordt in het logboekbericht gecontroleerd of de org.eclipse.hyades.logging.core.IExternalizableToXml-interface wordt geïmplementeerd (bijvoorbeeld org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Als dit zo is, wordt de externalizeCanonicalXmlString()-API aangeroepen in plaats van de XML-serialisering. Als dit niet zo is, wordt het logboekbericht java.lang.Object of java.lang.Throwable geconverteerd tot een Common Base Event-object met behulp van de org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent()-methoden en geserialiseerd naar XML door de externalizeCanonicalXmlString()-API aan te roepen.
Het programma org.eclipse.hyades.logging.commons.Logger legt de logboekberichten van het type org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object en java.lang.Throwable vast in een logboekagent. Als het logboekbericht moet worden vastgelegd in logboek, wordt een logboekagent omgezet met dezelfde naam als het logboekprogramma dat het bericht vastlegt. Het bericht wordt ingedeeld in XML en naar de logboekagent geschreven.
Een implementatie van de org.apache.commons.logging.Log-interface onder het org.eclipse.hyades.logging.commons-pakket maakt het mogelijk een logboekprogramma te maken om de logboekberichten van het type org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object en java.lang.Throwable vast te leggen in een lokaal bestand. Dit org.eclipse.hyades.logging.commons.FileLogger-programma controleert of het logboekbericht van het type org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object of java.lang.Throwable dat in een logboekprogramma is vastgelegd, kan worden vastgelegd op basis van het logboekniveau van dit logboekprogramma. Als het logboekbericht moet worden vastgelegd, wordt het logboekbericht van het type org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object of java.lang.Throwable ingedeeld in XML-indeling en vastgelegd in een lokaal bestand. Een implementatie is verstrekt van de abstracte klasse org.apache.commons.logging.LogFactory en deze geeft een proxyfactory weer die specifiek is voor instances van org.eclipse.hyades.logging.commons.FileLogger. Deze org.eclipse.hyades.logging.commons.FileLoggerFactory-proxyfactory is bedoeld voor gebruik in omgevingen met meerdere klassenladers waarin een of meer verschillende typen logboekprogramma's en hun factory's vereist zijn voor elke afzonderlijke klassenlader en deze gebruiken alle dezelfde binaire Apache Commons-bestanden.
Voorbeeld
Een voorbeeld om te laten zien hoe u de ondersteuning voor Apache Jakarta Commons Logging verbetert door middel van een beschrijving van de configuratie en werking die vereist zijn voor nieuwe en bestaande gebruikers van stand-alone- en pluginondersteuning voor Apache Jakarta Commons Logging. Zie Bestand > Nieuw > Voorbeeld... > Apache Commons Logging Sample voor meer informatie.
De berichteigenschap van het logboekbericht org.apache.log4j.spi.LoggingEvent maakt het mogelijk een org.eclipse.hyades.logging.events.cbe.CommonBaseEvent vast te leggen.
Een extensie van de org.apache.log4j.spi.Filter-abstractklasse onder het org.eclipse.hyades.logging.log4j-pakket staat alleen het vastleggen in logboek toe van org.eclipse.hyades.logging.events.cbe.CommonBaseEvents.
Een extensie van de abstracte klasse org.apache.log4j.Layout onder het pakket org.eclipse.hyades.logging.log4j maakt het mogelijk de appenders te configureren zodat deze de logboekberichten van het type org.eclipse.hyades.logging.events.cbe.CommonBaseEvent en org.apache.log4j.spi.LoggingEvent in XML indelen. Dit org.eclipse.hyades.logging.log4j.XmlLayout-indelingsprogramma converteert het logboekbericht van het type org.eclipse.hyades.logging.events.cbe.CommonBaseEvent of org.apache.log4j.spi.LoggingEvent naar XML op basis van het Common Base Event v1.0.1-schema. Tijdens dit indelen wordt in het logboekbericht gecontroleerd of de berichteigenschap van org.apache.log4j.spi.LoggingEvent de interface org.eclipse.hyades.logging.core.IExternalizableToXml implementeert (bijvoorbeeld org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Als dit zo is, wordt de externalizeCanonicalXmlString()-API aangeroepen in plaats van de XML-serialisering. Als dit niet het geval is, wordt het logboekbericht org.apache.log4j.spi.LoggingEvent geconverteerd naar een Common Base Event-object met behulp van de org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent()-methoden en geserialiseerd naar XML door de externalizeCanonicalXmlString()-API aan te roepen.
Een extensie van de org.apache.log4j.AppenderSkeleton-abstractklasse onder het org.eclipse.hyades.logging.log4j-pakket, maakt het mogelijk voor logboekprogramma's om geconfigureerd te worden voor het vastleggen van de logboekberichten van het type
org.eclipse.hyades.logging.events.cbe.CommonBaseEvent en
org.apache.log4j.spi.LoggingEvent naar een logboekagent.
Deze org.eclipse.hyades.logging.log4j.LoggingAgentAppender-appender controleert of de logboekberichten van het type org.eclipse.hyades.logging.events.cbe.CommonBaseEvent en org.apache.log4j.spi.LoggingEvent die zijn vastgelegd in een logboekprogramma, kunnen worden vastgelegd op basis van de logger- en appenderfilter en het logboekniveau. Als het logboekbericht moet worden vastgelegd in logboek, wordt een logboekagent omgezet met dezelfde naam als het logboekprogramma dat het bericht vastlegt. Als dit niet het geval is, kunt u de org.eclipse.hyades.logging.log4j.SingleLoggingAgentAppender-appender gebruiken, waarmee één logboekagent wordt gemaakt met de naam Logging Agent Appender. Het bericht wordt in XML ingedeeld met behulp van een org.eclipse.hyades.logging.log4j.XmlLayout en wordt geschreven naar de logboekagent.
Voorbeeld
Een voorbeeld wordt geleverd om te laten zien hoe u de ondersteuning voor Apache Jakarta Log4J Logging verbetert door middel van een beschrijving van de configuratie en werking die vereist zijn voor nieuwe en bestaande gebruikers van stand-alone- en pluginondersteuning voor Apache Jakarta Log4J Logging. Zie Bestand > Nieuw > Voorbeeld... > Apache Log4J Logging Sample voor meer informatie.
Voorbeeld
Een voorbeeld wordt geleverd om te te laten zien hoe u de ondersteuning voor EMF Common Base Events verbetert door Common Base Events te maken en te configureren met behulp van de Common Base Event XML-bestandssjabloon Event Factory. Zie Bestand > Nieuw > Voorbeeld... > EMF Common Base Event v1.0.1 Sample voor meer informatie.
Verwante concepten
Common Base Event-model
(C) Copyright IBM Corporation 2000, 2006. Alle rechten voorbehouden.