Jakarta Commons Logging

Jakarta Commons Logging proporciona una interfaz de registro cronológico sencilla y envolturas ligeras para varios sistemas de registro cronológico. La interfaz de registro cronológico permite que el registro cronológico de aplicaciones sea sencillo e independiente del sistema de registro cronológico que utilice la aplicación. Se puede cambiar la implementación de registro cronológico de una aplicación desplegada sin tener que cambiar el código del registro cronológico de la aplicación. No obstante, la simplicidad de la interfaz de registro cronológico impide que la aplicación aproveche toda la funcionalidad de los sistemas de registro cronológico.

Para obtener información sobre Jakarta Commons Logging en WebSphere Application Server, consulte las secciones siguientes:

Soporte de Jakarta Commons Logging

El producto soporta Jakarta Commons Logging al proporcionar un registrador, una envoltura ligera para el recurso de registro cronológico de WebSphere Application Server. El registrador puede manejar objetos de registro cronológico de Java Logging (JSR-47) y de Common Base Event. Un objeto de registro cronológico es un objeto que contiene información de entradas de registro cronológico.

El soporte del producto de Jakarta Commons Logging no cambia las interfaces definidas por Jakarta Commons Logging.

Ventajas del soporte de Jakarta Commons Logging

El soporte de WebSphere Application Server de Jakarta Commons Logging ofrece las siguientes ventajas:

  • WebSphere Application Server está preconfigurado para utilizar Jakarta Commons Logging.

    Se proporciona toda la funcionalidad de Jakarta Commons Logging a cualquier aplicación o componente de WebSphere Application Server. Las llamadas de registro cronológico se direccionan de forma predeterminada al recurso de registro cronológico subyacente de WebSphere Application Server.

  • Un registrador cronológico que utiliza el recurso de registro cronológico de WebSphere Application Server.

    Las aplicaciones y los componentes pueden pasar objetos de registro cronológico de Java y de Common Base Event al registrador cronológico de WebSphere Application Server sin necesidad de convertirlos en cadenas, lo que ofrece a las aplicaciones un registro cronológico mejorado. Además, los niveles del registrador cronológico de Jakarta Commons Logging están integradas en los recursos administrativos de WebSphere Application Server.

Descripción general del proceso de uso de Jakarta Commons Logging

El registro cronológico en Jakarta Commons Logging consta de los siguientes pasos. Configuraciones del registrador de WebSphere Application Server proporciona detalles sobre la configuración de una aplicación para que use el registrador cronológico de WebSphere Application Server.

  1. Obtenga una instancia de una fábrica de registradores.

    Para obtener una fábrica de registradores, utilice el código de Jakarta Commons Logging. Puede configurar el código para que se adapte a sus necesidades. En WebSphere Application Server, Jakarta Commons Logging se configura de forma predeterminada para instanciar la fábrica de registradores predeterminada de Jakarta Commons Logging. Las aplicaciones o los componentes de WebSphere Application Server pueden proporcionar su propia configuración si utilizan una implementación de fábrica de registradores diferente. Las aplicaciones pueden utilizar más de una fábrica.

  2. Obtenga la instancia de un registrador.

    Para obtener un registrador cronológico, utilice el código implementado por una fábrica de registradores. La configuración del código es específica de la implementación.

    El registrador de WebSphere Application Server implementa los métodos definidos en la interfaz de registro cronológico. Los métodos de registro cronológico reciben al menos un argumento, que puede ser cualquier objeto Java. El registrador de WebSphere Application Server, el registrador WsJDK14Logger que se describe en Clases utilizadas para obtener una fábrica de registradores y un registrador, maneja los siguientes objetos que se pasan a los siguientes métodos de registro cronológico:

    CommonBaseEvent
    Envuelto en CommonBaseEventLogRecord
    CommonBaseEventLogRecord
    Se pasa sin cambios
    LogRecord
    Se pasa sin cambios
    Otros objetos
    Se pasan a String

    Las aplicaciones o los componentes de WebSphere Application Server pueden proporcionar su propia configuración si utilizan una implementación de un registrador que no sea específico de WebSphere Application Server. Una aplicación debe saber qué fábrica se está utilizando para poder configurarla.

  3. Inicie la aplicación. Jakarta Commons Logging direcciona la salida de registro cronológico de la aplicación al registrador designado.

Clases utilizadas para obtener una fábrica de registradores y un registrador

