Comment internationaliser et localiser les applications Java

Comment fonctionne l’internationalisation Java

Le système i18n de Java repose sur deux éléments :

• .properties des fichiers qui stockent vos chaînes traduites
• La classe ResourceBundle qui charge le bon fichier à l’exécution en fonction des paramètres régionaux de l’utilisateur

Lorsque votre application s’exécute, ResourceBundle vérifie les paramètres régionaux de l’utilisateur et charge automatiquement le fichier correspondant. Si une traduction manque, il revient au fichier par défaut afin que rien ne se casse.

Appeler une chaîne dans le code est simple :

ResourceBundle bundle = ResourceBundle.getBundle("messages", Locale.FRENCH);
String greeting = bundle.getString("welcome.message");

ResourceBundle bundle = ResourceBundle.getBundle("messages", Locale.FRENCH);
String greeting = bundle.getString("welcome.message");

C’est tout le mécanisme. Le reste du travail de localisation se fait dans les fichiers .properties eux-mêmes, d’où l’importance de bien les structurer.

Configurer votre ResourceBundle

Un resource bundle est un ensemble de fichiers .properties qui partagent un même nom de base. Le nom de base correspond à la partie du nom de fichier avant le suffixe de paramètres régionaux, et c’est ce que ResourceBundle.getBundle() utilise pour trouver le bon fichier à l’exécution.

messages.properties # par défaut (généralement l’anglais)
messages_fr.properties # français
messages_de.properties # allemand
messages_es.properties # espagnol

messages.properties         # default (usually English)
messages_fr.properties      # French
messages_de.properties      # German
messages_es.properties      # Spanish

Ici, messages est le nom de base. Vous pouvez l’appeler comme vous le souhaitez, mais il doit refléter le contenu du fichier. Les applications plus importantes utilisent souvent plusieurs resource bundles pour rester organisées :

src/main/resources/
 messages.properties
 errors.properties
 emails.properties

src/main/resources/
  messages.properties
  errors.properties
  emails.properties

Java attend un modèle de nommage spécifique : basename_language.properties ou basename_language_COUNTRY.properties pour les variantes régionales.

messages_fr.properties # français
messages_fr_CA.properties # français (Canada)
messages_pt_BR.properties # portugais (Brésil)

messages_fr.properties       # French
messages_fr_CA.properties    # French (Canada)
messages_pt_BR.properties    # Portuguese (Brazil)

Les codes de langue suivent la norme ISO 639-1 et les codes de pays la norme ISO 3166-1. Si vous utilisez un format incorrect, ResourceBundle ne trouvera pas le fichier à l’exécution.

Structurer les fichiers .properties Java

Chaque ligne d’un fichier .properties est une paire clé-valeur séparée par =.

welcome.message = Bienvenue dans notre application
error.login.invalid_credentials = Nom d’utilisateur ou mot de passe invalide
form.submit.button = Envoyer

welcome.message = Welcome to our application
error.login.invalid_credentials = Invalid username or password
form.submit.button = Submit

Au-delà de l’utilisation de paires clé-valeur, il est important de savoir que la manière dont vous rédigez votre fichier source a un impact direct sur la qualité de vos traductions. Certaines bonnes pratiques s’appliquent toujours, que vous traduisiez manuellement ou que vous utilisiez un outil de traduction IA comme PTC.

Les clés doivent indiquer clairement où et comment une chaîne est utilisée. C’est essentiel lorsque vous gérez des centaines de chaînes réparties sur plusieurs fichiers.

Utilisation incorrecte des clés :

btn1 = Envoyer 
msg2 = Erreur

btn1 = Submit 
msg2 = Error

form.submit.button = Envoyer 
error.login.invalid_credentials = Nom d’utilisateur ou mot de passe invalide

form.submit.button = Submit 
error.login.invalid_credentials = Invalid username or password

Écrivez la phrase complète dans votre fichier .properties et utilisez des espaces réservés numérotés pour le contenu variable, plutôt que de concaténer des chaînes dans le code.

Incorrect (dans le code) :

"Bonjour, " + username + " ! Vous avez " + count + " nouveaux messages."  

"Hello, " + username + "! You have " + count + " new messages." 

dashboard.greeting = Bonjour, {0} ! Vous avez {1} nouveaux messages.

dashboard.greeting = Hello, {0}! You have {1} new messages.

De nombreuses langues modifient l’ordre des mots et les règles d’accord ; découper les phrases en fragments rend une traduction correcte impossible.

Certaines chaînes varient en fonction d’une valeur numérique. Au lieu d’écrire des clés séparées pour le singulier et le pluriel, utilisez directement un modèle ChoiceFormat dans votre fichier .properties :

messages.count = {0,choice,0#aucun message|1#un message|1<{0} messages}

messages.count = {0,choice,0#no messages|1#one message|1<{0} messages}

Java traite ce modèle à l’exécution et renvoie la forme appropriée en fonction de la valeur transmise.

Des caractères comme =, :, #, et \ ont une signification particulière dans les fichiers .properties :

• = ou : sépare les clés des valeurs
• # ou ! démarre un commentaire
• \ introduit des séquences d’échappement (comme \n pour un saut de ligne)

Si vous devez utiliser ces caractères dans une chaîne, échappez-les avec une barre oblique inverse.

support.link = Rendez-nous visite sur https\://support.example.com

support.link = Visit us at https\://support.example.com

Toujours enregistrer les fichiers .properties en UTF-8. Sans cela, les caractères non-ASCII sont corrompus et les traductions deviennent illisibles.

Si une chaîne est visible par les utilisateurs, elle doit se trouver dans un fichier .properties file. Les chaînes codées en dur ne seront pas traduites, et votre application finira par afficher un mélange de langues.

Autres considérations de localisation Java

Tout ce qui doit être localisé ne se trouve pas dans un fichier .properties. Les dates, heures, nombres et montants monétaires sont formatés dans le code à l’exécution, et il est tout aussi important de les gérer correctement que vos chaînes traduites.

Java fournit des classes intégrées pour cela :

• DateTimeFormatter pour le formatage des dates et heures selon les paramètres régionaux
• NumberFormat pour les nombres, pourcentages et montants monétaires

Étant donné que ce guide se concentre sur les fichiers .properties et leur traduction, nous ne les aborderons pas en profondeur ici. La documentation Java officielle pour DateTimeFormatter et NumberFormat est un bon point de départ.