Expert Ressource

Fonctionnalité de JBuilder Professionnel et Entreprise.

L'expert Ressource prépare votre application ou votre applet pour la traduction. Il place dans des ResourceBundles les chaînes codées en dur dans vos fichiers code source.

Les ResourceBundles sont des fichiers spécialisés qui contiennent un groupe de chaînes traduisibles. (Ils peuvent aussi contenir d'autres types de données bien que cela soit moins commun.) Une clé de ressource unique identifie chaque chaîne traduisible dans le ResourceBundle. Dans votre application, la chaîne codée en dur est remplacée par une référence au ResourceBundle et à la clé ressource. Cette séparation de la logique de l'application et des éléments traduisibles est appelée resourcing. Ces fichiers ressources séparés sont ensuite transmis aux traducteurs.

L'expert Ressource supporte les deux formes standard de ResourceBundles : les ListResourceBundle et les PropertyResourceBundle.

Les PropertyResourceBundles sont des fichiers texte ayant une extension .properties, ils sont placés au même endroit que les fichiers classe du code source. Les ListResourceBundles sont fournis sous la forme de fichiers source java. Etant donné qu'ils sont implémentés en tant que code source Java, les ListResourceBundles nouveaux et modifiés doivent être recompilés avant le déploiement. Avec les PropertyResourceBundles, il n'est pas nécessaire d'effectuer de recompilation lorsque des traductions sont modifiées ou ajoutées à l'application. Les ListResourceBundles procurent de meilleures performances que les PropertyResourceBundles.

Pour afficher cet expert,

  1. Dans le volet projet, sélectionnez le fichier classe .java à ressourcer.
  2. Choisissez Experts|Chaînes de ressource.

L'expert Ressource comprend deux étapes :

Etape 1

Utilisez cette page afin de spécifier le nom de votre ResourceBundle et si l'expert va créer les clés identifiant les chaînes basées sur des valeurs de chaîne ou sur les noms de composant et de propriété.

Nom de ResourceBundle

Indique le nom du ResourceBundle auquel vous voulez ajouter vos chaînes. Si un ResourceBundle existe déjà dans votre projet, l'expert le propose. Pour créer un nouveau ResourceBundle, choisissez Nouveau.

Nouveau

Ouvre la boîte de dialogue Création du ResourceBundle permettant de créer un nouveau bundle ressource. Vous utiliserez cette boîte de dialogue pour spécifier si le ResourceBundle est un ListResourceBundle ou un PropertyResourceBundle.

Créer des clés à partir de la valeur de la chaîne

Indique que l'expert ressource suggère une clé en fonction de la valeur de la chaîne codée en dur. Ainsi, si la chaîne est "Cliquez pour continuer", la clé suggérée sera "Cliquez_pour_continuer". La sélection de cette option a pour effet de désélectionner l'option Créer des clés à partir des noms de composant et de propriété.

Créer des clés à partir des noms de composant et de propriété

Spécifie que l'expert ressource suggère une clé en fonction du composant et de la propriété définis par la clé. En voici un exemple :

continueButton.setLabel("Cliquez pour continuer");

Dans cet exemple, la clé suggérée sera "continueButton.Label".

La sélection de cette option a pour effet de désélectionner l'option Créer des clés à partir de la valeur de chaîne.

Etape 2

Utilisez la deuxième page pour indiquer quelles chaînes, trouvées par l'expert Ressource dans votre code, vous voulez affecter en ressource.

L'expert Ressource énumère dans une table, qui contient ces colonnes nommées, toutes les chaînes qu'il trouve dans votre code.

Clé

Le nom donné par l'expert et qui identifie une chaîne particulière. Vous pouvez modifier ce nom si vous le souhaitez.

Valeur

La chaîne telle qu'elle apparaît dans votre code.

Il existe une case à cocher à gauche de chaque ligne de la table. Par défaut, elle sera cochée, ce qui signifie que la chaîne sera mise en ressource. Si vous ne le souhaitez pas, désélectionnez la case à cocher pour cette ligne.

Lorsque vous choisissez Terminer, l'expert crée un fichier ResourceBundle et l'ajoute à votre projet.