O Log and Trace Analyzer fornece suporte independente e de plug-in para os seguintes utilitários de log:
Esse suporte vincula:
Esse suporte é fornecido pelos seguintes plug-ins:
Utilitário de Log |
Plug-in |
---|---|
Java Logging (JSR-047) |
org.eclipse.hyades.logging.java14 |
Apache Jakarta Commons Logging |
org.eclipse.hyades.logging.commons |
Apache Jakarta Log4J Logging |
org.eclipse.hyades.logging.log4j |
As seções a seguir descrevem os detalhes de cada tipo de suporte de utilitário de log, bem como fornece ponteiros para amostras que demonstram como utilizá-lo.
Uma extensão da classe java.util.logging.LogRecord no pacote org.eclipse.hyades.logging.java14 permite criar um registro de log customizado para registrar em log um org.eclipse.hyades.logging.events.cbe.CommonBaseEvent em um java.util.logging.LogRecord. Essa org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord estende java.util.logging.LogRecord e contém uma referência a org.eclipse.hyades.logging.events.cbe.CommonBaseEvent. Todas as propriedades de java.util.logging.LogRecord são mapeadas para uma ou mais propriedades do Common Base Event para manter a reflexividade para rotinas de tratamento e formatadores cientes que não pertencem ao Common Base Event.
Uma implementação da interface java.util.logging.Filter no pacote org.eclipse.hyades.logging.java14 permite que apenas org.eclipse.hyades.logging.java14.CommonBaseEventLogRecords sejam registrados em log com êxito.
Uma extensão da classe abstrata java.util.logging.Formatter no pacote org.eclipse.hyades.logging.java14 permite que você configure rotinas de tratamento para formatar mensagens de log org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord e java.util.logging.LogRecord em XML. Este formatador org.eclipse.hyades.logging.java14.XmlFormatter converte a mensagem de log org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord ou java.util.logging.LogRecord em XML com base no esquema Common Base Event v1.0.1. Durante a formatação, a mensagem de log é verificada para ver se ela implementa a interface org.eclipse.hyades.logging.core.IExternalizableToXml (por exemplo, org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord). Se implementar, a API externalizeCanonicalXmlString() será chamada no lugar da serialização de XML. Caso contrário, a mensagem de log java.util.logging.LogRecord é convertida em um objeto do Common Base Event que utiliza o mesmo mapeamento que no org.eclipse.hyades.logging.events.cbe.CommonBaseEvent e é serializada para XML chamando a API externalizeCanonicalXmlString().
Uma extensão da classe abstrata java.util.logging.Handler
no pacote org.eclipse.hyades.logging.java permite que os registradores sejam configurados para registrar mensagens de log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent e
java.util.logging.LogRecord em um agente de log.
Esta rotina de tratamento org.eclipse.hyades.logging.java.LoggingAgentHandler verifica se a mensagem de log org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord ou java.util.logging.LogRecord em um registrador pode ser registrada com base no filtro e no nível de log da rotina de tratamento e do registrador. Se a mensagem de log tiver que ser registrada, será criado um agente de log com o nome igual ao do registrador que registra a mensagem. Caso contrário, você poderá utilizar a rotina de tratamento org.eclipse.hyades.logging.java.SingleLoggingAgentHandler, que cria um agente de log, chamada Logging Agent Handler. A mensagem é formatada em XML utilizando uma org.eclipse.hyades.logging.java.XmlFormatter e gravada no agente de log.
Amostra Ilustrativa
É fornecida uma amostra para mostrar como alavancar o Java Logging (JSR-047) ilustrando a configuração e a instrumentação requeridas para usuários novos e existentes do suporte independente e de plug-in para Java Logging (JSR-047). Para obter mais informações, abra File > New > Example... > Hyades Logging > Hyades JSR-047 Logging Sample.
Uma implementação da interface org.apache.commons.logging.Log no pacote org.eclipse.hyades.logging.commons permite criar um registrador para mensagens de log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object e java.lang.Throwable. Este org.eclipse.hyades.logging.commons.Logger verifica se a mensagem de log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object ou java.lang.Throwable que está registrada em um registrador pode ser incluída com base no nível de log do registrador. Se a mensagem de log tiver que ser registrada, a mensagem de log org.eclipse.hyades.logging.events.cbe.CommonBaseEvents, java.lang.Object ou java.lang.Throwable será formatada e registrada. Uma implementação da classe abstrata org.apache.commons.logging.LogFactory é fornecida, representando um depósito de informações do provedor de proxy específico para instâncias org.eclipse.hyades.logging.commons.Logger. Este depósito de informações do provedor de proxy org.eclipse.hyades.logging.commons.LoggerFactory foi projetado para ser utilizado em vários ambientes do carregador de classes em que um ou mais tipos diferentes de registradores e seus depósitos de informações do provedor são requeridos para cada carregador de classes distinto, todos utilizando os mesmos binários Apache Commons.
O org.eclipse.hyades.logging.commons.Logger formata as mensagens de log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object e java.lang.Throwable em XML com base no esquema Common Base Event v1.0.1. Durante a formatação, a mensagem de log é verificada para ver se ela implementa a interface org.eclipse.hyades.logging.core.IExternalizableToXml (por exemplo, org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Se implementar, a API externalizeCanonicalXmlString() será chamada no lugar da serialização de XML. Caso contrário, a mensagem de log java.lang.Object ou java.lang.Throwable é convertida em um objeto do Common Base Event que utiliza o org.eclipse.hyades.internal.logging.core.XmlGenerator e é serializada para XML chamando a API externalizeCanonicalXmlString().
O org.eclipse.hyades.logging.commons.Logger registra as mensagens de log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object e java.lang.Throwable em um agente de log. Se a mensagem de log tiver que ser registrada, será criado um agente de log com o nome igual ao do registrador que registra a mensagem. A mensagem é formatada em XML e gravada no agente de log.
Uma implementação da interface org.apache.commons.logging.Log no pacote org.eclipse.hyades.logging.commons permite criar um registrador para registrar as mensagens de log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object e java.lang.Throwable em um arquivo local. Este org.eclipse.hyades.logging.commons.FileLogger verifica se a mensagem de log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object ou java.lang.Throwable que está registrada em um registrador pode ser incluída com base no nível de log do registrador. Se a mensagem de log tiver que ser registrada, a mensagem de log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object ou java.lang.Throwable será formatada em XML e registrada em um arquivo local. Uma implementação da classe abstrata org.apache.commons.logging.LogFactory é fornecida, representando um depósito de informações do provedor de proxy específico para instâncias org.eclipse.hyades.logging.commons.FileLogger. Este depósito de informações do provedor de proxy org.eclipse.hyades.logging.commons.FileLoggerFactoryfoi projetado para ser utilizado em vários ambientes do carregador de classes em que um ou mais tipos diferentes de registradores e seus depósitos de informações do provedor são requeridos para cada carregador de classes distinto, todos utilizando os mesmos binários Apache Commons.
Amostra Ilustrativa
É fornecida uma amostra para mostrar como alavancar o suporte para Apache Jakarta Commons Logging ilustrando a configuração e a instrumentação requeridas para usuários novos e existentes do suporte independente e de plug-in para Apache Jakarta Commons Logging. Para obter mais informações, consulte File > New > Example... > Hyades Logging > Hyades Apache Commons Logging Sample.
A propriedade de mensagem da mensagem de log org.apache.log4j.spi.LoggingEvent permite registrar um org.eclipse.hyades.logging.events.cbe.CommonBaseEvent.
Uma extensão da classe abstrata org.apache.log4j.spi.Filterno pacote org.eclipse.hyades.logging.log4j permite que apenas org.eclipse.hyades.logging.events.cbe.CommonBaseEvents sejam registrados com êxito.
Uma extensão da classe abstrata org.apache.log4j.Layout no pacote org.eclipse.hyades.logging.log4j permite que você configure anexadores para formatar mensagens de log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent e org.apache.log4j.spi.LoggingEventem XML. Este formatador org.eclipse.hyades.logging.log4j.XmlLayout converte a mensagem de log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent ou org.apache.log4j.spi.LoggingEventem XML com base no esquema Common Base Event v1.0.1. Durante a formatação, a mensagem de log é verificada para ver se a propriedade da mensagem do org.apache.log4j.spi.LoggingEvent implementa a interface org.eclipse.hyades.logging.core.IExternalizableToXml (por exemplo, org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Se implementar, a API externalizeCanonicalXmlString() será chamada no lugar da serialização de XML. Caso contrário, a mensagem de log org.apache.log4j.spi.LoggingEventé convertida em um objeto do Common Base Event que utiliza o org.eclipse.hyades.internal.logging.core.XmlGeneratore é serializada para XML chamando a API externalizeCanonicalXmlString().
Uma extensão da classe abstrata org.apache.log4j.AppenderSkeleton
no pacote org.eclipse.hyades.logging.log4j permite que registradores sejam configurados para registrar as mensagens de log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent e
org.apache.log4j.spi.LoggingEventem um agente de log.
Este anexador org.eclipse.hyades.logging.log4j.LoggingAgentAppender verifica se a mensagem de log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent e org.apache.log4j.spi.LoggingEvent que é registrada em um registrador pode ser incluída com base no nível de filtro e de log do anexador e do registrador. Se a mensagem de log tiver que ser registrada, será criado um Agente de Log com o nome igual ao do registrador que registra a mensagem. Caso contrário, você poderá utilizar o anexador org.eclipse.hyades.logging.log4j.SingleLoggingAgentAppender, que cria um agente de log, chamado Logging Agent Appender. A mensagem é formatada em XML utilizando uma org.eclipse.hyades.logging.log4j.XmlLayout e é gravada no agente de log.
Amostra Ilustrativa
É fornecida uma amostra para mostrar como alavancar o suporte para Apache Jakarta Log4J Logging ilustrando a configuração e a instrumentação requeridas para usuários novos e existentes do suporte independente e de plug-in para Apache Jakarta Log4J Logging. Para obter mais informações, consulte File > New > Example... > Hyades Logging > Hyades Apache Log4J Logging Sample.
Conceitos Relacionados
Modelo Common Base Event
(C) Copyright IBM Corporation 2000, 2005. Todos os Direitos Reservados.