Resumen del modelo de programación

El modelo de programación que se describe en esta sección se basa en y resume algunos de los conceptos ya tratados. Esta sección también expone los requisitos y restricciones de utilización. Está prohibido el uso de las extensiones JRas de WebSphere Application Server de un modo que no se ajuste a las directrices de programación siguientes.

Nota: 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™.
Las extensiones JRas de WebSphere Application Server se pueden utilizar en tres modos operativos distintos. Los conceptos y las limitaciones de los modelos de programación se aplican por igual en todos los modos operativos.
  • Las clases de implementación proporcionadas por el kit de herramientas de anotación JRas no se deben utilizar directamente a menos que se indique lo contrario. La utilización directa de dichas clases no está soportada. El servicio de soporte de IBM® no proporciona ayuda de diagnóstico ni correcciones de errores relativos al uso directo de las clases proporcionadas por el kit de herramientas de anotación JRas.
  • Los registradores de traza y mensaje deben obtenerse directamente de la clase Manager. Los registradores no pueden instanciarse directamente.
  • No se pueden sustituir las clases de registradores de rastreo y de mensajes de WebSphere Application Server.
  • Deberá asegurarse de que los nombres de registradores que se pasen a clase Manager sean exclusivos y de atenerse a las restricciones de nombrado documentadas. Cuando obtenga un registrador de la clase Manager, no intente cambiarle el nombre mediante una invocación al método setName.
  • Los registradores con nombre se pueden utilizar más de una vez. Para cualquier nombre, la primera llamada a la clase Manager da lugar a que dicha clase Manager cree un registrador asociado a dicho nombre. Las llamadas posteriores a Manager que especifiquen el mismo nombre darán lugar a la devolución de una referencia al registrador existente.
  • La clase Manager mantiene un espacio de nombres jerárquico para los registradores. Utilice un nombre de clase plenamente cualificado, separado por puntos, para identificar cualquier registrador. Aparte de los puntos, los nombres de registrador no pueden contener caracteres de puntuación como, por ejemplo, un asterisco (*), o una coma (,), un signo igual (=), dos puntos (:) o comillas.
  • Los nombres de grupos deben atenerse a las mismas restricciones de nombre que los nombres de registradores.
  • Los registradores devueltos por la clase Manager son subclases de las clases RASMessageLogger y RASTraceLogger, que las proporciona el kit de herramientas de registro JRas autónomo. Se puede invocar cualquier método público definido en las clases RASMessageLogger y RASTraceLogger. No se puede invocar ningún método público introducido por las subclases proporcionadas.
  • Si desea trabajar en modo autónomo o combinado, deberá proporcionar sus propias subclases Handler y Formatter. No se pueden usar las clases Handler y Formatter que proporciona el kit de herramientas JRas autónomo. Los manejadores (Handler) y formateadores (Formatter) deben atenerse a las directrices documentadas.
  • Los registradores obtenidos de la clase Manager se proporcionan con un manejador de WebSphere Application Server instalado. Este manejador escribe registros de mensajes y de rastreo en los archivos de anotaciones definidos por el entorno de ejecución de WebSphere Application Server. Dichos archivos de registro se gestionan a través de las interfaces de gestión de sistemas proporcionadas.
  • En cualquier momento se pueden añadir y eliminar de un registrador, de forma programática, manejadores definidos por el usuario. Se soportan múltiples adiciones y eliminaciones de manejadores definidos por el usuario. Será responsabilidad suya crear una instancia del manejador a añadir, configurar el manejador definiendo correctamente el valor de máscara del manejador y el formateador, y luego añadir el manejador al registrador utilizando el método addHandler. También será responsabilidad suya actualizar programáticamente las máscaras de los manejadores creados por el usuario, según corresponda.
  • Podría obtener una referencia al manejador instalado en un registrador invocando el método getHandlers del registrador y procesando los resultados. No debe invocar ningún método del manejador obtenido de este modo. Puede suprimir el manejador de WebSphere Application Server del registrador invocando el método removeHandler del registrador, pasándole la referencia al manejador de WebSphere Application Server. Una vez suprimido, el manejador de WebSphere Application Server no se podrá volver a añadir al registrador.
  • Puede definir su propio tipo de mensaje. El comportamiento de los tipos de mensajes definidos por el usuario y las limitaciones que afectan a sus definiciones se describen en Infraestructura JRas (en desuso).
  • Puede definir sus propias clases de sucesos de mensajes. El uso de las clases de sucesos de mensajes definidas por el usuario se describe en Infraestructura JRas (en desuso).
  • Puede definir sus propios tipos de rastreo. El comportamiento de los tipos de rastreos definidos por el usuario y las limitaciones que afectan a sus definiciones se describe en Infraestructura JRas (en desuso).
  • Puede definir sus propias clases de sucesos de rastreo. El uso de clases de sucesos de rastreo definidas por el usuario se trata en Infraestructura JRas (en desuso).
  • Debe mantener programáticamente los bits de las máscaras de anotador de mensajes y rastreo que correspondan a los tipos definidos por usuario. Si se utilizan los recursos de WebSphere Application Server para gestionar los tipos predefinidos, estas actualizaciones no deben modificar el estado de los bits que se corresponden con dichos tipos. Si asume la responsabilidad de propiedad de los tipos predefinidos, podrá cambiar todos los bits de las máscaras.

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_jrasprgsum
File name: ctrb_jrasprgsum.html