O Log and Trace Analyzer fornece suporte independente e de plug-in para os seguintes utilitários de log:
Este suporte engloba:
Esse suporte é fornecidos pelos seguintes plug-ins:
Utilitário de Log |
JARs de Plug-in |
---|---|
Log Java (JSR-047) |
org.eclipse.hyades.logging.core\hl14.jar |
Log Apache Jakarta Commons |
org.eclipse.hyades.logging.core\hlcommons.jar |
Log Apache Jakarta Log4J |
org.eclipse.hyades.logging.core\hllog4j.jar |
EMF Common Base Event V1.0.1 |
org.eclipse.hyades.logging.core\hlcbe101.jar |
As próximas seções descrevem os detalhes do suporte de cada tipo de utilitário de log e fornecem indicações para amostras que demonstram como utilizá-los.
Uma extensão da classe java.util.logging.LogRecord sob o pacote org.eclipse.hyades.logging.java14 permite criar um registro de log customizado para registrar um org.eclipse.hyades.logging.events.cbe.CommonBaseEvent em um java.util.logging.LogRecord. Esse org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord estende java.util.logging.LogRecord e contém uma referência a um org.eclipse.hyades.logging.events.cbe.CommonBaseEvent. Todas as propriedades de java.util.logging.LogRecord são mapeadas para uma ou mais propriedades de Common Base Event para manter a refletividade para rotinas de tratamento e formatadores que não reconhecem Common Base Events.
Uma implementação da interface java.util.logging.Filter sob o pacote org.eclipse.hyades.logging.java14 permite que somente org.eclipse.hyades.logging.java14.CommonBaseEventLogRecords sejam registrados em log com êxito.
Uma extensão da classe abstrata java.util.logging.Formatter sob o pacote org.eclipse.hyades.logging.java14 permite configurar rotinas de tratamento para formatar mensagens de log org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord e java.util.logging.LogRecord como XML. Esse 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. Ao formatar, 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() é chamada em lugar da serialização XML. Caso contrário, a mensagem de log java.util.logging.LogRecord é convertida em um objeto Common Base Event usando o mesmo mapeamento do 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
sob o 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.
Essa 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 que é registrada para um registrador pode ser registrada com base no filtro e nível de log do registrador e da rotina de tratamento. Se a mensagem de log dever ser registrada, um agente de log é resolvido com o mesmo nome do registrador que registra a mensagem. Caso contrário, pode-se usar a rotina de tratamento org.eclipse.hyades.logging.java.SingleLoggingAgentHandler, que cria um agente de log, denominado Rotina de Tratamento de Agente de Log. A mensagem é formatada em XML usando um org.eclipse.hyades.logging.java.XmlFormatter e gravada no agente de log.
Amostra Ilustrativa
Uma amostra é fornecida para mostrar como alavancar o suporte para Log Java JSR-047 ilustrando a configuração e instrumentação necessárias para usuários novos e existentes do suporte independente e de plug-in para Log Java JSR-047. Para obter informações adicionais, abra Arquivo > Novo > Exemplo... > Amostra de Registro JSR-047.
Uma implementação da interface org.apache.commons.logging.Log sob o pacote org.eclipse.hyades.logging.commons permite criar um registrador para registrar mensagens de log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object e java.lang.Throwable. Esse 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 é registrada em um registrador pode ser registrada com base no nível de log do registrador. Se a mensagem de log dever ser registrada, a mensagem de log org.eclipse.hyades.logging.events.cbe.CommonBaseEvents, java.lang.Object ou java.lang.Throwable é formatada e registrada. Uma implementação da classe abstrata org.apache.commons.logging.LogFactory é fornecida, a qual representa uma fábrica proxy específica para instâncias de org.eclipse.hyades.logging.commons.Logger. Essa fábrica proxy org.eclipse.hyades.logging.commons.LoggerFactory é destinada para utilização em ambientes de múltiplos carregadores de classes em que um ou mais tipos diferentes de registradores e suas fábricas são necessários para cada carregador de classes separado, todos utilizando os mesmos binários Apache Commons.
O org.eclipse.hyades.logging.commons.Logger formata mensagens de log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object e java.lang.Throwable como XML com base no esquema Common Base Event v1.0.1. Ao formatar, 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() é chamada em lugar da serialização XML. Caso contrário, a mensagem de log java.lang.Object ou java.lang.Throwable é convertida em um objeto Common Base Event usando os métodos org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent() e serializada para XML chamando a API externalizeCanonicalXmlString().
O org.eclipse.hyades.logging.commons.Logger registra 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 dever ser registrada, um agente de log é resolvido com o mesmo nome do registrador que registra a mensagem. A mensagem é formatada como XML e gravada no agente de log.
Uma implementação da interface org.apache.commons.logging.Log sob o pacote org.eclipse.hyades.logging.commons permite criar um registrador para registrar mensagens de log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object e java.lang.Throwable em um arquivo local. Esse 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 é registrada em um registrador pode ser registrada com base no nível de log do registrador. Se a mensagem de log for registrada, a mensagem de log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object ou java.lang.Throwable será formatada como XML e registrada em um arquivo local. Uma implementação da classe abstrata org.apache.commons.logging.LogFactory é fornecida, a qual representa uma fábrica proxy específica para instâncias de org.eclipse.hyades.logging.commons.FileLogger. Essa fábrica proxy org.eclipse.hyades.logging.commons.FileLoggerFactory é destinada para utilização em ambientes de múltiplos carregadores de classes em que um ou mais tipos diferentes de registradores e suas fábricas são necessários para cada carregador de classes separado, todos utilizando os mesmos binários Apache Commons.
Amostra Ilustrativa
Uma amostra é fornecida para mostrar como alavancar o suporte para Log Apache Jakarta Commons ilustrando a configuração e instrumentação necessárias para usuários novos e existentes do suporte independente e de plug-in para Log Apache Jakarta Commons. Para obter informações adicionais, consulte Arquivo > Novo > Exemplo... > Amostra de Registro de Apache Commons.
A propriedade 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.Filter sob o pacote org.eclipse.hyades.logging.log4j permite que somente org.eclipse.hyades.logging.events.cbe.CommonBaseEvents sejam registrados em log com êxito.
Uma extensão da classe abstrata org.apache.log4j.Layout sob o pacote org.eclipse.hyades.logging.log4j permite configurar anexadores para formatar mensagens de log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent e org.apache.log4j.spi.LoggingEvent como XML. Esse formatador org.eclipse.hyades.logging.log4j.XmlLayout converte a mensagem de log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent ou org.apache.log4j.spi.LoggingEvent em XML com base no esquema Common Base Event v1.0.1. Ao formatar, a mensagem de log é verificada para ver se a propriedade de 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() é chamada em lugar da serialização XML. Caso contrário, a mensagem de log org.apache.log4j.spi.LoggingEvent é convertida em um objeto Common Base Event usando os métodos org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent() e serializada para XML chamando a API externalizeCanonicalXmlString().
Uma extensão da classe abstrata org.apache.log4j.AppenderSkeleton
sob o pacote org.eclipse.hyades.logging.log4j permite que registradores
sejam configurados para registrar mensagens de log org.eclipse.hyades.logging.events.cbe.CommonBaseEvent
e org.apache.log4j.spi.LoggingEvent em um agente de log.
Esse 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 registrada com base no nível de filtro e de rastreio do registrador e do anexador. Se a mensagem de log dever ser registrada, um Agente de Log será resolvido com o mesmo nome do registrador que registra a mensagem. Caso contrário, pode-se usar o anexador org.eclipse.hyades.logging.log4j.SingleLoggingAgentAppender, que cria um agente de log, denominado Anexador de Agente de Log. A mensagem é formatada como XML usando um org.eclipse.hyades.logging.log4j.XmlLayout e gravada no agente de log.
Amostra Ilustrativa
Uma amostra é fornecida para mostrar como aprimorar o suporte para Registro do Apache Jakarta Log4J, ilustrando a configuração e instrumentação necessárias para usuários novos e existentes do suporte independente e de plug-in para Registro Apache Jakarta Log4J. Para obter informações adicionais, consulte Arquivo > Novo > Exemplo... > Amostra de Registro de Apache Log4J.
Amostra Ilustrativa
Uma amostra é fornecida para mostrar como aprimorar o suporte do EMF Common Base Events, criando e configurando o Common Base Events utilizando o modelo de arquivo XML Fábrica de Eventos de Common Base Event. Para obter informações adicionais, consulte Arquivo > Novo > Exemplo... > Amostra de EMF Common Base Event v1.0.1.
Conceitos Relacionados
Modelo Common Base Event
(C) Direitos Autorais IBM Corporation 2000, 2006. Todos os direitos reservados.