Analizator plików dziennika i śledzenia, zarówno w postaci autonomicznej, jak i w postaci wtyczki, obsługuje następujące narzędzia rejestrowania:
Obsługa obejmuje:
Obsługę tych mechanizmów zapewniają następujące wtyczki:
Narzędzie rejestrowania |
Pliki JAR wtyczek |
---|---|
Rejestrowanie Java (JSR-047) |
org.eclipse.hyades.logging.core\hl14.jar |
Rejestrowanie Apache Jakarta Commons |
org.eclipse.hyades.logging.core\hlcommons.jar |
Rejestrowanie Apache Jakarta Log4J |
org.eclipse.hyades.logging.core\hllog4j.jar |
Model EMF Common Base Event V1.0.1 |
org.eclipse.hyades.logging.core\hlcbe101.jar |
W następnych sekcjach szczegółowo opisano poszczególne typy obsługi narzędzi rejestrowania i udostępniono odsyłacze do przykładów demonstrujących sposoby ich wykorzystania.
Rozszerzenie klasy java.util.logging.LogRecord w pakiecie org.eclipse.hyades.logging.java14 umożliwia utworzenie niestandardowego rekordu dziennika w celu zarejestrowania obiektu org.eclipse.hyades.logging.events.cbe.CommonBaseEvent w rekordzie typu java.util.logging.LogRecord. Obiekt org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord rozszerza obiekt java.util.logging.LogRecord i zawiera odwołanie do obiektu org.eclipse.hyades.logging.events.cbe.CommonBaseEvent. Wszystkie właściwości obiektu java.util.logging.LogRecord są odwzorowywane na jedną lub wiele właściwości modelu Common Base Event w celu zapewnienia refleksji w przypadku procedur obsługi i formaterów nieobsługujących modelu Common Base Event.
Implementacja interfejsu java.util.logging.Filter w pakiecie org.eclipse.hyades.logging.java14 pozwala tylko na pomyślne rejestrowanie obiektów org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord.
Rozszerzenie klasy abstrakcyjnej java.util.logging.Formatter w pakiecie org.eclipse.hyades.logging.java14 umożliwia konfigurowanie procedur obsługi na potrzeby formatowania komunikatów dziennika org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord i java.util.logging.LogRecord w języku XML. Formater org.eclipse.hyades.logging.java14.XmlFormatter przekształca komunikat dziennika org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord lub java.util.logging.LogRecord na format XML zgodnie ze schematem modelu Common Base Event w wersji 1.0.1. Podczas formatowania dokonywane jest sprawdzenie, czy komunikat dziennika implementuje interfejs org.eclipse.hyades.logging.core.IExternalizableToXml (np. org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord). Jeśli tak, to zamiast serializacji do formatu XML wywoływana jest metoda API externalizeCanonicalXmlString(). W przeciwnym razie komunikat dziennika java.util.logging.LogRecord jest przekształcany w obiekt modelu Common Base Event za pomocą tego samego odwzorowania co obiekt org.eclipse.hyades.logging.events.cbe.CommonBaseEvent i serializowany do formatu XML poprzez wywołanie metody API externalizeCanonicalXmlString().
Rozszerzenie klasy abstrakcyjnej java.util.logging.Handler w pakiecie org.eclipse.hyades.logging.java umożliwia konfigurowanie programów rejestrujących na potrzeby rejestrowania komunikatów dziennika org.eclipse.hyades.logging.events.cbe.CommonBaseEvent i java.util.logging.LogRecord w agencie rejestrowania.
Procedura obsługi org.eclipse.hyades.logging.java.LoggingAgentHandler sprawdza, czy komunikat dziennika org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord lub java.util.logging.LogRecord rejestrowany w programie rejestrującym może być zarejestrowany z uwzględnieniem filtru i poziomu rejestrowania programu rejestrującego oraz procedury obsługi. Jeśli komunikat dziennika ma zostać zarejestrowany, tworzony jest agent rejestrowania o takiej samej nazwie, jak program rejestrujący dany komunikat. W przeciwnym razie można użyć procedury obsługi org.eclipse.hyades.logging.java.SingleLoggingAgentHandler, która tworzy jednego agenta rejestrowania o nazwie Procedura obsługi agenta rejestrowania. Komunikat jest formatowany w języku XML przy użyciu formatera org.eclipse.hyades.logging.java.XmlFormatter i zapisywany w agencie rejestrowania.
Przykład
W podanym przykładzie pokazano, jak można wykorzystać obsługę rejestrowania Java JSR-047. W tym celu opisano konfigurację i instrumentację wymagane w przypadku nowych i już istniejących użytkowników funkcji obsługi rejestrowania Java JSR-047 (w postaci autonomicznej i w postaci wtyczki). Aby uzyskać więcej informacji, kliknij opcję Plik > Nowy > Przykład... > Przykład rejestrowania JSR-047.
Implementacja interfejsu org.apache.commons.logging.Log w pakiecie org.eclipse.hyades.logging.commons umożliwia utworzenie programu rejestrującego na potrzeby rejestrowania komunikatów dziennika org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object i java.lang.Throwable. Program rejestrujący klasy org.eclipse.hyades.logging.commons.Logger sprawdza, czy komunikat dziennika org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object lub java.lang.Throwable rejestrowany w programie rejestrującym może zostać zarejestrowany z uwzględnieniem poziomu rejestrowania programu rejestrującego. Jeśli komunikat dziennika ma zostać zarejestrowany, to komunikat dziennika org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object lub java.lang.Throwable jest formatowany i rejestrowany. Udostępniona jest implementacja klasy abstrakcyjnej org.apache.commons.logging.LogFactory reprezentująca fabrykę proxy specjalizowaną dla instancji org.eclipse.hyades.logging.commons.Logger. Fabryka org.eclipse.hyades.logging.commons.LoggerFactory jest przeznaczona do użytku w środowiskach wielu programów ładujących klasy, z których każdy wymaga jednego lub większej liczby programów rejestrujących (różnych typów) wraz z fabrykami, a wszystkie one korzystają z tych samych plików binarnych Apache Commons.
Formater org.eclipse.hyades.logging.commons.Logger formatuje komunikaty dziennika org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object i java.lang.Throwable w języku XML zgodnie ze schematem modelu Common Base Event w wersji 1.0.1. Podczas formatowania dokonywane jest sprawdzenie, czy komunikat dziennika implementuje interfejs org.eclipse.hyades.logging.core.IExternalizableToXml (np. org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Jeśli tak, to zamiast serializacji do formatu XML wywoływana jest metoda API externalizeCanonicalXmlString(). W przeciwnym razie komunikat dziennika java.lang.Object lub java.lang.Throwable jest przekształcany w obiekt modelu Common Base Event przy użyciu metod org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent() i serializowany do formatu XML przez wywołanie metody API externalizeCanonicalXmlString().
Program rejestrujący org.eclipse.hyades.logging.commons.Logger rejestruje komunikaty dziennika org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object i java.lang.Throwable w agencie rejestrowania. Jeśli komunikat dziennika ma zostać zarejestrowany, tworzony jest agent rejestrowania o takiej samej nazwie, jak program rejestrujący dany komunikat. Komunikat jest formatowany w języku XML i zapisywany w agencie rejestrowania.
Implementacja interfejsu org.apache.commons.logging.Log w pakiecie org.eclipse.hyades.logging.commons umożliwia utworzenie programu rejestrującego na potrzeby rejestrowania komunikatów dziennika org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object i java.lang.Throwable w pliku lokalnym. Program rejestrujący org.eclipse.hyades.logging.commons.FileLogger sprawdza, czy komunikat dziennika org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object lub java.lang.Throwable rejestrowany w programie rejestrującym może zostać zarejestrowany z uwzględnieniem poziomu rejestrowania programu rejestrującego. Jeśli komunikat dziennika ma być zarejestrowany, to komunikat dziennika org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object lub java.lang.Throwable jest formatowany w języku XML i rejestrowany w pliku lokalnym. Udostępniana jest implementacja klasy abstrakcyjnej org.apache.commons.logging.LogFactory reprezentująca fabrykę proxy specjalizowaną dla instancji org.eclipse.hyades.logging.commons.FileLogger. Fabryka proxy org.eclipse.hyades.logging.commons.FileLoggerFactory jest przeznaczona do użytku w środowiskach wielu programów ładujących klasy, z których każdy wymaga jednego lub większej liczby programów rejestrujących (różnych typów) wraz z fabrykami, a wszystkie one korzystają z tych samych plików binarnych Apache Commons.
Przykład
W podanym przykładzie pokazano, jak można wykorzystać obsługę rejestrowania Apache Jakarta Commons. W tym celu opisano konfigurację i instrumentację wymagane w przypadku nowych i już istniejących użytkowników funkcji obsługi rejestrowania Apache Jakarta Commons (w postaci autonomicznej i w postaci wtyczki). Aby uzyskać więcej informacji, kliknij opcję Plik> Nowy > Przykład... > Przykład rejestrowania Apache Commons.
Właściwość komunikatu dziennika org.apache.log4j.spi.LoggingEvent umożliwia rejestrowanie org.eclipse.hyades.logging.events.cbe.CommonBaseEvent.
Rozszerzenie klasy abstrakcyjnej org.apache.log4j.spi.Filter w pakiecie org.eclipse.hyades.logging.log4j umożliwia jedynie rejestrowanie zdarzeń typu org.eclipse.hyades.logging.events.cbe.CommonBaseEvent.
Rozszerzenie klasy abstrakcyjnej org.apache.log4j.Layout w pakiecie org.eclipse.hyades.logging.log4j umożliwia konfigurowanie programów dołączających na potrzeby formatowania komunikatów dziennika org.eclipse.hyades.logging.cbe.CommonBaseEvent i org.log4j.spi.LoggingEvent w języku XML. Formater org.eclipse.hyades.logging.log4j.XmlLayout przekształca komunikat dziennika org.eclipse.hyades.logging.cbe.CommonBaseEvent lub org.apache.log4h.spi.LoggingEvent na format XML zgodnie ze schematem modelu Common Base Event w wersji 1.0.1. Podczas formatowania wykonywane jest sprawdzenie, czy właściwość komunikatu dziennika org.apache.log4j.spi.LoggingEvent implementuje interfejs org.eclipse.hyades.logging.core.IExternalizableToXml (np. org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Jeśli tak, to zamiast serializacji do formatu XML wywoływana jest metoda API externalizeCanonicalXmlString(). W przeciwnym razie komunikat dziennika org.apache.log4j.spi.LogginEvent jest przekształcany w obiekt modelu Common Base Event przy użyciu metod org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent() i serializowany do formatu XML przez wywołanie metody API externalizeCanonicalXmlString().
Rozszerzenie klasy abstrakcyjnej org.apache.log4j.AppenderSkeleton w pakiecie org.eclipse.hyades.logging.log4j umożliwia konfigurowanie programów rejestrujących na potrzeby rejestrowania komunikatów dziennika org.eclipse.hyades.logging.events.cbe.CommonBaseEvent i org.apache.log4j.spi.LoggingEvent w agencie rejestrowania.
Program dołączający klasy org.eclipse.hyades.logging.log4j.LoggingAgentAppender sprawdza, czy komunikat dziennika org.eclipse.hyades.logging.events.cbe.CommonBaseEvent lub org.apache.log4j.spi.LoggingEvent rejestrowany w programie rejestrującym może zostać zarejestrowany z uwzględnieniem filtru i poziomu rejestrowania programu rejestrującego oraz programu dołączającego. Jeśli komunikat dziennika ma zostać zarejestrowany, tworzony jest agent rejestrowania o takiej samej nazwie, jak program rejestrujący dany komunikat. W przeciwnym razie można użyć programu dołączającego org.eclipse.hyades.logging.log4j.SingleLoggingAgentAppender, który tworzy pojedynczego agenta rejestrowania o nazwie Program dołączający agenta rejestrowania. Komunikat jest formatowany w języku XML przy użyciu formatera org.eclipse.hyades.logging.log4j.XmlLayout i zapisywany w agencie rejestrowania.
Przykład
W podanym przykładzie pokazano, jak można wykorzystać obsługę rejestrowania Apache Jakarta Log4J. W tym celu opisano konfigurację i instrumentację wymagane w przypadku nowych i już istniejących użytkowników funkcji obsługi rejestrowania Apache Jakarta Log4J (w postaci autonomicznej i w postaci wtyczki). Aby uzyskać więcej informacji, kliknij opcję Plik> Nowy > Przykład... > Przykład rejestrowania Apache Log4J.
Przykład
W podanym przykładzie pokazano, jak można wykorzystać obsługę modelu EMF Common Base Event poprzez tworzenie i konfigurowanie takich zdarzeń za pomocą fabryki zdarzeń w postaci pliku szablonowego XML dla zdarzeń Common Base Event. Aby uzyskać więcej informacji, kliknij opcję Plik> Nowy > Przykład... > Przykład rejestrowania EMF Common Base Event v1.0.1.
Pojęcia pokrewne
Model Common Base Event
(C) Copyright IBM Corporation 2000, 2006. Wszelkie prawa zastrzeżone.