Funktionen för logg- och spårningsanalys har funktioner för fristående tillämpningar och insticksprogram för följande loggningsverktyg:
Den här funktionen innefattar:
Den här funktionen ingår i följande insticksprogram:
Loggningsverktyg |
Insticksprogram för JAR-filer |
---|---|
Java-loggning (JSR-047) |
org.eclipse.hyades.logging.core\hl14.jar |
Gemensam Apache Jakarta-loggning |
org.eclipse.hyades.logging.core\hlcommons.jar |
Apache Jakarta Log4J-loggning |
org.eclipse.hyades.logging.core\hllog4j.jar |
Gemensamma EMF-bashändelser version 1.0.1 |
org.eclipse.hyades.logging.core\hlcbe101.jar |
I följande avsnitt beskrivs funktionerna för varje loggningsverktyg detaljerat. Dessutom finns det länkar till exempel som visar hur du använder dem.
Med en utökning av klassen java.util.logging.LogRecord under paketet org.eclipse.hyades.logging.java14 kan du skapa en anpassad loggpost för loggning av en org.eclipse.hyades.logging.events.cbe.CommonBaseEvent i en java.util.logging.LogRecord. Den här org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord utökar java.util.logging.LogRecord och innehåller en referens till en org.eclipse.hyades.logging.events.cbe.CommonBaseEvent. Alla egenskaper för java.util.logging.LogRecord avbildas till en eller flera egenskaper för gemensamma bashändelser för att bibehålla reflexivitet för formateringsfunktioner och hanterare som inte har funktioner för gemensamma bashändelser.
En implementering av gränssnittet java.util.logging.Filter under paketet org.eclipse.hyades.logging.java14 tillåter endast att org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord loggas.
En utökning av den abstrakta klassen java.util.logging.Formatter under paketet org.eclipse.hyades.logging.java14 gör att du kan konfigurera hanterare till att formatera loggmeddelandena org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord och java.util.logging.LogRecord till XML. Med formateringsfunktionen org.eclipse.hyades.logging.java14.XmlFormatter konverteras loggmeddelandena org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord eller java.util.logging.LogRecord till XML enligt schemat för gemensamma bashändelser, version 1.0.1. När formateringen sker kontrolleras att loggmeddelandet implementeras i gränssnittet org.eclipse.hyades.logging.core.IExternalizableToXml (t.ex. org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord). Om det gör det anropas APIt externalizeCanonicalXmlString() i stället för XML-serialisering. I annat fall konverteras loggmeddelandet java.util.logging.LogRecord till ett objekt för gemensamma bashändelser med hjälp av samma avbildning som i org.eclipse.hyades.logging.events.cbe.CommonBaseEvent och serialiseras till XML genom anrop till APIt externalizeCanonicalXmlString().
En utökning av den abstrakta klassen java.util.logging.Handler under paketet org.eclipse.hyades.logging.java gör att loggar kan konfigureras till att logga org.eclipse.hyades.logging.events.cbe.CommonBaseEvent- och java.util.logging.LogRecord-loggmeddelandet till en loggagent.
Hanteraren org.eclipse.hyades.logging.java.LoggingAgentHandler kontrollerar om org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord- eller java.util.logging.LogRecord- loggmeddelandet som loggas till en loggningsfunktion kan loggas enligt loggningsfunktionens och hanterarens filter- och loggningsnivå. Om loggmeddelandet ska loggas tilldelas en loggningsagent med samma namn som den loggningsfunktionen som används till att logga meddelandet. I andra fall kan du använda org.eclipse.hyades.logging.java.SingleLoggingAgentHandler som skapar en loggagent som kallas loggagenthanteraren. Meddelandet formateras i XML med hjälp av en org.eclipse.hyades.logging.java.XmlFormatter och skrivs till loggningsagenten.
Illustrerande exempel
Ett exempel medföljer som visar hur funktionerna för Java-loggningen JSR-047 utnyttjas, med en illustration av den konfiguration och instrumentation som krävs för nya och befintliga användare av den fristående tillämpningen och insticksprogrammet för Java-loggning JSR-047. Mer information finns under Arkiv > Nytt > Exempel... > Loggningsexempel för JSR-047.
En implementering av gränssnittet org.apache.commons.logging.Log under paketet org.eclipse.hyades.logging.commons gör att du kan skapa en loggningsfunktion för loggning av loggmeddelandena org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object och java.lang.Throwable. Med org.eclipse.hyades.logging.commons.Logger görs en kontroll av om loggmeddelandet org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object eller java.lang.Throwable som loggas till en loggningsfunktion kan loggas enligt loggningsfunktionens loggningsnivå. Om loggmeddelandet ska loggas kommer loggmeddelandet org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object eller java.lang.Throwable att loggas och formateras. Det finns en implementering av den abstrakta klassen org.apache.commons.logging.LogFactory, som representerar en proxyfabrik som är specifik för förekomster av org.eclipse.hyades.logging.commons.Logger. Proxyfabriken org.eclipse.hyades.logging.commons.LoggerFactory ska användas i miljöer med inläsningsfunktioner för flera klasser, där en eller flera typer av loggningsfunktioner och deras fabriker krävs för varje separat klassinläsningsfunktion, som alla använder samma gemensamma binärfiler för Apache.
Med org.eclipse.hyades.logging.commons.Logger formateras org.eclipse.hyades.logging.events.cbe.CommonBaseEvent-, java.lang.Object- och java.lang.Throwable-loggmeddelanden till XML enligt schemat för gemensamma bashändelser, version 1.0.1. Under formateringen kontrolleras att loggmeddelandet implementerar gränssnittet org.eclipse.hyades.logging.core.IExternalizableToXml (t.ex. org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Om det gör det anropas APIt externalizeCanonicalXmlString() i stället för XML-serialisering. I annat fall konverteras java.lang.Obje ct- eller java.lang.Throwable-loggmeddelandet till ett objekt för gemensam bashändelse med hjälp av metoderna org.ecli pse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent() och serialiseras till XML genom anrop till APIt externalizeCanonicalXmlString().
org.eclipse.hyades.logging.commons.Logger loggar loggmeddelandena org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object och java.lang.Throwable till en loggningsagent. Om loggmeddelandet ska loggas tilldelas en loggningsagent med samma namn som den loggningsfunktionen som används till att logga meddelandet. Meddelandet formateras till XML och skrivs till loggningsagenten.
Med en implementering av gränssnittet org.apache.commons.logging.Log under paketet org.eclipse.hyades.logging.commons kan du skapa en loggningsfunktion för loggning av loggmeddelandena org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object och java.lang.Throwable till en lokal fil. Den här org.eclipse.hyades.logging.commons.FileLogger kontrollerar för att se om loggmeddelandena org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object eller java.lang.Throwable som är loggade till en loggningsfunktion kan loggas enligt loggningsfunktionens loggningsnivå. Om loggmeddelandet ska loggas formateras loggmeddelandet org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object eller java.lang.Throwable till XML och loggas till en lokal fil. Det finns en implementering av den abstrakta klassen org.apache.commons.logging.LogFactory, som representerar en proxyfabrik som är specifik för förekomster av org.eclipse.hyades.logging.commons.FileLogger. Proxyfabriken org.eclipse.hyades.logging.commons.FileLoggerFactory ska användas i miljöer med inläsningsfunktioner för flera klasser, där en eller flera typer av loggningsfunktioner och deras fabriker krävs för varje separat klassinläsningsfunktion, som alla använder samma gemensamma binärfiler för Apache.
Illustrerande exempel
Ett exempel medföljer som visar hur funktionerna för gemensam Apache Jakarta-loggning utnyttjas, med en illustration av den konfiguration och instrumentation som krävs för nya och befintliga användare av den fristående tillämpningen och insticksprogrammet gemensam Apache Jakarta-loggning. Mer information finns under Arkiv > Nytt > Exempel... > Loggningsexempel för Apache.
Meddelandeegenskaperna hos loggmeddelandet org.apache.log4j.spi.LoggingEvent gör att du kan logga en org.eclipse.hyades.logging.events.cbe.CommonBaseEvent.
Med utökningen av den abstrakta klassen org.apache.log4j.spi.Filter under paketet org.eclipse.hyades.logging.log4j kan endast org.eclipse.hyades.logging.events.cbe.CommonBaseEvent loggas.
Med en utökning av den abstrakta klassen org.apache.log4j.Layout under paketet org.eclipse.hyades.logging.log4j kan du konfigurera tillägg så att de loggmeddelandena org.eclipse.hyades.logging.events.cbe.CommonBaseEvent och org.apache.log4j.spi.LoggingEvent formateras till XML. Den här formateringsfunktionen org.eclipse.hyades.logging.log4j.XmlLayout konverterar loggmeddelandena org.eclipse.hyades.logging.events.cbe.CommonBaseEvent eller org.apache.log4j.spi.LoggingEvent till XML enligt schemat för gemensam bashändelse, version 1.0.1. Under formateringen kontrolleras om meddelandeegenskaperna för org.apache.log4j.spi.LoggingEvent implementerar gränssnittet org.eclipse.hyades.logging.core.IExternalizableToXml (exempelvis org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Om det gör det anropas APIt externalizeCanonicalXmlString() i stället för XML-serialisering. I annat fall konverteras loggmeddelandet org.apache.log4j.spi.LoggingEvent till ett objekt i gemensam bashändelse med hjälp av metoderna org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent() och serialiseras till XML genom anrop till APIt externalizeCanonicalXmlString().
Med utökningen av den abstrakta klassen org.apache.log4j.AppenderSkeleton under paketet org.eclipse.hyades.logging.log4j kan du konfigurera tillägg så att de loggar loggmeddelandena org.eclipse.hyades.logging.events.cbe.CommonBaseEvent och
org.apache.log4j.spi.LoggingEvent till en loggningsagent.
Med tillägget org.eclipse.hyades.logging.log4j.LoggingAgentAppender görs en kontroll av om loggmeddelandena org.eclipse.hyades.logging.events.cbe.CommonBaseEvent och org.apache.log4j.spi.LoggingEvent, som loggas till en loggningsfunktion kan loggas enligt filtrerings- och loggningsnivån för tillägget och loggningsfunktionen. Om loggmeddelandet ska loggas tilldelas en loggningsagent med samma namn som den loggningsfunktionen som används till att logga meddelandet. I andra fall kan du använda tillägget org.eclipse.hyades.logging.log4j.SingleLoggingAgentAppender som skapar en loggningsagent, loggningsagentillägget. Meddelandet formateras till XML med hjälp av en org.eclipse.hyades.logging.log4j.XmlLayout och skrivs till loggningsagenten.
Illustrerande exempel
Ett exempel medföljer som visar hur funktionerna för Apache Jakarta Log4J-loggning utnyttjas, med en illustration av den konfiguration och instrumentation som krävs för nya och befintliga användare av den fristående tillämpningen och insticksprogrammet för Apache Jakarta Log4J-loggning. Mer information finns under Arkiv > Nytt > Exempel... > Loggningsexempel för Apache Log4J.
Illustrerande exempel
Ett exempel medföljer som visar hur funktionerna för gemensamma EMF-bashändelser utnyttjas, genom att skapa och konfigurera gemensamma bashändelser med händelsefabriken för XML-filmallar för gemensamma bashändelser. Mer information finns under Arkiv > Nytt > Exempel... > Exempel för gemensamma EMF-bashändelser version 1.0.1.
Närliggande begrepp
Modell för gemensamma bashändelser
(C) Copyright IBM Corporation 2000, 2006. All Rights Reserved.