El analizador de anotaciones y rastreo proporciona soporte autónomo y de plug-in para los programas de utilidad de anotaciones siguientes:
Este soporte supone:
Proporcionan este soporte los plug-ins siguientes:
Programa de utilidad de anotaciones |
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 |
En los apartados siguientes se describe con detalle cada tipo de soporte de programa de utilidad de anotaciones, y se proporcionan punteros a ejemplos en los que se muestra cómo utilizarlos.
Una extensión de la clase java.util.logging.LogRecord en el paquete org.eclipse.hyades.logging.java14 le permite crear un registro de anotaciones personalizado para anotar un org.eclipse.hyades.logging.events.cbe.CommonBaseEvent en un java.util.logging.LogRecord. El org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord amplía java.util.logging.LogRecord y contiene una referencia para un org.eclipse.hyades.logging.events.cbe.CommonBaseEvent. Todas las propiedades java.util.logging.LogRecord se correlacionan con una o más propiedades de suceso base común para mantener la reflexibilidad para formateadores y manejadores que desconocen el suceso base común.
Una implementación de la interfaz java.util.logging.Filter en el paquete org.eclipse.hyades.logging.java14 sólo permite que se anoten org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord satisfactoriamente.
Una extensión de la clase abstracta java.util.logging.Formatter del paquete org.eclipse.hyades.logging.java14 le permite configurar manejadores para dar formato a mensajes de anotaciones org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord y java.util.logging.LogRecord para XML. Este formateador org.eclipse.hyades.logging.java14.XmlFormatter convierte el mensaje de anotaciones org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord o java.util.logging.LogRecord en XML en función del esquema de Common Base Event v1.0.1. Cuando se formatea, se comprueba si mensaje de anotaciones implementa la interfaz org.eclipse.hyades.logging.core.IExternalizableToXml (por ejemplo, org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord). Si la implementa, se llama a la API externalizeCanonicalXmlString() en lugar de la serialización de XML. De lo contrario, el mensaje de anotaciones java.util.logging.LogRecord se convierte en un objeto de suceso base común utilizando la misma correlación que en org.eclipse.hyades.logging.events.cbe.CommonBaseEvent y se serializa para XML llamando a la API externalizeCanonicalXmlString().
Una extensión de la clase abstracta
java.util.logging.Handler en el paquete org.eclipse.hyades.logging.java permite configurar
anotadores para anotar mensajes de anotaciones
org.eclipse.hyades.logging.events.cbe.CommonBaseEvent y
java.util.logging.LogRecord para un agente de anotaciones.
Este manejador org.eclipse.hyades.logging.java.LoggingAgentHandler comprueba si el mensaje de anotación org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord o java.util.logging.LogRecord que se anota a un anotador se puede anotar en función del nivel de filtro y anotación del manejador y anotador. Si el mensaje de anotaciones se va a anotar, se resuelve un agente de anotaciones con el mismo nombre que el anotador que anota el mensaje. De lo contrario, puede utilizar el manejador org.eclipse.hyades.logging.java.SingleLoggingAgentHandler, que crea un agente de anotaciones denominado Manejador de agentes de anotaciones. El mensaje se formatea a XML utilizando un org.eclipse.hyades.logging.java.XmlFormatter y se escribe en el agente de anotaciones.
Ejemplo ilustrativo
Se proporciona un ejemplo con el objeto de mostrar cómo aprovechar el soporte para Java Logging (JSR-047) en el que se ilustra la configuración y la instrumentación necesarias para usuarios nuevos y existentes del soporte autónomo y de plug-in para Java Logging (JSR-047). Para obtener más información, abra Archivo > Nuevo > Ejemplo... > Anotaciones de Hyades > Ejemplo de anotaciones Hyades JSR-047 Logging.
Una implementación de la interfaz org.apache.commons.logging.Log en el paquete org.eclipse.hyades.logging.commons le permite crear un anotador para anotar mensajes de anotaciones org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object y java.lang.Throwable. org.eclipse.hyades.logging.commons.Logger comprueba si el mensaje de anotaciones org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object o java.lang.Throwable que se ha anotado en un anotador se puede anotar en función del nivel de anotaciones del anotador. Si se va a anotar, el mensaje de anotaciones java.lang.Object o java.lang.Throwable de org.eclipse.hyades.logging.events.cbe.CommonBaseEvent se formatea y anota. Se proporciona una implementación de la clase abstracta org.apache.commons.logging.LogFactory que representa una fábrica de proxies específica para instancias org.eclipse.hyades.logging.commons.Logger. La finalidad de esta fábrica de proxies org.eclipse.hyades.logging.commons.LoggerFactory es su utilización en varios entornos de cargadores de clases en los que se necesitan uno o más tipos diferentes de cargadores y sus fábricas para cada cargador de clase separado, donde todos utilizan los mismos binarios Apache Commons.
org.eclipse.hyades.logging.commons.Logger formatea mensajes de anotaciones org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object y java.lang.Throwable para XML en función del esquema de Common Base Event v1.0.1. Cuando se formatea, se comprueba si el mensaje de anotaciones implementa la interfaz org.eclipse.hyades.logging.core.IExternalizableToXml (por ejemplo, org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Si la implementa, se llama a la API externalizeCanonicalXmlString() en lugar de la serialización de XML. De lo contrario, el mensaje de anotaciones java.lang.Object o java.lang.Throwable se convierte en un objeto de suceso base común utilizando org.eclipse.hyades.internal.logging.core.XmlGenerator y se serializa para XML llamando a la API externalizeCanonicalXmlString().
org.eclipse.hyades.logging.commons.Logger anota mensajes de anotaciones org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object y java.lang.Throwable en un agente de anotaciones. Si el mensaje de anotaciones se va a anotar, se resuelve un agente de anotaciones con el mismo nombre que el anotador que anota el mensaje. El mensaje se formatea para XML y se escribe en el agente de anotaciones.
Una implementación de la interfaz org.apache.commons.logging.Log del paquete org.eclipse.hyades.logging.commons le permite crear un anotador para anotar mensajes de anotaciones org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object y java.lang.Throwable en un archivo local. org.eclipse.hyades.logging.commons.FileLogger comprueba si el mensaje de anotaciones org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object o java.lang.Throwable que se ha anotado en un anotador se puede anotar en función del nivel de anotaciones del anotador. Si el mensaje de anotaciones se va a anotar, se da formato al mensaje de anotaciones org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object o java.lang.Throwable para XML y se anota en un archivo local. Se proporciona una implementación de la clase abstracta org.apache.commons.logging.LogFactory que representa una fábrica de proxies especifica para instancias de org.eclipse.hyades.logging.commons.FileLogger. la finalidad de esta fábrica de proxies org.eclipse.hyades.logging.commons.FileLoggerFactory es su utilización en varios entornos de cargadores de clase en los que se necesitan uno o más tipos de cargadores y sus fábrica para cada cargador de clase separado, donde todos utilizan los mismos binarios Apache Commons.
Ejemplo ilustrativo
Se proporciona un ejemplo con el objeto de mostrar cómo aprovechar el soporte para Apache Jakarta Commons Logging en el que se ilustra la configuración y la instrumentación necesarias para usuarios nuevos y existentes del soporte autónomo y de plug-in para Apache Jakarta Commons Logging. Para obtener más información, consulte Archivo > Nuevo > Ejemplo... > Anotaciones de Hyades > Ejemplo de anotaciones Hyades Apache Commons Logging.
La propiedad de mensaje del mensaje de anotaciones org.apache.log4j.spi.LoggingEvent le permite anotar un org.eclipse.hyades.logging.events.cbe.CommonBaseEvent.
Una extensión de la clase abstracta org.apache.log4j.spi.Filter del paquete org.eclipse.hyades.logging.log4j sólo permite anotar org.eclipse.hyades.logging.events.cbe.CommonBaseEvent satisfactoriamente.
Una extensión de la clase abstracta org.apache.log4j.Layout del paquete org.eclipse.hyades.logging.log4j le permite configurar agregadores para formatear mensajes de anotaciones org.eclipse.hyades.logging.events.cbe.CommonBaseEvent y org.apache.log4j.spi.LoggingEvent para XML. Este formateador org.eclipse.hyades.logging.log4j.XmlLayout convierte el mensaje de anotaciones org.eclipse.hyades.logging.events.cbe.CommonBaseEvent o org.apache.log4j.spi.LoggingEvent para XML en función del esquema de Common Base Event v1.0.1. Cuando se formatea, se comprueba si la propiedad de mensaje del mensaje de anotaciones de org.apache.log4j.spi.LoggingEvent implementa la interfaz org.eclipse.hyades.logging.core.IExternalizableToXml (por ejemplo, org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Si la implementa, se llama a la API externalizeCanonicalXmlString() en lugar de la serialización de XML. De lo contrario, el mensaje de anotaciones org.apache.log4j.spi.LoggingEvent se convierte en un objeto de suceso base común utilizando org.eclipse.hyades.internal.logging.core.XmlGenerator y se serializa para XML llamando a la API externalizeCanonicalXmlString().
Una extensión de la clase abstracta
org.apache.log4j.AppenderSkeleton del paquete
org.eclipse.hyades.logging.log4j permite configurar anotadores para anotar mensajes de anotaciones
org.eclipse.hyades.logging.events.cbe.CommonBaseEvent y
org.apache.log4j.spi.LoggingEvent en un agente de anotaciones.
El agregador org.eclipse.hyades.logging.log4j.LoggingAgentAppender comprueba si los mensajes de anotaciones org.eclipse.hyades.logging.events.cbe.CommonBaseEvent y org.apache.log4j.spi.LoggingEvent que se han anotado en un anotador se pueden anotar en función del nivel de filtrado y anotación del anotador y el agregador. Si el mensaje de anotaciones se va a anotar, se resuelve un agente de anotaciones con el mismo nombre que el anotador que anota el mensaje. De lo contrario, puede utilizar el agregador org.eclipse.hyades.logging.log4j.SingleLoggingAgentAppender, que crea un agente de anotaciones, denominado Agregador de agentes de anotaciones. El mensaje se formatea para XML utilizando un org.eclipse.hyades.logging.log4j.XmlLayout y se escribe en el agente de anotaciones.
Ejemplo ilustrativo
Se proporciona un ejemplo con el objeto de mostrar cómo aprovechar el soporte para Apache Jakarta Log4J Logging en el que se ilustra la configuración y la instrumentación necesarias para usuarios nuevos y existentes del soporte autónomo y de plug-in para Apache Jakarta Log4J Logging. Para obtener más información, consulte Archivo > Nuevo > Ejemplo... > Anotaciones de Hyades > Ejemplo de anotaciones Hyades Apache Log4J Logging.
Conceptos relacionados
Modelo de suceso base común
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.