Clases de extensión de JRas
WebSphere Application Server proporciona un conjunto de clases de implementación básico conocidas en conjunto como extensiones de JRas. Muchas de estas clases proporcionan las correspondientes implementaciones de registradores, manejadores y formateadores para utilizarlas en un entorno WebSphere Application Server.
La infraestructura JRas descrita en esta tarea y sus subtareas han caído en desuso. No obstante, puede conseguir resultados parecidos utilizando el registro cronológico de Java™.
El conjunto de clases de JRas está dirigido a una modalidad de operación integrada. Si opta por utilizar las extensiones de JRas en modo autónomo o combinado, puede reutilizar las clases de registrador y gestor proporcionadas por las extensiones, pero tendrá que proporcionar sus propias implementaciones de manejadores y formateadores.
Registradores de mensajes y rastreo de WebSphere Application Server
Los registradores de mensajes y de rastreo que proporciona el kit de herramientas de registro JRas autónomo no se puede utilizar directamente en el entorno de WebSphere Application Server. Las extensiones de JRas proporcionan las clases de implementación de registrador adecuadas. Se pueden obtener instancias de estas clases de registrador de mensajes y rastreo directa y exclusivamente de la clase Manager de WebSphere Application Server. Los registradores de rastreo y mensajes no se pueden instanciar directamente. Cualquier forma de obtener registradores que no sea directamente a partir de la clase Manager no está permitida y supone una infracción del modelo de programación.
Las instancias de registradores de mensajes y de rastreo obtenidas de la clase Manager de WebSphere Application Server son subclases de las clases RASMessageLogger y RASTraceLogger que proporciona el kit de herramientas de registro JRas autónomo. Las clases RASMessageLogger y RASTraceLogger definen el conjunto de métodos que están disponibles directamente a los usuarios. El código de usuario no puede invocar directamente los métodos públicos introducidos por las subclases de registrador de las extensiones de JRas, porque supondría una infracción del modelo de programación.
Los registradores son objetos con nombre, mediante el cual se identifican. Cuando se invoca la clase Manager para obtener un registrador, el invocador debe especificar el nombre de dicho registrador. La clase Manager mantiene una correlación nombre-instancia de registrador. Durante el tiempo de vida de un proceso, solo se crea una única instancia de un registrador con nombre. La primera llamada a la clase Manager con un determinado nombre resulta en el registrador, configurado por la clase Manager. La clase Manager guarda en caché una referencia a la instancia y luego la devuelve al invocador. Si en otras llamadas posteriores a la clase Manager se especifica el mismo nombre, se devolverá una referencia al registrador guardado en caché. Se mantienen espacios de nombres independientes para los registradores de mensajes y de rastreo. Esto significa que se puede utilizar un único nombre para obtener tanto un registrador de mensajes como un registrador de rastreo de la clase Manager, sin ambigüedades y sin crear un conflicto de espacio de nombres.
En general, los registradores no tienen una granularidad ni un ámbito predefinidos. Se puede utilizar un único registrador para instrumentalizar toda una aplicación. Podría llegar a la conclusión de que tener un registrador por clase es más efectivo, o que la granularidad adecuada se sitúa a medio camino. El desarrollador de aplicaciones es quien determina el particionado de una aplicación en dominios de registro.
Las clases de registrador de WebSphere Application Server obtenidas a partir de la clase Manager están preparadas para entornos multihilo. Aunque los registradores que se proporcionan como parte del kit de herramientas de registro JRas autónomo implementan la interfaz serializable, los registradores no se pueden serializar. Los registradores son objetos con estado, vinculados a una instancia de máquina virtual Java, y no se pueden serializar. Cualquier intento de serializar un registrador supone una infracción del modelo de programación.
Las subclases de registrador personales o individuales no están soportadas en un entorno de WebSphere Application Server.
Manejadores de WebSphere Application Server
WebSphere Application Server proporciona la clase de manejador adecuada que se utiliza para escribir sucesos de mensajes y de rastreo en los registros cronológicos del entorno de ejecución de WebSphere Application Server. No se puede configurar el manejador de WebSphere Application Server para escribir en ningún otro destino. La creación de un manejador de WebSphere Application Server es una operación restringida y no está disponible al código de usuario. Todo registrador obtenido de Manager está preconfigurado con una instancia de este manejador ya instalada. Se puede suprimir el manejador de WebSphere Application Server de un registrador cuando se desee ejecutar en modo autónomo. Una vez suprimido, el manejador de WebSphere Application Server no se podrá volver a añadir al registrador del que se ha suprimido ni a ningún otro registrador. Asimismo, no se puede llamar directamente ningún método del manejador de WebSphere Application Server. Si intenta crear una instancia del manejador de WebSphere Application Server, llamar a los métodos del manejador de WebSphere Application Server o añadir un método de WebSphere Application Server a un registrador mediante código de usuario cometerá una violación del modelo de programación.
Formateadores de WebSphere Application Server
El manejador de WebSphere Application Server está preconfigurado con el formateador adecuado para los datos que se escriben en las anotaciones cronológicas de WebSphere Application Server. La creación de un formateador de WebSphere Application Server es una operación restringida y no está disponible al código de usuario. No existe ningún mecanismo que permita al usuario obtener una referencia a un formateador instalado en un manejador de WebSphere Application Server ni cambiar el formateador que ha de utilizar un manejador de WebSphere Application Server conforme a su configuración.
Gestor de WebSphere Application Server
WebSphere Application Server proporciona una clase Manager (gestor) en el paquete com.ibm.websphere.ras. Todos los registradores de mensajes y rastreo se pueden obtener de esta clase Manager. Una referencia a la clase Manager se obtiene invocando el método estático Manager.getManager. Los registradores de mensajes se obtienen invocando el método createRASMessageLogger de la clase Manager. Los registradores de mensajes se obtienen invocando el método createRASTraceLogger() de la clase Manager.
La clase Manager también soporta una abstracción de grupo que resulta útil cuando se manejan registradores de rastreo. La abstracción de grupo soporta que varios registradores de rastreo no relacionados se registren como parte de una entidad con nombre llamada grupo. WebSphere Application Server proporciona los recursos de gestión de sistemas adecuados para manipular los valores de rastreo de un grupo, de forma similar a como funcionan los valores de rastreo de un registrador de rastreo individual.
Por ejemplo, suponga que el componente A consta de 10 clases. Suponga que cada clase está configurada para utilizar un registrador de rastreo independiente. Los diez registradores de rastreo del componente se han registrado como miembros del mismo grupo, por ejemplo, Component_A_Group. Se puede activar el rastreo para una clase individual o se puede activar el rastreo para las 10 clases en una única operación utilizando el nombre del grupo si se desea un rastreo de componentes. Los nombres de grupos se mantienen dentro del espacio de nombres de los registradores de rastreo.