Infraestructura de JRas (en desuso)
Dado que las clases de las extensiones JRas no proporcionan la flexibilidad y el comportamiento necesarios para muchos escenarios, se han definido diversos puntos de extensión. Puede escribir sus propias clases de implementación para obtener el comportamiento necesario.
En desuso: la infraestructura de JRas descrita en este tema ha caído en desuso. No obstante, puede conseguir resultados parecidos utilizando el registro cronológico de Java™.
En general, las extensiones JRas requieren llamar la clase Manager para obtener un registrador de mensajes o de rastreo. No se facilita un mecanismo que le permita a usted proporcionar sus propias subclases de mensajes o de rastreo. En general, las extensiones proporcionadas por el usuario no pueden utilizarse para afectar el modo integrado de operación. El comportamiento del modo integrado de operación queda determinado exclusivamente por el entorno de ejecución de WebSphere Application Server y las clases de las extensiones JRas.
Manejadores
El kit de herramientas de registro JRas autónomo define la interfaz RASIHandler. Todos los manejadores deben implementar esta interfaz. Puede escribir sus propias clases de manejador que implementen la interfaz RASIHandler. Cree directamente instancias de manejadores definidos por el usuario y añádalas a los registradores obtenidos de la clase Manager.
El kit de herramientas de registro JRas autónomo proporciona varias clases de implementación de manejador. Dichas clases de manejador no son adecuadas para su uso en el entorno Java 2 Platform, Enterprise Edition (J2EE). No se pueden utilizar directamente, ni crear subclases, de cualquiera de las clases Handler que proporciona el kit de herramientas de registro JRas autónomo. Hacerlo supondría una infracción del modelo de programación.
Formateadores
El kit de herramientas de registro JRas autónomo define la interfaz RASIFormatter. Todos los formateadores deben implementar esta interfaz. Puede escribir sus propias clases de formateador que implementen la interfaz RASIFormatter. Dichas clases solo se pueden añadir a un manejador definido por el usuario. Los manejadores de WebSphere Application Server no se pueden configurar para utilizar formateadores definidos por el usuario. En lugar de ello, hay que crear directamente instancias de los formateadores y añadirlas a los manejadores según corresponda.
Al igual que con los manejadores, el kit de herramientas de registro JRas autónomo proporciona varias clases de implementación de formateador. El uso directo de dichas clases de formateador no está soportado.
Tipos de suceso de mensaje
El kit de herramientas JRas autónomo define tipos de suceso de mensaje en la interfaz RASIMessageEvent. Además, WebSphere Application Server reserva una rango de tipos de suceso de mensaje para su uso futuro. La interfaz RASIMessageEvent define tres tipos, con los valores 0x01, 0x02 y 0x04. Los valores de 0x08 a 0x8000 se reservan para el futuro. Puede proporcionar sus propios tipos de suceso de mensaje extendiendo esta interfaz según corresponda. Los tipos de mensaje definido por el usuario deben tener un valor 0x1000 o superior.
Los registradores de mensajes recuperados de la clase Manager tienen sus máscaras de mensajes establecidas a pass o procesan todos los tipos de suceso de mensaje definidos en la interfaz RASIMessageEvent. Para poder procesar los tipos de mensaje definidos por el usuario, hay que establecer manualmente la máscara del registrador de mensajes al estado que corresponda por código de usuario, una vez obtenido el registrador de mensajes de la clase Manager. WebSphere Application Server no proporciona ningún soporte de gestión de sistemas incorporado para gestionar los tipos de mensaje.
Objetos de suceso de mensajes
El kit de herramientas JRas autónomo proporciona una clase de implementación RASMessageEvent. Cuando se invoca un método de registro del registrador de mensajes y el tipo de mensaje está habilitado en ese momento, el registrador crea y distribuye un suceso de esta clase a todos los manejadores que estén registrados en ese momento en dicho registrador.
Puede proporcionar sus propias clases de suceso de mensajes, pero deben implementar la interfaz RASIEvent. Debe crear directamente instancias de dichas clases de suceso de mensaje definidas por el usuario. Una vez creado, pase el suceso de mensaje al registrador de mensajes invocando directamente el método fireRASEvent del registrador de mensajes. Los registradores de mensajes de WebSphere Application Server no pueden crear directamente instancias de tipos definidos por el usuario como respuesta a una llamada al método de registro (msg.message) en el registrador. Además, las instancias de tipos de mensaje definidos por el usuario no las procesa nunca el manejador de WebSphere Application Server. No se pueden crear directamente instancias de la clase RASMessageEvent.
Tipos de suceso de rastreo
El kit de herramientas JRas autónomo define tipos de suceso de rastreo en la interfaz RASITraceEvent. Puede proporcionar sus propios tipos de suceso de rastreo extendiendo esta interfaz según corresponda. En tal caso, deberá asegurarse de que los valores de los tipos de suceso de rastreo definidos por el usuario no entren en conflicto con los valores de los tipos definidos en la interfaz RASITraceEvent.
Los registradores de rastreo que se recuperan de la clase Manager suelen tener sus máscaras de rastreo definidas para rechazar todos los tipos. Se puede especificar un estado inicial diferente utilizando los recursos de gestión de sistemas de WebSphere Application Server. Además, se puede modificar el estado de la máscara de rastreo de un registrador en tiempo de ejecución mediante los recursos de gestión de sistemas de WebSphere Application Server.
Para procesar los tipos de rastreo definidos por el usuario, hay que establecer manualmente la máscara del registrador de rastreo al estado que corresponda por código de usuario. Los recursos de gestión de sistemas de WebSphere Application Server no se pueden utilizar para gestionar los tipos de rastreo definidos por el usuario, ni durante el inicio ni en tiempo de ejecución.
Objetos de suceso de rastreo
El kit de herramientas JRas autónomo proporciona una clase de implementación RASTraceEvent. Cuando se invoca un método de registro de rastreo en el registrador de rastreo de WebSphere Application Server y el tipo está habilitado en ese momento, el registrador crea y distribuye un suceso de esta clase a todos los manejadores que estén registrados actualmente en dicho registrador.
Puede proporcionar sus propias clases de suceso de rastreo. Dichas clases de suceso de rastreo deben implementar la interfaz RASIEvent. Las instancias de dichas clases de suceso definido por el usuario deben crearse directamente. Una vez creadas, pase el suceso de rastreo al registrador de rastreos invocando directamente el método fireRASEvent del registrador de rastreos. Los registradores de rastreo de WebSphere Application Server no pueden crear directamente instancias de tipos definidos por el usuario en respuesta a una llamada a un método de rastreo (entry, exit, trace) del registrador de rastreo. Además, las instancias de tipos de rastreo definidos por el usuario no las procesa nunca el manejador de WebSphere Application Server. No se pueden crear directamente instancias de la clase RASTraceEvent.
Tipos definidos por el usuario, sucesos definidos por el usuario y WebSphere Application Server
Por definición, el manejador de WebSphere Application Server procesa clases de tipos de rastreo o de mensajes definidas por el usuario, o clases de suceso de rastreo o de mensajes definidas por el usuario. Las entradas de mensaje o rastreo de una clase de suceso o tipo definidos por el usuario no se pueden escribir en los registros del entorno de ejecución de WebSphere Application Server.