L'analizzatore di log e di traccia fornisce supporto autonomo e plugin per le seguenti utilità di registrazione di log:
Tale supporto richiede:
Tale supporto è fornito dai seguenti plugin:
Utilità di registrazione di log |
Plugin |
---|---|
Registrazione di log di Java (JSR-047) |
org.eclipse.hyades.logging.java14 |
Registrazione di log di Apache Jakarta Commons |
org.eclipse.hyades.logging.commons |
Registrazione di log di Apache Jakarta Log4J |
org.eclipse.hyades.logging.log4j |
Nelle seguenti sezioni vengono descritti i dettagli di ogni tipo di supporto di utilità di registrazione di log e vengono indicati i collegamenti a esempi che ne dimostrano il modo di utilizzo..
Un'estensione della classe java.util.logging.LogRecord del pacchetto org.eclipse.hyades.logging.java14 consente di creare un record di log personalizzato per la registrazione di log di un org.eclipse.hyades.logging.events.cbe.CommonBaseEvent in un java.util.logging.LogRecord. Tale org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord estende java.util.logging.LogRecord e contiene un riferimento a un org.eclipse.hyades.logging.events.cbe.CommonBaseEvent. Tutte le proprietà di java.util.logging.LogRecord vengono mappate su una o più proprietà di Common Base Event per conservare la proprietà riflessiva per i gestori informati e programmi di formattazione non Common Base Event.
Un'implementazione dell'interfaccia di java.util.logging.Filter del pacchetto org.eclipse.hyades.logging.java14 consente la registrazione con successo solo di org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord.
Un'estensione della classe astratta java.util.logging.Formatter del pacchetto org.eclipse.hyades.logging.java14 consente di configurare i gestori per formattare i messaggi di log org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord e java.util.logging.LogRecord a XML. Tale programma di formattazione org.eclipse.hyades.logging.java14.XmlFormatter converte il messaggio di log org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord o java.util.logging.LogRecord a XML basato sullo schema di Common Base Event v1.0.1. Durante la formattazione, il messaggio di log viene controllato per vedere se implementa l'interfaccia org.eclipse.hyades.logging.core.IExternalizableToXml (ad esempio org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord). In caso positivo, viene chiamata l'API externalizeCanonicalXmlString() API al posto della serializzazione XML serialization. Altrimenti, il messaggio di log java.util.logging.LogRecord viene convertito in un oggetto Common Base Event utilizzando la stessa mappatura di org.eclipse.hyades.logging.events.cbe.CommonBaseEvent e serializzato a XML tramite la chiamata all'API externalizeCanonicalXmlString().
Un'estensione della classe astratta java.util.logging.Handler
del pacchetto org.eclipse.hyades.logging.java consente ai programmi di registrazione di log di essere configurati per effettuare la registrazione di log dei messaggi di log
org.eclipse.hyades.logging.events.cbe.CommonBaseEvent e
java.util.logging.LogRecord in un agente di registrazione di log.
Questo gestore org.eclipse.hyades.logging.java.LoggingAgentHandler effettua un controllo per vedere se il messaggio di log org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord o java.util.logging.LogRecord registrato in un programma di registrazione log può essere registrato in base al filtro e al livello di registrazione di log di tale programma e del gestore. Se è necessario registrare il messaggio di log, viene definito un agente di registrazione di log con lo stesso nome del programma di registrazione di log che registra il messaggio. Altrimenti, è possibile utilizzare il gestore org.eclipse.hyades.logging.java.SingleLoggingAgentHandler, il quale crea un agente di registrazione di log denominato Logging Agent Handler. Il messaggio viene formattato in XML utilizzando org.eclipse.hyades.logging.java.XmlFormatter e scritto nell'agente di registrazione di log.
Esempio di illustrazione
Questo esempio viene fornito per mostrare in che modo azionare il supporto per registrazione di log di Java (JSR-047) illustrando la configurazione e la strumentazione necessaria per gli utenti nuovi ed esistenti del supporto autonomo e plugin per registrazione di log di Java (JSR-047). Per ulteriori informazioni, aprire File > Nuovo > Esempio... > Registrazione Hyades > Esempio di registrazione Hyades JSR-047.
Un'implementazione dell'interfaccia org.apache.commons.logging.Log del pacchetto org.eclipse.hyades.logging.commons consente di creare un programma di registrazione log per registrare i messaggi di log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object e java.lang.Throwable. Tale org.eclipse.hyades.logging.commons.Logger effettua un controllo per vedere se il messaggio di log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object o java.lang.Throwable registrato in un programma di registrazione log può essere registrato in base al livello di registrazione di log di tale programma. Se il messaggio di log deve essere registrato, il messaggio di log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object o java.lang.Throwable viene formattato e registrato. Viene fornita un'implementazione della classe astratta org.apache.commons.logging.LogFactory che rappresenta un factory di proxy specifico per le istanze di org.eclipse.hyades.logging.commons.Logger. Questo factory di proxy org.eclipse.hyades.logging.commons.LoggerFactory è inteso per l'utilizzo in ambienti multipli di caricatore di classe, dove uno o più tipi diversi di programmi di registrazione log e i rispettivi factory vengono richiesti per ogni caricatore di classe, utilizzando tutti gli stessi valori binari di Apache Commons.
Il org.eclipse.hyades.logging.commons.Logger converte i messaggi di log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object e java.lang.Throwable a XML basato sullo schema di Common Base Event v1.0.1. Durante la formattazione, il messaggio di log viene controllato per vedere se implementa l'interfaccia org.eclipse.hyades.logging.core.IExternalizableToXml (ad esempio, org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). In caso positivo, viene chiamata l'API externalizeCanonicalXmlString() API al posto della serializzazione XML. Altrimenti, il messaggio di log java.lang.Object or java.lang.Throwable viene convertito in un oggetto Common Base Event utilizzando org.eclipse.hyades.internal.logging.core.XmlGenerator e serializzato a XML tramite la chiamata all'API externalizeCanonicalXmlString().
Il org.eclipse.hyades.logging.commons.Logger registra i messaggi di log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object e java.lang.Throwable in un agente di registrazione log. Se è necessario registrare il messaggio di log, viene definito un agente di registrazione di log con lo stesso nome del programma di registrazione di log che registra il messaggio. Il messaggio viene formattato a XML e scritto nell'agente di registrazione di log.
Un'implementazione dell'interfaccia org.apache.commons.logging.Log del pacchetto org.eclipse.hyades.logging.commons consente di creare un programma di registrazione log per registrare i messaggi di log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object e java.lang.Throwable in un file locale. Tale org.eclipse.hyades.logging.commons.FileLogger effettua un controllo per vedere se il messaggio di log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object o java.lang.Throwable registrato in un programma di registrazione log può essere registrato in base al livello di registrazione di log di tale programma. Se il messaggio di log deve essere registrato, il messaggio di log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object o java.lang.Throwable viene formattato a XML e registrato in un file locale. Viene fornita un'implementazione della classe astratta org.apache.commons.logging.LogFactory che rappresenta un factory di proxy specifico per le istanze di org.eclipse.hyades.logging.commons.FileLogger. Questo factory di proxy org.eclipse.hyades.logging.commons.FileLoggerFactory è inteso per l'utilizzo in ambienti multipli di caricatore di classe, dove uno o più tipi diversi di programmi di registrazione log e i rispettivi factory vengono richiesti per ogni caricatore di classe distinto, utilizzando tutti gli stessi valori binari di Apache Commons.
Esempio di illustrazione
Questo esempio viene fornito per mostrare in che modo azionare il supporto per Apache Jakarta Commons Logging illustrando la configurazione e la strumentazione necessaria per gli utenti nuovi ed esistenti del supporto autonomo e plugin per Apache Jakarta Commons Logging. Per ulteriori informazioni, aprire File > Nuovo > Esempio... > Registrazione Hyades > Esempi di log comuni di Hyades Apache.
La proprietà di messaggio del messaggio di log org.apache.log4j.spi.LoggingEvent consente di registrare un org.eclipse.hyades.logging.events.cbe.CommonBaseEvent.
Un'estensione della classe astrattaorg.apache.log4j.spi.Filter del pacchetto org.eclipse.hyades.logging.log4j consente la registrazione con successo solo di org.eclipse.hyades.logging.events.cbe.CommonBaseEvent.
Un'estensione della classe astratta org.apache.log4j.Layout del pacchetto org.eclipse.hyades.logging.log4j consente di configurare gli appender per formattare i messaggi di log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent e org.apache.log4j.spi.LoggingEvent a XML. Tale programma di formattazione org.eclipse.hyades.logging.log4j.XmlLayout converte il messaggio di log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent o org.apache.log4j.spi.LoggingEvent a XML basato sullo schema di Common Base Event v1.0.1. Durante la formattazione, il messaggio di log viene controllato per verificare se la proprietà del messaggio di org.apache.log4j.spi.LoggingEvent implementa l'interfaccia org.eclipse.hyades.logging.core.IExternalizableToXml interface (ad esempio, org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). In caso positivo, viene chiamata l'API externalizeCanonicalXmlString() API al posto della serializzazione XML. Altrimenti, il messaggio di log org.apache.log4j.spi.LoggingEvent viene convertito in un oggetto Common Base Event utilizzando org.eclipse.hyades.internal.logging.core.XmlGenerator e serializzato a XML tramite la chiamata all'API externalizeCanonicalXmlString().
Un'estensione della classe astratta org.apache.log4j.AppenderSkeleton
del pacchetto org.eclipse.hyades.logging.log4j consente ai programmi di registrazione log di essere configurati per registrare i messaggi di log
org.eclipse.hyades.logging.events.cbe.CommonBaseEvent e
org.apache.log4j.spi.LoggingEvent in un agente di registrazione di log.
Questo appender org.eclipse.hyades.logging.log4j.LoggingAgentAppender effettua un controllo per verificare se il messaggio di log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent e org.apache.log4j.spi.LoggingEvent registrato in un programma di registrazione log può essere registrato in base al filtro e al livello di registrazione di log di tale programma e dell'appender. Se è necessario registrare il messaggio di log, viene definito un agente di registrazione di log con lo stesso nome del programma di registrazione log che registra il messaggio. Altrimenti, è possibile utilizzare l'appender org.eclipse.hyades.logging.log4j.SingleLoggingAgentAppender il quale crea un agente di registrazione di log denominato Logging Agent Appender. Il messaggio viene formattato a XML utilizzando org.eclipse.hyades.logging.log4j.XmlLayout e scritto nell'agente di registrazione di log.
Esempio di illustrazione
Questo esempio viene fornito per mostrare in che modo azionare il supporto per Apache Jakarta Log4J Logging illustrando la configurazione e la strumentazione necessaria per gli utenti nuovi ed esistenti del supporto autonomo e plugin per Apache Jakarta Log4J Logging. Per ulteriori informazioni, aprire File > Nuovo > Esempio... > Registrazione Hyades > Esempio di registrazione Hyades Apache Log4J.
Argomenti correlati
Modello eventi di base comuni
(C) Copyright IBM Corporation 2000, 2005. Tutti i diritti riservati.