Logg- og sporingsanalysatoren gir frittstående støtte og plugin-støtte for disse loggingsfunksjonene:
Denne støtten innebærer
Støtten gis av disse plugin-modulene:
Loggingsfunksjonen |
Plugin-JAR |
---|---|
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 |
Avsnittene nedenfor inneholder detaljerte opplysninger om hver loggingsfunksjon og peker til eksempler som viser hvordan du bruker funksjonen.
En utvidelse av klassen java.util.logging.LogRecord i pakken org.eclipse.hyades.logging.java14 gjør at du kan opprette en tilpasset loggpost for logging av en org.eclipse.hyades.logging.events.cbe.CommonBaseEvent i en java.util.logging.LogRecord. Denne org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord utvider java.util.logging.LogRecord og inneholder en referanse til en org.eclipse.hyades.logging.events.cbe.CommonBaseEvent. Alle java.util.logging.LogRecord-egenskaper blir tilordnet til en eller flere Common Base Event-egenskaper for å opprettholde refleksivitet for ikke-Common Base Event Aware-behandlere og formaterere.
En implementering av java.util.logging.Filter-grensesnittet under org.eclipse.hyades.logging.java14-pakken tillater bare logging av org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord-poster.
En utvidelse av den abstrakte klassen java.util.logging.Formatter under pakken org.eclipse.hyades.logging.java14 gjør at du kan konfigurere behandlere slik at de formaterer org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord- og java.util.logging.LogRecord-loggmeldinger til XML. Denne org.eclipse.hyades.logging.java14.XmlFormatter-formatereren konverterer org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord- eller java.util.logging.LogRecord-loggmeldingen til XML, basert på Common Base Event v1.0.1-skjemaet. Under formatering blir loggmeldingen kontrollert for å se om den implementerer grensesnittet org.eclipse.hyades.logging.core.IExternalizableToXml (for eksempel org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord). Hvis den gjør det, blir APIen externalizeCanonicalXmlString() kalt i stedet for XML-serialisering. Ellers blir loggmeldingen java.util.logging.LogRecord konvertert til et Common Base Event-objekt ved hjelp av den samme tilordningen som org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, og serialisert til XML ved å kalle APIen externalizeCanonicalXmlString().
En utvidelse av den abstrakte klassen java.util.logging.Handler
under pakken org.eclipse.hyades.logging.java gjør at loggere kan konfigureres til å logge
org.eclipse.hyades.logging.events.cbe.CommonBaseEvent- og
java.util.logging.LogRecord-loggmeldinger til en loggingsagent.
Denne org.eclipse.hyades.logging.java.LoggingAgentHandler-behandleren kontrollerer om org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord- eller java.util.logging.LogRecord-loggmeldingen som er logget til en logger, kan baseres på loggerens og behandlerens filter og loggingsnivå. Hvis loggmeldingen skal logges, blir loggingsagenten behandlet med det samme navnet som loggeren som logger meldingen. Hvis ikke, kan du bruke org.eclipse.hyades.logging.java.SingleLoggingAgentHandler-behandleren, som oppretter en loggingsagent som heter Logging Agent Handler. Meldingen blir formatert i XML ved hjelp av en org.eclipse.hyades.logging.java.XmlFormatter, og skrevet til loggingsagenten.
Forklarende eksempel
Et eksempel som viser bruk av støtten for JSR-047 Java Logging, forklarer konfigurasjonen og instrumenteringen som kreves for nye og eksisterende brukere av frittstående støtte og plugin-støtte for JSR-047 Java Logging. Hvis du vil vite mer, åpner du Fil > Ny(tt) > Eksempel... > Eksempel på JSR-047-logging.
En implementering av grensesnittet org.apache.commons.logging.Log under pakken org.eclipse.hyades.logging.commons gjør at du kan opprette en logger for å logge org.eclipse.hyades.logging.events.cbe.CommonBaseEvent-, java.lang.Object- og java.lang.Throwable-loggmeldinger. org.eclipse.hyades.logging.commons.Logger kontrollerer at org.eclipse.hyades.logging.events.cbe.CommonBaseEvent-, java.lang.Object- eller java.lang.Throwable-loggmeldinger som er logget til en logger, kan logges basert på loggerens loggingsnivå. Hvis loggmeldingen skal logges, blir loggmeldingen org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object eller java.lang.Throwable formatert og logget. En implementering av den abstrakte klassen org.apache.commons.logging.LogFactory er tilgjengelig og representerer en proxy factory som er spesifikk for org.eclipse.hyades.logging.commons.Logger-forekomster. Proxy-facoryen org.eclipse.hyades.logging.commons.LoggerFactory er beregnet på flere klasselastermiljøer, der en eller flere ulike typer loggere og tilhørende factories, kreves for hver klasselaster. Alle bruker samme Apache Commons-binærfiler.
org.eclipse.hyades.logging.commons.Logger-formatene org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object og java.lang.Throwable logger meldinger til XML basert på Common Base Event v1.0.1-skjemaet. Under formatering blir loggmeldingen kontrollert for å se om den implementerer grensesnittet org.eclipse.hyades.logging.core.IExternalizableToXml (for eksempel org.eclipse.hyades.logging.events.cbe.CommonBaseEvent. Hvis den gjør det, blir APIen externalizeCanonicalXmlString() kalt i stedet for XML-serialisering. Ellers blir loggmeldingen java.lang.Object eller java.lang.Throwable konvertert til et Common Base Event-objekt ved hjelp av metodene org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent() og serialisert til XML ved å kalle APIen externalizeCanonicalXmlString().
org.eclipse.hyades.logging.commons.Logger logger loggmeldingene org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object og java.lang.Throwable til en loggingsagent. Hvis loggmeldingen skal logges, blir loggingsagenten behandlet med det samme navnet som loggeren som logger meldingen. Meldingen blir formatert til XML og skrevet til loggingsagenten.
En implementering av grensesnittet org.apache.commons.logging.Log under pakken org.eclipse.hyades.logging.commons gjør at du kan opprette en logger for å logge org.eclipse.hyades.logging.events.cbe.CommonBaseEvent-, java.lang.Object- og java.lang.Throwable-loggmeldinger til en lokal fil. org.eclipse.hyades.logging.commons.FileLogger kontrollerer at org.eclipse.hyades.logging.events.cbe.CommonBaseEvent-, java.lang.Object- eller java.lang.Throwable-loggmeldinger som er logget til en logger, kan logges basert på loggerens loggingsnivå. Hvis loggmeldingen skal logges, blir loggmeldingen org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object eller java.lang.Throwable formatert til XML og logget til en lokal fil. En implementering av den abstrakte klassen org.apache.commons.logging.LogFactory er tilgjengelig og representerer en proxy factory som er spesifikk for org.eclipse.hyades.logging.commons.FileLogger-forekomster. Proxy-factoryen org.eclipse.hyades.logging.commons.FileLoggerFactory er beregnet på flere klasselastermiljøer, der en eller flere ulike typer loggere og tilhørende factories, kreves for hver klasselaster. Alle bruker samme Apache Commons-binærfiler.
Forklarende eksempel
Et eksempel som viser bruk av støtten for Apache Jakarta Logging, forklarer konfigurasjonen og instrumenteringen som kreves for nye og eksisterende brukere av frittstående støtte og plugin-støtte for Apache Jakarta Commons Logging. Hvis du vil vite mer, åpner du Fil > Ny(tt) > Eksempel... > Eksempel på Apache Commons-logging.
Meldingsegenskapen til loggmeldingen org.apache.log4j.spi.LoggingEvent gjør at du kan logge en org.eclipse.hyades.logging.events.cbe.CommonBaseEvent.
En utvidelse av den abstrakte klassen org.apache.log4j.spi.Filter under org.eclipse.hyades.logging.log4j tillater bare logging av org.eclipse.hyades.logging.events.cbe.CommonBaseEvent.
En utvidelse av den abstrakte klassen org.apache.log4j.Layout under pakken org.eclipse.hyades.logging.log4j gjør at du kan konfigurere tilføyere for å formatere org.eclipse.hyades.logging.events.cbe.CommonBaseEvent og org.apache.log4j.spi.LoggingEvent-loggmeldinger til XML. Denne org.eclipse.hyades.logging.log4j.XmlLayout-formatereren konverterer org.eclipse.hyades.logging.events.cbe.CommonBaseEvent eller org.apache.log4j.spi.LoggingEvent-loggmeldingen til XML, basert på Common Base Event v1.0.1-skjemaet. Under formatering blir loggmeldingen kontrollert for å se om meldingsegenskapen til org.apache.log4j.spi.LoggingEvent implementerer grensesnittet org.eclipse.hyades.logging.core.IExternalizableToXml (for eksempel org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Hvis den gjør det, blir APIen externalizeCanonicalXmlString() kalt i stedet for XML-serialisering. Ellers blir loggmeldingen org.apache.log4j.spi.LoggingEvent konvertert til et Common Base Event-objekt ved hjelp av metodene org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent() og serialisert til XML ved å kalle APIen externalizeCanonicalXmlString().
En utvidelse av den abstrakte klassen
org.apache.log4j.AppenderSkeleton under
pakken org.eclipse.hyades.logging.log4j gjør at du kan
konfigurere loggere til å logge
org.eclipse.hyades.logging.events.cbe.CommonBaseEvent og
org.apache.log4j.spi.LoggingEvent-loggmeldinger til en loggingsagent.
Denne org.eclipse.hyades.logging.log4j.LoggingAgentAppender-tilføyeren kontrollerer om org.eclipse.hyades.logging.events.cbe.CommonBaseEvent og org.apache.log4j.spi.LoggingEvent-loggmeldingen som er logget til en logger, kan logges basert på loggerens og tilføyerens filter og loggingsnivå. Hvis loggmeldingen skal logges, blir loggingsagenten behandlet med det samme navnet som loggeren som logger meldingen. Hvis ikke, kan du bruke tilføyeren org.eclipse.hyades.logging.log4j.SingleLoggingAgentAppender, som oppretter en loggingsagent som heter Logging Agent Appender. Meldingen blir formatert til XML ved hjelp av en org.eclipse.hyades.logging.log4j.XmlLayout, og skrevet til loggingsagenten.
Forklarende eksempel
Et eksempel som viser bruk av støtten for Apache Jakarta Log4J-logging, forklarer konfigurasjonen og instrumenteringen som kreves for nye og eksisterende brukere av frittstående støtte og plugin-støtte for Apache Jakarta Log4J-logging. Hvis du vil vite mer, åpner du Fil > Ny(tt) > Eksempel... > Eksempel på Apache Log4J-logging.
Forklarende eksempel
Et eksempel som viser bruk av støtte for EMF Common Base Events ved å opprette og konfigurere Common Base Events ved hjelp av Common Base Event XML-malfilen Event Factory. Hvis du vil vite mer, åpner du Fil > Ny(tt) > Eksempel... > Eksempel på EMF Common Base Event v1.0.1.
Beslektede begreper
Common Base Event-modell
(C) Copyright IBM Corporation 2000, 2006. All Rights Reserved.