Log- og sporingsanalysefunktionen indeholder enkeltstående og plugin-understøttelse af følgende logfunktioner:
Denne understøttelse indebærer:
Understøttelsen leveres af følgende plugins:
Logfunktion |
Plugin-JAR'er |
---|---|
Java-logning (JSR-047) |
org.eclipse.hyades.logging.core\hl14.jar |
Apache Jakarta Commons-logning |
org.eclipse.hyades.logging.core\hlcommons.jar |
Apache Jakarta Log4J-logning |
org.eclipse.hyades.logging.core\hllog4j.jar |
EMF Common Base Event V1.0.1 |
org.eclipse.hyades.logging.core\hlcbe101.jar |
Følgende afsnit beskriver detaljerne i hver af de understøttede logfunktioner og indeholder henvisninger til eksempler, der demonstrerer, hvordan de bruges.
En udvidelse af klassen java.util.logging.LogRecord under pakken org.eclipse.hyades.logging.java14 gør det muligt at oprette en tilpasset logrecord til registrering af en org.eclipse.hyades.logging.events.cbe.CommonBaseEvent i en java.util.logging.LogRecord. Denne org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord udvider java.util.logging.LogRecord og indeholder en reference til en org.eclipse.hyades.logging.events.cbe.CommonBaseEvent. Alle java.util.logging.LogRecord-egenskaber er tilknyttet vha. mapping til en eller flere Common Base Event-egenskaber for at bevare refleksivitet for behandlere og formateringsprogrammer, der ikke overholder Common Base Event-formatet.
En implementering af grænsefladen java.util.logging.Filter under pakken org.eclipse.hyades.logging.java14 giver kun mulighed for at registrere org.eclipse.hyades.logging.java14.CommonBaseEventLogRecords.
En udvidelse af abstract-klassen java.util.logging.Formatter under pakken org.eclipse.hyades.logging.java14 gør det muligt at konfigurere behandlere til at formatere org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord- og java.util.logging.LogRecord-logmeddelelser til XML. Dette org.eclipse.hyades.logging.java14.XmlFormatter-formateringsprogram konverterer org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord- eller java.util.logging.LogRecord-logmeddelelsen til XML, baseret på Common Base Event v1.0.1-skemaet. Under formateringen kontrolleres logmeddelelsen for at se, om den implementerer grænsefladen org.eclipse.hyades.logging.core.IExternalizableToXml (f.eks. org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord). I så fald kaldes externalizeCanonicalXmlString()-API'et i stedet for XML-serialisering. Ellers konverteres java.util.logging.LogRecord-logmeddelelsen til et Common Base Event-objekt vha. samme tilknytning vha. mapping som org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, og den serialiseres til XML ved at kalde externalizeCanonicalXmlString()-API'et.
En udvidelse af abstract-klassen java.util.logging.Handler under pakken org.eclipse.hyades.logging.java gør det muligt at konfigurere loggere at registrere org.eclipse.hyades.logging.events.cbe.CommonBaseEvent- og java.util.logging.LogRecord-logmeddelelser til en logagent.
Denne org.eclipse.hyades.logging.java.LoggingAgentHandler-behandler kontrollerer, om den org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord- eller java.util.logging.LogRecord-logmeddelelse, der registreres i en logger, kan registreres, baseret på loggerens og behandlerens filter- og logniveau. Hvis logmeddelelsen skal registreres, opløses en logagent med samme navn som den logger, der registrerer meddelelsen. Eller kan du bruge behandleren org.eclipse.hyades.logging.java.SingleLoggingAgentHandler, som opretter én logagent med navnet Logging Agent Handler. Meddelelsen formateres i XML vha. en org.eclipse.hyades.logging.java.XmlFormatter og skrives til logagenten.
Illustrativt eksempel
Der medfølger et eksempel, som viser, hvordan du kan udnytte understøttelsen af JSR-047 Java-logning. Eksemplet illustrerer den konfiguration og instrumentering, der kræves for nye og eksisterende brugere af enkeltstående og plugin-understøttelse af JSR-047 Java-logning. Du kan få flere oplysninger ved at åbne Fil > Ny > Eksempel... > JSR-047-logeksempel.
Du kan bruge en implementering af grænsefladen org.apache.commons.logging.Log under pakken org.eclipse.hyades.logging.commons til at oprette en logger til registrering af org.eclipse.hyades.logging.events.cbe.CommonBaseEvent-, java.lang.Object- og java.lang.Throwable-logmeddelelser. Denne org.eclipse.hyades.logging.commons.Logger kontrollerer, om den org.eclipse.hyades.logging.events.cbe.CommonBaseEvent-, java.lang.Object- eller java.lang.Throwable-logmeddelelse, der registreres i en logger, kan registreres, baseret på loggerens logniveau. Hvis logmeddelelsen skal registreres, bliver org.eclipse.hyades.logging.events.cbe.CommonBaseEvents, java.lang.Object eller java.lang.Throwable-logmeddelelsen formateret og registreret. Der medfølger en implementering af abstract-klassen org.apache.commons.logging.LogFactory, som repræsenterer en proxy-fabrik, der er specifik for org.eclipse.hyades.logging.commons.Logger-forekomster. Denne org.eclipse.hyades.logging.commons.LoggerFactory-proxy-fabrik er beregnet til brug i miljøer med flere klasseindlæsere, hvor en eller flere forskellige typer af loggere og deres fabrikker kræves til de forskellige klasseindlæsere, der alle bruger samme binære Apache Commons-filer.
org.eclipse.hyades.logging.commons.Logger formaterer org.eclipse.hyades.logging.events.cbe.CommonBaseEvent-, java.lang.Object- og java.lang.Throwable-logmeddelelser til Common Base Event v1.0.1-skemaet. Under formateringen kontrolleres logmeddelelsen for at se, om den implementerer grænsefladen org.eclipse.hyades.logging.core.IExternalizableToXml (f.eks. org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). I så fald kaldes externalizeCanonicalXmlString()-API'et i stedet for XML-serialisering. Ellers konverteres java.lang.Object- eller java.lang.Throwable-logmeddelelsen til et Common Base Event-objekt vha. metoderne org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent(), og den serialiseres til XML ved at kalde externalizeCanonicalXmlString()-API'et.
org.eclipse.hyades.logging.commons.Logger registrerer org.eclipse.hyades.logging.events.cbe.CommonBaseEvent-, java.lang.Object- og java.lang.Throwable-logmeddelelser til en logagent. Hvis logmeddelelsen skal registreres, opløses en logagent med samme navn som den logger, der registrerer meddelelsen. Meddelelsen formateres til XML og skrives til logagenten.
Du kan bruge en implementering af grænsefladen org.apache.commons.logging.Log under pakken org.eclipse.hyades.logging.commons til at oprette en logger til registrering af org.eclipse.hyades.logging.events.cbe.CommonBaseEvent-, java.lang.Object- og java.lang.Throwable-logmeddelelser til en lokal fil. Denne org.eclipse.hyades.logging.commons.FileLogger kontrollerer, om den org.eclipse.hyades.logging.events.cbe.CommonBaseEvent-, java.lang.Object- eller java.lang.Throwable-logmeddelelse, der registreres i en logger, kan registreres, baseret på loggerens logniveau. Hvis logmeddelelsen skal registreres, bliver org.eclipse.hyades.logging.events.cbe.CommonBaseEvent-, java.lang.Object- eller java.lang.Throwable-logmeddelelsen formateret til XML og registreret. Der medfølger en implementering af abstract-klassen org.apache.commons.logging.LogFactory, som repræsenterer en proxy-fabrik, der er specifik for org.eclipse.hyades.logging.commons.FileLogger-forekomster. Denne org.eclipse.hyades.logging.commons.FileLoggerFactory-proxy-fabrik er beregnet til brug i miljøer med flere klasseindlæsere, hvor en eller flere forskellige typer af loggere og deres fabrikker kræves til de forskellige klasseindlæsere, der alle bruger samme binære Apache Commons-filer.
Illustrativt eksempel
Der medfølger et eksempel, som viser, hvordan du kan udnytte understøttelsen af Apache Jakarta Commons-logning. Eksemplet illustrerer den konfiguration og instrumentering, der kræves for nye og eksisterende brugere af enkeltstående og plugin-understøttelse af Apache Jakarta Commons-logning. Du kan få flere oplysninger ved at vælge Fil > Ny > Eksempel... > Apache Commons-logeksempel.
Meddelelsesegenskaben for org.apache.log4j.spi.LoggingEvent-logmeddelelsen gør det muligt at registrere en org.eclipse.hyades.logging.events.cbe.CommonBaseEvent.
En udvidelse af abstract-klassen org.apache.log4j.spi.Filter under pakken org.eclipse.hyades.logging.log4j giver kun mulighed for at registrere org.eclipse.hyades.logging.events.cbe.CommonBaseEvents.
En udvidelse af abstract-klassen org.apache.log4j.Layout under pakken org.eclipse.hyades.logging.log4j gør det muligt at konfigurere tilføjelsesfunktioner til at formatere org.eclipse.hyades.logging.events.cbe.CommonBaseEvent- og org.apache.log4j.spi.LoggingEvent-logmeddelelser til XML. Dette org.eclipse.hyades.logging.log4j.XmlLayout-formateringsprogram konverterer org.eclipse.hyades.logging.events.cbe.CommonBaseEvent- eller org.apache.log4j.spi.LoggingEvent-logmeddelelsen til XML, baseret på Common Base Event v1.0.1-skemaet. Under formateringen kontrolleres logmeddelelsen for at se, om meddelelsesegenskaben for org.apache.log4j.spi.LoggingEvent implementerer grænsefladen org.eclipse.hyades.logging.core.IExternalizableToXml (f.eks. org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). I så fald kaldes externalizeCanonicalXmlString()-API'et i stedet for XML-serialisering. Ellers konverteres org.apache.log4j.spi.LoggingEvent-logmeddelelsen til et Common Base Event-objekt vha. org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent()-metoderne, og den serialiseres til XML ved at kalde externalizeCanonicalXmlString()-API'et.
En udvidelse af abstract-klassen org.apache.log4j.AppenderSkeleton under pakken org.eclipse.hyades.logging.log4j gør det muligt at konfigurere loggere til at registrere org.eclipse.hyades.logging.events.cbe.CommonBaseEvent- og org.apache.log4j.spi.LoggingEvent-logmeddelelser til en logagent.
Denne org.eclipse.hyades.logging.log4j.LoggingAgentAppender-tilføjelsesfunktion kontrollerer, om den org.eclipse.hyades.logging.events.cbe.CommonBaseEvent- og org.apache.log4j.spi.LoggingEvent-logmeddelelse, der registreres i en logger, kan registreres, baseret på loggerens og tilføjelsesfunktionens logniveau. Hvis logmeddelelsen skal registreres, opløses en logagent med samme navn som den logger, der registrerer meddelelsen. Ellers kan du bruge tilføjelsesfunktionen org.eclipse.hyades.logging.log4j.SingleLoggingAgentAppender, som opretter én logagent med navnet Logging Agent Appender. Meddelelsen formateres til XML vha. en org.eclipse.hyades.logging.log4j.XmlLayout og skrives til logagenten.
Illustrativt eksempel
Der medfølger et eksempel, som viser, hvordan du kan udnytte understøttelsen af Apache Jakarta Log4J-logning. Eksemplet illustrerer den konfiguration og instrumentering, der kræves for nye og eksisterende brugere af enkeltstående understøttelse og plugin-understøttelse af Apache Jakarta Log4J-logning. Du kan få flere oplysninger ved at vælge Fil > Ny > Eksempel... > Apache Log4J-logeksempel.
Illustrativt eksempel
Der medfølger et eksempel, der viser, hvordan du kan udnytte understøttelsen af EMF Common Base Events ved at oprette og konfigurere CBE-aktiviteter vha. CBE XML-filskabelonen Event Factory. Du kan få flere oplysninger ved at vælge Fil > Ny > Eksempel... > EMF Common Base Event v1.0.1 - eksempel.
Relaterede begreber
Common Base Event-model
(C) Copyright IBM Corporation 2000, 2006. All Rights Reserved.