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
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.
- 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 :