Création de regroupements de ressources JRas et de fichiers de messages

Le programme de consignation des messages de WebSphere Application Server fournit les méthodes message et msg afin que l'utilisateur puisse consigner les messages localisés. De plus, le programme de consignation des messages fournit la méthode textMessage pour consigner les messages qui ne sont pas localisés. Les applications peuvent utiliser l'une ou l'autre, ou les deux, selon ce qui est approprié.

Avant de commencer

L'utilisation de la structure JRas décrire dans cette tâche et ses sous-tâches est déconseillée. Toutefois, vous pouvez atteindre des résultats similaires à l'aide de la consignation Java™.

Pourquoi et quand exécuter cette tâche

Le mécanisme qui fournit des messages localisés est le support des regroupements de ressources, qui est disponible dans IBM® Developer Kit, Java Technology Edition. Si vous ne connaissez pas bien le concept de regroupement de ressources implémenté par le kit du développeur, vous pouvez obtenir plus d'informations dans différents documents ou en lisant la documentation API consacrée aux classes java.util.ResourceBundle, java.util.ListResourceBundle et java.util.PropertyResourceBundle classes, ainsi qu'à la classe java.text.MessageFormat.

La classe PropertyResourceBundle est le mécanisme recommandé. Par ailleurs, notez que les extensions JRas ne prennent pas en charge les options de formatage étendues comme {1, date} ou {0, number, integer}, qui sont fournies par la classe MessageFormat.

Vous pouvez transmettre des messages, qui sont enregistrés dans les journaux internes WebSphere Application Server, à d'autres processus en vue de les afficher. Par exemple, les messages qui s'affichent sur la console d'administration, laquelle peut s'exécuter dans un endroit différent de celui du processus de serveur, peuvent être localisés à l'aide du processus late binding. Cette attribution a posteriori signifie que WebSphere Application Server ne localise pas le message au moment de sa consignation, mais délègue cette localisation au processus qui affiche ce message.

Pour localiser le message correctement, le processus d'affichage doit avoir accès au regroupement de ressources dans lequel le texte du message est stocké. Vous devez assembler le regroupement de ressources séparément de l'application et l'installer à un emplacement auquel le processus d'affichage peut y accéder. Si vous ne souhaitez pas faire cela, vous pouvez utiliser la technique d'attribution a priori pour localiser les messages au fur et à mesure de leur consignation.

Les deux techniques sont décrites ci-après :
Attribution a priori
L'application doit localiser le message avant de le consigner. L'application recherche le texte localisé dans le regroupement de ressources et formate le message. Une fois le formatage terminé, l'application consigne le message à l'aide de la méthode textMessage. Utilisez cette technique pour conditionner les regroupements de ressources de l'application avec l'application.
Attribution a posteriori
L'application peut choisir de faire localiser le message par la phase d'exécution de WebSphere Application Server dans le processus dans lequel il est affiché. Avec cette technique, les regroupements de ressources sont conditionnés dans un fichier .jar autonome, séparément de l'application. Vous devez ensuite installer le fichier .jar de regroupement des ressources sur chaque ordinateur de l'installation à partir de laquelle une console d'administration ou un programme d'affichage des journaux peut être exécuté. Vous devez installer le fichier .jar dans le répertoire qui fait partie du chemin d'accès aux classes d'extensions. Par ailleurs, si vous transmettez les journaux au service IBM, vous devez également transmettre le fichier .jar qui contient les regroupements de ressources.

Pour créer un regroupement de ressources, procédez comme suit :

Procédure

  1. Créez un fichier de propriétés texte qui répertorie les clés de messages et les messages correspondants. Le fichier de propriétés doit présenter les caractéristiques suivantes :
    • Chaque propriété du fichier doit se terminer par un caractère de fin de ligne.
    • Si une ligne ne contient que des espaces ou si le premier caractère, hors espaces, sur une ligne est le symbole dièse (#) ou un point d'exclamation (!), cette ligne est ignorée. Les caractères # et ! peuvent donc être utilisés pour placer des commentaires dans le fichier.
    • Chaque ligne du fichier, sauf si elle contient des commentaires ou uniquement des espaces, représente une propriété et une seule. Une barre oblique inversée (\) est interprétée comme un caractère de continuation de ligne.
    • La syntaxe d'un fichier de propriétés se compose d'une clé, d'un séparateur et d'un élément. Les séparateurs admis sont le signe égal (=), les deux-points (:) et l'espace ( ).
    • La clé se compose de tous les caractères de la ligne à partir du premier caractère autre que l'espace jusqu'au premier séparateur. Il est possible d'inclure le caractère utilisé comme séparateur dans la clé en le faisant précéder d'une barre oblique inversée (\), mais cette pratique n'est pas recommandée car elle est source d'erreurs et de confusions. Il est préférable d'utiliser un séparateur valide, qui ne figure dans aucune des clés du fichier de propriétés.
    • Les espaces situés après la clé et le séparateur sont ignorés jusqu'au premier caractère autre que l'espace. Tous les caractères restants afin le caractère de fin de ligne définissent l'élément.

    Pour obtenir une description complète de la syntaxe et de la création des fichiers de propriétés, voir la documentation Java de la classe java.util.Properties.

  2. Le fichier peut ensuite être traduit en versions localisées du fichier avec des noms de fichier propres à la langue (par exemple, un fichier appelé DefaultMessages.properties peut être traduit en DefaultMessages_de.properties pour l'allemand et en DefaultMessages_ja.properties pour le japonais.
  3. Lorsque les regroupements de ressources traduits sont disponibles, enregistrez-les sur un support de stockage persistant géré par le système. Ils sont ensuite utilisés pour convertir les messages dans la langue nationale et pour l'environnement local demandés.
  4. Lorsqu'un programme de consignation des messages est obtenu du gestionnaire JRas, configurez-le de manière à utiliser un regroupement de ressources spécifique. Les messages consignés par le biais de l'API message utilisent ce regroupement de ressources lorsque la localisation des messages est effectuée. Lors de l'exécution, le paramètre d'environnement local de l'utilisateur est utilisé pour déterminer le fichier de propriétés à partir duquel le message identifié par une clé de message doit être extrait, ce qui garantit l'affichage du message dans la langue correcte.
  5. Si la méthode msg des programmes de consignation des messages est appelée, identifiez explicitement un nom de regroupement de ressources.

Que faire ensuite

L'application recherche le regroupement de ressources en fonction de l'emplacement du fichier relatif à un répertoire dans le chemin d'accès aux classes. Par exemple, si le regroupement de ressources de la propriété DefaultMessages.properties se trouve dans le répertoire baseDir/subDir1/subDir2/resources et que baseDir se trouve dans le chemin d'accès aux classes, le nom subdir1.subdir2.resources.DefaultMessage est transmis au programme de consignation des messages pour identifier le regroupement de ressources.

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ttrb_jrasmkrbs
Nom du fichier : ttrb_jrasmkrbs.html