précédent | suivant | table des matières

Internationalisation/Localisation

1 Définitions.

L'internationalisation d'un logiciel consiste à construire le logiciel avec une architecture qui permet d'adapter facilement  le logiciel à différentes langues ou pays. Il faut identifier dans le logiciel tout ce qui dépend d'un pays, ou d'un culture particulière :

• la langue
• la monnaie : 1234.56 s'écrit £1,234.56 au Royaume-Uni et 1234,56€ en France
• les dates : le lundi 26 juin 2006 s'écrit lundi 26 juin 2006 en France et Monday, june 26, 2006 au Canada anglais.
• les nombres : 1234.56 s'écrit 1,234.56 aux Etats-Unis et 1234,56 en France.
• les unités de mesure
• ...

La localisation d'un logiciel est l'opération qui consiste à ajouter au logiciel les ressources nécessaires à son adaptation à une langue et un pays donné. Le site de SUN

2 Locale.

La classe Locale permet d'identifier ou de modifier,  le pays et la langue utilisée par l'ordinateur sur lequel s'exécute l'application.

Constructeurs :

Locale(String langue) 

Locale(String langue, String pays)

Locale(String langue, String pays, String variant) 

Attributs de classe : la classe Locale contient les attributs suivants :

Locale FRANCE = new Locale("fr","FR",""); 
Locale GERMANY = new Locale("de","DE","");
Locale ITALY = new Locale("it","IT","");
Locale JAPAN = new Locale("ja","JP","");
Locale KOREA = new Locale("ko","KR","");
Locale CHINA = new Locale("zh","CN","");
Locale PRC = new Locale("zh","CN","");
Locale SIMPLIFIED_CHINESE = new Locale("zh","CN","");
Locale TRADITIONAL_CHINESE = new Locale("zh","TW","");
Locale TAIWAN = new Locale("zh","TW","");

Locale UK = new Locale("en","GB","");
Locale US = new Locale("en","US","");
Locale CANADA = new Locale("en","CA","");
Locale CANADA_FRENCH = new Locale("fr","CA","");
Locale ENGLISH = new Locale("en","","");
Locale FRENCH = new Locale("fr","","");
Locale GERMAN = new Locale("de","","");
Locale ITALIAN = new Locale("it","","");
Locale JAPANESE = new Locale("ja","","");
Locale KOREAN = new Locale("ko","","");
Locale CHINESE = newLocale("zh","","");

Méthodes de classe :

Locale[] getAvailableLocales()

Locale getDefault()

void setDefault(Locale l)

String[] getISOCountries()

String[] getISOLanguages()

Méthodes d'instance :

String getCountry()

String getDisplayCountry()
String getDisplayCountry(Locale l)

String getDisplayLanguage()
String getDisplayLanguage(Locale l) 

String getDisplayName(
String getDisplayName(Locale l)

String getDisplayVariant()

String getDisplayVariant(Locale l) 

String getISO3Country() 

String getISO3Language() 

String getLanguage() 

String getVariant() 

3 séparation code/données spécifiques à la Locale.

Une des phases essentielles de l'internationalisation d'une application est de séparer le code du programme des données spécifiques à la localisation du programme. 

La classe RessourceBundle permet d'utiliser des paquets de ressources. Un paquet de ressources est un ensembles de fichiers dont les noms sont construits de la façon suivante : nomDeBase{_langue{_pays}}.properties. Chaque fichier est ainsi associé à une locale, qui peut exister ou non. Un fichier est constitué d'un couple (clé, valeur).

Exemple :

ResourceBundle bundle = 
   ResourceBundle.getBundle("messages",
        Locale.getDefault());
...
this.setTitle(bundle.getString("titre"));

titre=Bonjour
...

titre=Hello
...

Ajouter une localisation  dans le pays YY et la langue xx consiste à ajouter un fichier messages_xx_YY.properties.

Supposons que la locale par défaut soit constituée du langage ll, du pays PP et du variant var.

La méthode getBundle( String nom) calcule un ResourceBundle constitué des fichiers de la liste : 

nom_ll_PP_var.properties
nom_ll_PP.properties
nom_ll.properties
nom.properties

La méthode  getString(String clé) de la classe ResourceBundle retourne la chaîne de caractères associée à la clé dans le resourceBundle : la recherche se fait dans les fichiers dans l'ordre donné précédemment. Si la clé ou les fichiers ne sont pas trouvés, une exception  MissingResourceException est levée.

• Une application qui a des textes en français ou en anglais pourra définir messages_fr.properties et messages_en.properties.
• Si on veut que par défaut (il n'y a pas de fichier properties pour la langue ou le pays) ce soit les textes en français, on définiera messages.properties ( les textes en français) et messages_en.properties.
• Pour avoir une ressource commune à un pays dans lequel on parle plusieurs langues on définiera messages_l1_PP.properties et messages_l2_PP.properties qui contiennent la même clé.

4 Format des dates, nombres, monnaies.

Voir ici.

Exemple :

Date d = new Date();
DateFormat df  = DateFormat.getDateInstance(DateFormat.FULL, Locale.getDefault());
DateFormat dfCourt = DateFormat.getDateInstance(DateFormat.SHORT, Locale.getDefault());
NumberFormat nf   = NumberFormat.getCurrencyInstance();
ResourceBundle bundle = ResourceBundle.getBundle(...);

df.format(d);       // une date format long 
dfCourt.format(d);  // une date format court
nf.format(1234.56); // monnaie

haut de la page