A Napló- és nyomkövetés-elemző önálló és bedolgozó támogatást is biztosít a következő naplózási segédprogramokhoz:
A támogatás az alábbiakat foglalja magában:
Ezt a támogatást az alábbi bedolgozók biztosítják:
Naplózó segédprogram |
Bedolgozó JAR-ok |
---|---|
Java naplózás (JSR-047) |
org.eclipse.hyades.logging.core\hl14.jar |
Apache Jakarta Commons naplózás |
org.eclipse.hyades.logging.core\hlcommons.jar |
Apache Jakarta Log4J naplózás |
org.eclipse.hyades.logging.core\hllog4j.jar |
EMF Common Base Event V1.0.1 |
org.eclipse.hyades.logging.core\hlcbe101.jar |
A következő rész a naplózási segédprogram támogatás típusait mutatja be és hivatkozásokat biztosít a használatot bemutató példákra.
Az org.eclipse.hyades.logging.java14 csomagban található java.util.logging.LogRecord osztály kiterjesztése segítségével létrehozható egy egyéni naplóbejegyzés az org.eclipse.hyades.logging.events.cbe.CommonBaseEvent java.util.logging.LogRecord naplóban naplózásához. Az org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord kiterjeszti a java.util.logging.LogRecord naplóbejegyzést és hivatkozást tartalmaz egy org.eclipse.hyades.logging.events.cbe.CommonBaseEvent eseményre. Minden java.util.logging.LogRecord tulajdonság meg van feleltetve egy vagy több Common Base Event tulajdonságnak, a reflexivitás megőrzése érdekében a Common Base Eventeket nem támogató kezelőkkel és formázókkal.
Az org.eclipse.hyades.logging.java14 csomagban található java.util.logging.Filter felület egyik megvalósítása csak az org.eclipse.hyades.logging.java14.CommonBaseEventLogRecords sikeres naplózását engedélyezi.
Az org.eclipse.hyades.logging.java14 csomag alatt található java.util.logging.Formatter absztrakt osztály egy kiterjesztése lehetővé teszi kezelők létrehozását az org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord és java.util.logging.LogRecord naplóüzenet XML-lé alakításához. Az org.eclipse.hyades.logging.java14.XmlFormatter formázó a Common Base Event v1.0.1 séma alapján az org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord vagy java.util.logging.LogRecord naplóüzenetet XML-lé átalakítja. Formázáskor a naplóüzenet ellenőrzésre kerül, hogy megvalósítja-e az org.eclipse.hyades.logging.core.IExternalizableToXml felületet (például org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord). Ha igen, akkor az XML sorbafejtés helyett az externalizeCanonicalXmlString() API kerül meghívásra. Ellenkező esetben a java.util.logging.LogRecord naplóbejegyzés az org.eclipse.hyades.logging.events.cbe.CommonBaseEvent által is használt leképezéssel átalakításra kerül Common Base Event objektummá és az externalizeCanonicalXmlString() API meghívásával sorbafejtésre kerül XML-lé.
Az
org.eclipse.hyades.logging.java csomagban található
java.util.logging.Handler
absztraktosztály egyik kiterjesztése segítségével a naplózók
beállíthatók úgy, hogy az
org.eclipse.hyades.logging.events.cbe.CommonBaseEvent és
java.util.logging.LogRecord naplóbejegyzéseket egy naplózó
ügynökbe naplózzák.
Az org.eclipse.hyades.logging.java.LoggingAgentHandler kezelő ellenőrzi, hogy a naplózóban naplózott org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord vagy java.util.logging.LogRecord naplóbejegyzés naplózható-e a naplózó és a kezelő szűrési és naplózási szintje alapján. Ha a naplóüzenet naplózható, akkor a naplózó ügynök az üzenetet naplózó naplózóval megegyező névvel kerül feloldásra. Ellenkező esetben az org.eclipse.hyades.logging.java.SingleLoggingAgentHandler kezelő használható, amely a Naplózó ügynökkezelő nevű naplózó ügynököt hozza létre. Az üzenet az org.eclipse.hyades.logging.java.XmlFormatter segítségével formázásra kerül XML-lé és beíródik a naplózó ügynökbe.
Szemléltető példa
A példa JSR-047 Java naplózás önálló vagy bedolgozó támogatásának új vagy meglévő felhasználói által igényelt beállítás és kellékek szemléltetésével bemutatja, hogy a JSR-047 Java naplózás támogatása hogyan használható ki. További információkért nyissa meg a Fájl > Új > Példa... > JSR-047 naplózási minta elemeket.
Az org.eclipse.hyades.logging.commons csomag alatt lévő org.apache.commons.logging.Log felület egy megvalósítása segítségével az org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object és java.lang.Throwable naplóüzenetek naplózásához létrehozhat egy naplózót. Az org.eclipse.hyades.logging.commons.Logger ellenőrzi, hogy a naplózóban naplózott org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object vagy java.lang.Throwable naplóüzenet naplózható-e a naplózó naplózási szintje alapján. Ha a naplóüzenetet naplózni kell, akkor az org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object vagy java.lang.Throwable naplóüzenet formázásra és naplózásra kerül. Az org.apache.commons.logging.LogFactory absztrakt osztály egy megvalósítása biztosítva van, amely az org.eclipse.hyades.logging.commons.Logger példányok specifikus proxygyárát ábrázolja. Az org.eclipse.hyades.logging.commons.LoggerFactory proxygyár többféle osztálybetöltő környezetben is használható, amelyben néhány különböző naplózótípus és azok gyárai szükségesek a különálló osztálybetöltőkhöz, amelyek mindegyike ugyanazokat az Apache Commons bináris fájlokat használja.
Az org.eclipse.hyades.logging.commons.Logger a Common Base Event v1.0.1 séma alapján az org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object és java.lang.Throwable naplóüzeneteket XML-lé alakítja. Formázáskor a naplóüzenet ellenőrzésre kerül, hogy megvalósítja-e az org.eclipse.hyades.logging.core.IExternalizableToXml felületet (például org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Ha igen, akkor az XML sorbafejtés helyett az externalizeCanonicalXmlString() API kerül meghívásra. Ellenkező esetben a java.lang.Object vagy java.lang.Throwable naplóüzenet az org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent() metódus segítségével átalakításra kerül Common Base Event objektummá és az externalizeCanonicalXmlString() API meghívásával sorbafejtésre kerül XML-lé.
Az org.eclipse.hyades.logging.commons.Logger az org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object és java.lang.Throwable naplóüzeneteket egy naplózó ügynökbe naplózza. Ha a naplóüzenet naplózható, akkor a naplózó ügynök az üzenetet naplózó naplózóval megegyező névvel kerül feloldásra. Az üzenet átalakításra kerül XML-lé és a naplózó ügynökbe íródik.
Az org.eclipse.hyades.logging.commons csomag alatt lévő org.apache.commons.logging.Log felület egy megvalósítása segítségével az org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object és java.lang.Throwable naplóüzenetek fájlba naplózásához létrehozható egy naplózó. Az org.eclipse.hyades.logging.commons.FileLogger ellenőrzi, hogy a naplózóban naplózott org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object vagy java.lang.Throwable naplóüzenet naplózható-e a naplózó naplózási szintje alapján. Ha a naplóüzenetet naplózni kell, akkor az org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object vagy java.lang.Throwable naplóüzenet formázásra XML-lé és naplózásra kerül egy helyi fájlba. Az org.apache.commons.logging.LogFactory absztrakt osztály egy megvalósítása biztosítva van, amely az org.eclipse.hyades.logging.commons.FileLogger példányok specifikus proxygyárát ábrázolja. Az org.eclipse.hyades.logging.commons.FileLoggerFactory proxygyár többféle osztálybetöltő környezetben is használható, amelyben néhány különböző naplózótípus és azok gyárai szükségesek a különálló osztálybetöltőkhöz, amelyek mindegyike ugyanazokat az Apache Commons bináris fájlokat használja.
Szemléltető példa
A példa Apache Jakarta Commons naplózás önálló vagy bedolgozó támogatásának új vagy meglévő felhasználói által igényelt beállítás és kellékek szemléltetésével bemutatja, hogy a Apache Jakarta Commons naplózás támogatása hogyan használható. További információkért tekintse meg a Fájl > Új > Példa... > Apache Commons naplózási minta elemeket.
Az org.apache.log4j.spi.LoggingEvent naplóüzenet üzenettulajdonsága lehetővé tesz egy org.eclipse.hyades.logging.events.cbe.CommonBaseEvent naplózását.
Az org.eclipse.hyades.logging.log4j csomagban található org.apache.log4j.spi.Filter absztrakt osztály egyik kiterjesztése csak az org.eclipse.hyades.logging.events.cbe.CommonBaseEvent események sikeres naplózását teszi lehetővé.
Az org.eclipse.hyades.logging.log4j csomagban található org.apache.log4j.Layout absztraktosztály egyik kiterjesztése segítségével hozzáfűzők állíthatók be az org.eclipse.hyades.logging.events.cbe.CommonBaseEvent és org.apache.log4j.spi.LoggingEvent naplóüzenet XML-lé formázásához. Az org.eclipse.hyades.logging.log4j.XmlLayout formázó a Common Base Event v1.0.1 séma alapján átalakítja az org.eclipse.hyades.logging.events.cbe.CommonBaseEvent vagy org.apache.log4j.spi.LoggingEvent naplóüzenetet XML-lé. Formázáskor a naplóüzenet ellenőrzésre kerül, hogy az org.apache.log4j.spi.LoggingEvent üzenettulajdonsága megvalósítja-e az org.eclipse.hyades.logging.core.IExternalizableToXml felületet (például org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Ha igen, akkor az XML sorbafejtés helyett az externalizeCanonicalXmlString() API kerül meghívásra. Ellenkező esetben az org.apache.log4j.spi.LoggingEvent naplóüzenet az org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent() metódusok segítségével átakításra kerül Common Base Event objektummá és az externalizeCanonicalXmlString() API meghívásával sorbafejtésre kerül XML-lé.
Az
org.eclipse.hyades.logging.log4j csomagban található
org.apache.log4j.AppenderSkeleton
absztrakt osztály egyik kiterjesztése segítségével a naplózók
beállíthatók úgy, hogy az
org.eclipse.hyades.logging.events.cbe.CommonBaseEvent és
org.apache.log4j.spi.LoggingEvent naplóüzeneteket egy naplózó
ügynökbe naplózzák.
Az org.eclipse.hyades.logging.log4j.LoggingAgentAppender hozzáfűző ellenőrzi, hogy a naplózóba naplózott org.eclipse.hyades.logging.events.cbe.CommonBaseEvent és org.apache.log4j.spi.LoggingEvent naplóüzenet a naplózó és hozzáfűző szűrési és naplózási szintje alapján naplózható-e. Ha a naplóüzenetet naplózni kell, akkor a Naplózó ügynök az üzenetet naplózó naplózóval megegyező névvel kerül feloldásra. Ellenkező esetben az org.eclipse.hyades.logging.log4j.SingleLoggingAgentAppender hozzáfűző használható, amely létrehoz egy Naplózó ügynök hozzáfűző nevű naplózási ügynököt. Az üzenet az org.eclipse.hyades.logging.log4j.XmlLayout segítségével formázásra kerül XML-lé és a naplózási ügynökbe íródik.
Szemléltető példa
A példa Apache Jakarta Log4J naplózás önálló vagy bedolgozó támogatásának új vagy meglévő felhasználói által igényelt beállítás és kellékek szemléltetésével bemutatja, hogy a Apache Jakarta Log4J naplózás támogatása hogyan használható ki. További információkért tekintse meg a Fájl > Új > Példa... > Apache Log4J naplózási minta elemeket.
Szemléltető példa
A példa bemutatja milyen módon lehet elérni az EMF Common Base Events támogatását a Common Base Event XML fájljának eseménygyár sablonja segítségével a Common Base Events létrehozásával és konfigurálásával. További információkért tekintse meg a Fájl > Új > Példa... > EMF Common Base Event v1.0.1 minta elemet.
Kapcsolódó fogalmak
Common Base Event modell
(C) Copyright IBM Corporation 2000, 2006. Minden jog fenntartva.