Creación de paquetes de recursos JRas y archivos de mensajes

El registrador de mensajes de WebSphere Application Server proporciona los métodos message y msg para que el usuario pueda anotar los mensajes localizados. Además, el registrador de mensajes proporciona el método textMessage para anotar mensajes no localizados. Las aplicaciones pueden utilizar uno de los dos métodos o ambos, según proceda.

Antes de empezar

La infraestructura JRas que se describe en esta tarea y sus subtareas ha caído en desuso. No obstante, puede conseguir resultados parecidos utilizando el registro cronológico de Java™.

Acerca de esta tarea

El mecanismo para proporcionar mensajes localizados es el soporte de paquete de recursos que proporciona IBM® Developer Kit, Java Technology Edition. Si no está familiarizado con los paquetes de recursos que implementa el Developer Kit, puede obtener más información de diferentes textos o consultando la documentación del API de las clases java.util.ResourceBundle, java.util.ListResourceBundle y java.util.PropertyResourceBundle, así como de la clase java.text.MessageFormat.

La clase PropertyResourceBundle es el mecanismo preferible. Además, tenga en cuenta que las extensiones JRas no soportan las opciones de formato ampliado como, por ejemplo, {1, fecha} o {0, número, entero} que proporciona la clase MessageFormat.

Se pueden enviar mensajes escritos en registros cronológicos internos de WebSphere Application Server a otro proceso para su visualización. Por ejemplo, los mensajes mostrados en la consola administrativa, que se pueden ejecutar en una ubicación distinta a la del proceso del servidor, se pueden localizar mediante el proceso enlace a posteriori. Enlace a posteriori significa que WebSphere Application Server no localiza los mensajes cuando se registran, sino que aplaza la localización al proceso que muestra el mensaje.

Para localizar correctamente un mensaje, el proceso de visualización debe tener acceso al paquete de recursos donde esté almacenado el texto del mensaje. Hay que empaquetar el paquete de recursos aparte de la aplicación e instalarlo en una ubicación donde el proceso de visualización pueda acceder a él. Si no desea seguir estos pasos, puede utilizar la técnica de enlace anticipado para localizar los mensajes según se anotan.

Las dos técnicas se describen a continuación:
Enlace anticipado
La aplicación tiene que localizar el mensaje antes de anotarlo. La aplicación busca el texto localizado en el paquete de recursos y da formato al mensaje. Cuando se completa el formato, la aplicación anota el mensaje utilizando el método textMessage. Esta técnica se usa para empaquetar los paquetes de recursos de aplicaciones con la aplicación.
Enlace a posteriori
La aplicación puede optar por dejar que el entorno de ejecución de WebSphere Application Server localice el mensaje en el proceso donde se visualiza. Con esta técnica, los paquetes de recursos se empaquetan en archivos .jar autónomos al margen de la aplicación. Luego hay que instalar el archivo .jar del paquete de recursos en todas las máquinas de la instalación en las que se pueda ejecutar una consola administrativa o un programa de visualización de anotaciones cronológicas. Hay que instalar el archivo .jar en un directorio que forme parte de la ruta de clases de las extensiones. Además, si envia anotaciones al servicio de IBM, también tendrá que enviar el archivo .jar que contenga los paquetes de recursos.

Para crear un paquete de recursos, siga los pasos siguientes.

Procedimiento

  1. Cree un paquete de propiedades de texto que liste las claves de los mensajes y sus correspondientes mensajes. El archivo de propiedades debe tener las características siguientes:
    • Cada propiedad del archivo termina con un carácter de finalización de línea.
    • Si una línea solo contiene espacios en blanco, o si el primer carácter de espacio que no está en blanco es el signo de almohadilla (#) o el signo de admiración (!), se ignora dicha línea. Los caracteres # y ! pueden usarse, por tanto, para añadir comentarios al archivo.
    • A menos que sea un comentario o solo conste de espacios en blanco, cada línea del archivo denota una única propiedad. Una barra inclinada invertida (\) se trata como carácter de continuación de línea.
    • La sintaxis de un archivo de propiedades consta de una clave, un separador y un elemento. Los separadores válidos son el signo de igual (=), dos puntos (:) y el espacio en blanco ( ).
    • La clave consta de todos los caracteres de la línea, desde el primer carácter que no sea un espacio en blanco hasta el primer separador. Los caracteres separadores se pueden incluir en la clave escapándolos con una barra inclinada invertida (\), pero este enfoque no es recomendable, porque el escape de caracteres tiende a crear errores y confusión. En su lugar, utilice un carácter separador válido que no aparezca en ninguna clave del archivo de propiedades.
    • El espacio en blanco que aparece a continuación de la clave y el separador se ignoran hasta que se aparece el primer carácter de espacio que no esté en blanco. El resto de caracteres situados antes del carácter de fin de línea definen el elemento.

    Consulte la documentación Java relativa a la clase java.util.Properties para obtener una descripción completa de la sintaxis y la construcción de archivos de propiedades.

  2. Traduzca el archivo a las versiones localizadas del archivo con nombres de archivo específicos del idioma, por ejemplo, el archivo DefaultMessages.properties se traduce como DefaultMessages_de.properties para el alemán y DefaultMessages_ja.properties para el japonés.
  3. Cuando los paquetes de recursos traducidos estén disponibles, escríbalos en un soporte de almacenamiento persistente gestionado por el sistema. Los paquetes de recursos se utilizan para convertir los mensajes al idioma nacional y al entorno local solicitados.
  4. Cuando obtenga un registrador de mensajes del gestor de JRas, configúrelo para que utilice un paquete de recursos concreto. Los mensajes anotados mediante el API message utilizarán este paquete de recursos cuando se realice la localización del mensaje. En tiempo de ejecución, se usa el valor de la configuración regional del usuario para determinar el archivo de propiedades del cual se puede extraer el mensaje especificado por una clave de mensaje, asegurando así que el mensaje se muestre en el idioma correcto.
  5. Si se invoca el método msg del registrador de mensajes, identifique explícitamente un nombre de paquete de recursos.

Qué hacer a continuación

La aplicación localiza el paquete de recursos basándose en la ubicación del archivo relativa a un directorio de la ruta de clases. Por ejemplo, si el paquete de recursos de la propiedad DefaultMessages.properties está en el directorio baseDir/subDir1/subDir2/resources y baseDir aparece en la ruta de clases, se pasará el nombre subdir1.subdir2.resources.DefaultMessage al registrador de mensajes para identificar el paquete de recursos.

Icon that indicates the type of topic Task topic



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