Tabla 1. Descripciones de las clases de Jakarta Commons Logging. Utilice las clases para obtener una instancia de fábrica de registradores y un registrador.
Nombre de clase Descripción
LogFactory LogFactory es una clase de Jakarta Commons Logging que implementa la lógica de inicialización. LogFactory es una clase abstracta que toda implementación de fábrica de registradores tiene que extender. Proporciona métodos estáticos para obtener:
  • Una instancia de una clase de fábrica
  • Instancias de un registrador, utilizando una instancia de la clase de fábrica
LogFactory proporciona métodos para obtener instancias de registradores, aunque dichos métodos delegan la instanciación y configuración de los registradores en una instancia de una clase de fábrica de registradores.

Las fábricas de registradores, una vez instanciadas, se almacenan en caché en función del cargador de clases del contexto. Las instancias en caché pueden publicarse. Esta funcionalidad está diseñada para implementaciones de contenedor de plataforma y no para aplicaciones.

LogFactoryImpl LogFactoryImpl es una clase concreta de Jakarta Commons Logging que implementa la fábrica de registradores predeterminada utilizando los métodos de LogFactory. Para utilizar el registro cronológico de Java, siempre debe existir al menos una instancia de una clase de fábrica de registradores, incluso si la aplicación no ha obtenido una explícitamente. Si la configuración no menciona una clase de fábrica de registradores, se utilizará LogFactoryImpl como valor predeterminado.
Registro Log es una interfaz de Jakarta Commons Logging para los registradores. Los registradores de Commons Logging tienen que implementar la interfaz Log. Como el objetivo de Jakarta Commons Logging es envolver todo sistema de registro cronológico, la interfaz Log define un pequeño conjunto de métodos de registro cronológico comunes. En WebSphere Application Server, WsJDK14Logger implementa la interfaz Log.

La instanciación y configuración de registradores cronológicos es específica de cada fábrica de registradores. El registro cronológico en WebSphere Application Server utiliza la fábrica de registradores predeterminada que se proporciona en Jakarta Commons Logging, que mantiene en caché los registradores instanciados en función del cargador de clases del contexto.

WsJDK14Logger WsJDK14Logger es una clase de WebSphere Application Server que proporciona un registrador de Jakarta Commons Logging mediante la implementación de la interfaz Log. El registrador WsJDK14Logger difiere del registrador de cronológico Java en que el registrador WsJDK14Logger habilita objetos de registro cronológico Java o de Common Base Event para que se puedan pasar sin convertirlos en objetos String. Esto impide las pérdidas de información que pueda provocar la conversión en String y permite además que la salida del registro cronológico sea más descriptiva y precisa. En cambio, el Logginglogger Java que se proporciona en Jakarta Commons Logging convierte los objetos pasados a las llamadas de registro en objetos String antes de pasarlos al registro Java subyacente.

Configuración y correlación de los niveles de registrador

Como los registradores de Jakarta Commons Logging son envolturas ligeras de sistemas de registro cronológico concretos, los registradores no tienen su propio nivel, sino que utilizan el nivel del registrador del sistema de registro cronológico subyacente. Aunque el sistema subyacente puede proporcionar métodos para cambiar el nivel, no existen métodos para cambiar el nivel definido en la interfaz Log que deben implementar todos los registradores de Jakarta Commons Logging. WsJDK14Logger utiliza el nivel de su registrador cronológico Java subyacente.

En la siguiente tabla se muestra la correlación de los niveles de Jakarta Commons Logging dentro de WsJDK14Logger con los niveles en la implementación de WebSphere Application Server del registro cronológico Java. La primera columna muestra los niveles definidos en el registro cronológico Java y la correlación de los niveles de JDK14Logger de Jakarta Commons Logging con los niveles del registro cronológico Java.

Tabla 2. Correlación de los niveles de WsJDK14Logger con los niveles de Java Logging. Compare los niveles de registro cronológico.
WsJDK14Logger Registro cronológico Java en WebSphere Application Server Registro cronológico Java JDK14Logger
Fatal Fatal    
Error Severe Severe Fatal, Error
Warning Warning Warning Warning
  Audit    
Info Info Info Info
  Config Config  
  Detail    
Debug Fine Fine Debug
  Finer Finer  
Trace Finest Finest Trace

El nivel de WsJDK14Logger se sincroniza con el nivel del registrador cronológico Java subyacente. La administración de WebSphere Application Server controla el nivel de WsJDK14Logger.


Icon that indicates the type of topic Concept topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ctrb_classload_jcl
File name: ctrb_classload_jcl.html