O Analista de Registo e Rastreio fornece suporte autónomo e de plug-in para os seguintes utilitários de registo:
Este suporte implica:
Este suporte é fornecido pelos seguintes plug-ins:
Utilitário de Registo |
JARs de Plug-in |
---|---|
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 |
Eventos de Base Comum de EMF V1.0.1 |
org.eclipse.hyades.logging.core\hlcbe101.jar |
As secções seguintes descrevem os detalhes de cada tipo de suporte para utilitários de registo, e fornecem indicadores de exemplos que demonstram como utilizá-los.
Uma extensão da classe java.util.logging.LogRecord no pacote org.eclipse.hyades.logging.java14 permite ao utilizador criar uma entrada de registo personalizada para registar um org.eclipse.hyades.logging.events.cbe.CommonBaseEvent num java.util.logging.LogRecord. Este org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord expande o 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 se correlacionam com uma ou mais propriedades de Evento Base Comum para manter a reflexividade para operadores e formatadores que não suportam Eventos Base Comuns.
Uma implementação da interface java.util.logging.Filter sob o pacote org.eclipse.hyades.logging.java14 apenas permite que vários org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord sejam registados com sucesso.
Uma extensão da classe abstracta java.util.logging.Formatter sob o pacote org.eclipse.hyades.logging.java14 permite ao utilizador configurar operadores para formatar mensagens de registo 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 registo org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord ou java.util.logging.LogRecord para XML com base no esquema de Evento Base Comum v.1.0.1. Ao formatar, a mensagem de registo é verificada para ver se implementa a interface org.eclipse.hyades.logging.core.IExternalizableToXml interface (por exemplo, org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord). Se assim for, a API externalizeCanonicalXmlString() é chamada em vez da seriação de XML. Caso contrário, a mensagem de registo java.util.logging.LogRecord é convertida para um objecto de Evento Base Comum utilizando a mesma correlação que org.eclipse.hyades.logging.events.cbe.CommonBaseEvent e seriação para XML utilizando a API externalizeCanonicalXmlString().
Uma extensão da classe abstracta java.util.logging.Handler sob o pacote org.eclipse.hyades.logging.java permite a configuração dos registadores para registarem mensagens de registo org.eclipse.hyades.logging.events.cbe.CommonBaseEvent e java.util.logging.LogRecord num agente de registo.
Este operador org.eclipse.hyades.logging.java.LoggingAgentHandler verifica se a mensagem de erro org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord ou java.util.logging.LogRecord que é registada num registador pode ser registada com base no filtro e nível de registo do registador e do operador. Se a mensagem de registo vai ser registada, é processado um agente de registo com o mesmo nome do registador que regista a mensagem. Caso contrário, poderá utilizar o operador org.eclipse.hyades.logging.java.SingleLoggingAgentHandler, que cria um agente de registado chamado Operador do Agente de Registo. A mensagem é formatada como XML utilizando um org.eclipse.hyades.logging.java.XmlFormatter e é escrita no agente de registo.
Exemplo ilustrativo
É fornecido um exemplo para mostrar como pode equilibrar o suportar para JSR-047 Java Logging através da ilustração da configuração e instrumentação necessárias para utilizadores novos e existentes do suporte autónomo e de plug-in para JSR-047 Java Logging. Para mais informações, abra Ficheiro > Novo > Exemplo... > Exemplo de Registo JSR-047.
Uma implementação da interface org.apache.commons.logging.Log sob o pacote org.eclipse.hyades.logging.commons permite ao utilizador criar um registador para registar mensagens de registo 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 registo org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object ou java.lang.Throwable que é registada num registador pode ser registada com base no nível de registo do registador. Se a mensagem de registo vai ser registada, a mensagem de registo org.eclipse.hyades.logging.events.cbe.CommonBaseEvents, java.lang.Object ou java.lang.Throwable é formatada e registada. É fornecida uma implementação da classe abstracta org.apache.commons.logging.LogFactory que representa uma fábrica de proxys específica para ocorrências org.eclipse.hyades.logging.commons.Logger. Esta fábrica de proxys org.eclipse.hyades.logging.commons.LoggerFactory destina-se a ser utilizada em ambientes de carregadores de classes múltiplas onde um ou mais tipos diferentes de carregadores e as suas fábricas são necessários para cada carregador de classe em separado, utilizando todos os mesmos binários de Apache Commons.
O org.eclipse.hyades.logging.commons.Logger formata mensagens de registo org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object e java.lang.Throwable para XML com base no esquema de Evento Base Comum v1.0.1. Ao formatar, a mensagem de registo é verificada para ver se implementa a interface org.eclipse.hyades.logging.core.IExternalizableToXml (por exemplo, org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Se assim for, a API externalizeCanonicalXmlString() é chamada em vez da seriação de XML. Caso contrário, a mensagem de registo java.lang.Object ou java.lang.Throwable é convertida para um objecto de Evento Base Comum utilizando os métodos org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent() e seriação para XML chamando a API externalizeCanonicalXmlString().
O org.eclipse.hyades.logging.commons.Logger regista mensagens de registo org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object e java.lang.Throwable num agente de registo. Se a mensagem de registo vai ser registada, é processado um agente de registo com o mesmo nome do registador que regista a mensagem. A mensagem é formatada como XML e é escrita no agente de registo.
Uma implementação da interface org.apache.commons.logging.Log sob o pacote org.eclipse.hyades.logging.commons permite ao utilizador criar um registador para registar mensagens de registo org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object e java.lang.Throwable num ficheiro local. Este org.eclipse.hyades.logging.commons.FileLogger verifica se a mensagem de registo org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object ou java.lang.Throwable que é registada num registador pode ser registada com base no nível de registo do registador. Se a mensagem de registo vai ser registada, a mensagem de registo org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object ou java.lang.Throwable é formatada como XML e registada num ficheiro local. É fornecida uma implementação da classe abstracta org.apache.commons.logging.LogFactory que representa uma fábrica de proxys específica para ocorrências org.eclipse.hyades.logging.commons.FileLogger. Esta fábrica de proxys org.eclipse.hyades.logging.commons.FileLoggerFactory destina-se a ser utilizada em ambientes de carregadores de classes múltiplas onde um ou mais diferentes tipos de carregadores e as suas fábricas são necessários para cada carregador de classe em separado, utilizando todos os mesmos binários de Apache Commons.
Exemplo ilustrativo
É fornecido um exemplo para mostrar como equilibrar o suporte para Apache Jakarta Commons através da ilustração da configuração e instrumentação necessárias para utilizadores novos e existentes do suporte autónomo e de plug-in para Apache Jakarta Commons Logging. Para mais informações, consulte Ficheiro > Novo > Exemplo... > Exemplo de Apache Commons Logging.
A propriedade da mensagem de registo org.apache.log4j.spi.LoggingEvent permite ao utilizador registar um org.eclipse.hyades.logging.events.cbe.CommonBaseEvent.
Uma extensão da classe abstracta org.apache.log4j.spi.Filter sob o pacote org.eclipse.hyades.logging.log4j permite apenas que sejam registados vários org.eclipse.hyades.logging.events.cbe.CommonBaseEvent com sucesso.
Uma extensão da classe abstracta org.apache.log4j.Layout sob o pacote org.eclipse.hyades.logging.log4j permite ao utilizador configurar os anexadores para formatar mensagens de erro org.eclipse.hyades.logging.events.cbe.CommonBaseEvent e org.apache.log4j.spi.LoggingEvent como XML. Este formatador org.eclipse.hyades.logging.log4j.XmlLayout converte a mensagem de registo org.eclipse.hyades.logging.events.cbe.CommonBaseEvent ou org.apache.log4j.spi.LoggingEvent para XML com base no esquema de Evento Base Comum v1.0.1. Ao formatar, a mensagem de registo é verificada para ver se a propriedade da mensagem org.apache.log4j.spi.LoggingEvent implementa a interface org.eclipse.hyades.logging.core.IExternalizableToXml (por exemplo, org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Se assim for, a API externalizeCanonicalXmlString() é chamada em vez da seriação de XML. Caso contrário, a mensagem de registo org.apache.log4j.spi.LoggingEvent é convertida para um objecto de Evento Base Comum utilizando os métodos org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent() e a seriação para XML chamando a API externalizeCanonicalXmlString().
Uma extensão da classe abstracta org.apache.log4j.AppenderSkeleton sob o pacote org.eclipse.hyades.logging.log4j permite a configuração dos registadores para registar mensagens de registo org.eclipse.hyades.logging.events.cbe.CommonBaseEvent e org.apache.log4j.spi.LoggingEvent num agente de registo.
Este anexador org.eclipse.hyades.logging.log4j.LoggingAgentAppender verifica se a mensagem de registo org.eclipse.hyades.logging.events.cbe.CommonBaseEvent e org.apache.log4j.spi.LoggingEvent que é registada num registador pode ser registada com base no filtro e nível de registo do registador e do anexador. Se a mensagem de registo vai ser registada, é processado um agente de registo com o mesmo nome do registador que regista a mensagem. Caso contrário, poderá utilizar o anexador org.eclipse.hyades.logging.log4j.SingleLoggingAgentAppender que cria um agente de registo chamado Anexador de Agente de Registo. A mensagem é formatada como XML utilizando um org.eclipse.hyades.logging.log4j.XmlLayout e é escrita no agente de registo.
Exemplo ilustrativo
É fornecido um exemplo para mostrar como equilibrar o suporte para Apache Jakarta Log4J Logging através da ilustração da configuração e instrumentação necessárias para utilizadores novos e existentes do suporte autónomo e de plug-in para Apache Jakarta Log4J Logging. Para mais informações, consulte Ficheiro > Novo > Exemplo... > Exemplo de Apache Log4J Logging .
Exemplo ilustrativo
É fornecido um exemplo para mostrar como pode equilibrar o suportar para Eventos de Base Comum de EMF através da criação e configuração de Eventos de Base Comum utilizando o modelo de ficheiro Fornecedor de Eventos de Eventos de Base Comum de EMF. Para mais informações, consulte Ficheiro > Novo > Exemplo... > Exemplo de EMF Common Base Event v1.0.1.
Conceitos relacionados
Modelo de Evento Base Comum
(C) Copyright IBM Corporation 2000, 2006. Todos os Direitos Reservados.