5.4Internationalisierung und Lokalisierung 

Soll ein Programm in jeder Kultur und jedem Sprachraum optimal laufen, ist auf eine ganze Reihe von Dingen zu achten:

• Texte der Beschriftungen

• Konventionen in Bezug auf Datum, Dezimalzahlen, Währungen, Telefonnummern

• Ausrichtungen und Schreibrichtung

• Grafiken, Farben

• Töne, Musiken

In der Softwareentwicklung gibt es zwei Begriffe, die sich um sprachabhängige Programme drehen, Internationalisierung und Lokalisierung:

• Internationalisierung: Die Internationalisierung eines Programms bedeutet, dass es so entwickelt und vorbereitet wurde, dass es unter beliebig vielen Sprachen arbeitet.

• Lokalisierung: Die Lokalisierung ist der Prozess des Anpassens an eine bestimmte neue Sprache.

Eine Software, die gleich internationalisiert entworfen wird, kann leicht um andere Sprachen erweitert werden, und Unternehmen können somit schnell in neue Märkte eintreten. Java unterstützt das mit diversen Möglichkeiten:

• Format-Klassen erleichtern die Formatierung von Datum und Zahlen.

• ResourceBundle-Objekte ermöglichen unterschiedliche Sprachen durch Übersetzungsdateien bzw. eigene Abbildungen zwischen einem Schlüssel und einer Übersetzung.

• Collator-Klassen aus dem java.text-Paket können sprachabhängig sortieren.

• Swing kann Text und Komponenten mühelos von rechts nach links laufen lassen.

Die Vorbereitung kostet natürlich Zeit und gestalterische Klarheit. Ein Zuviel an Grafiken kann dabei der Lokalisierung im Weg stehen, etwa bei Handgesten, Bildern von Tieren oder Gesichtern.

 

5.4.1ResourceBundle-Objekte und Ressource-Dateien 

Sollen Java-Programme sprachunabhängig gestaltet werden, müssen in der ersten Phase der Internationalisierung alle Zeichenketten einer Landessprache durch symbolische Namen ersetzt werden. Die Verbindung zwischen den symbolischen Namen und den landessprachlichen Texten übernimmt ein ResourceBundle-Objekt, hinter dem eine Lokalisierungsdatei steht. Wenn das Programm später eine Zeichenkette nutzen will, greift es auf den symbolischen Namen zurück, den dann das ResourceBundle-Objekt auf die entsprechende Übersetzung überträgt. ResourceBundle-Objekte sind spezielle Assoziativspeicher, die alle programmrelevanten Texte und Informationen für ein spezielles Land repräsentieren. Ein wesentliches Merkmal von Java besteht in der Fähigkeit dieser Datenspeicher, sich die passenden Lokalisierungsdateien selbst herauszusuchen.

 

5.4.2Ressource-Dateien zur Lokalisierung 

Die Übersetzungen können aus Dateien oder einfachen Listen stammen; wir nehmen im Folgenden Dateien an. Da wir die Sprachen Englisch und Deutsch unterstützen wollen, legen wir im (frei wählbaren) Verzeichnis resources zwei Dateien an, eine für die englische und eine für deutsche Version:

Listing 5.2resources/HelloWorld_en.properties

Listing 5.3resources/HelloWorld_de.properties

Die Datei enthält Schlüssel-Wert-Paare sowie Kommentare, die mit einer Raute beginnen. Mit einem Identifizierer – wie »Hello« – sind die landes-/sprachabhängigen Zeichenketten als Werte verbunden.

Die Dateinamen für die Ressourcen-Dateien haben dabei einen speziellen Aufbau. Sie setzen sich aus dem so genannten Basisnamen (hier HelloWorld), einem Unterstrich (»_«), einer Landeskennung und dem Datei-Suffix properties zusammen. Damit ergeben sich für die Sprachen Englisch und Deutsch die Dateinamen HelloWorld_en.properties und HelloWorld_de.properties.

Eclipse kann die Zeichenketten eines Programms automatisch in eine Datei auslagern. Dazu ist im Menü Source der Eintrag Externalize Strings… aufzurufen.

 

5.4.3Die Klasse ResourceBundle 

Um auf die Übersetzungsdateien zurückgreifen zu können, benötigen wir ein Objekt der Klasse ResourceBundle. Die statische Fabrikmethode ResourceBundle.getBundle(String) liefert den Assoziativspeicher, wobei das Argument der Basisname wie »HelloWorld« ist. Über den Schlüssel sucht die Methode getString(String key) die landesspezifische Meldung heraus:

Listing 5.4com/tutego/insel/bundle/InternationalHelloWorld.java

 

5.4.4Ladestrategie für ResourceBundle-Objekte 

Die Methode getBundle(…) sucht automatisch anhand der eingestellten Landessprache die passende Datei aus dem Klassenpfad (aus diesem Grund heißt unser Basisname »resources.HelloWorld« und nicht nur einfach »HelloWorld«). Die Dateinamen für die jeweiligen ResourceBundle-Objekte können sehr variabel zusammengesetzt werden, wobei getBundle(…) die nachfolgenden Bildungsgesetze verwendet und bei der Dateisuche mit der speziellsten Beschreibung beginnt:

• bundleName_localeLanguage_localeCountry_localeVariant

• bundleName_localeLanguage_localeCountry

• bundleName_localeLanguage

• bundleName_defaultLanguage_defaultCountry_defaultVariant

• bundleName_defaultLanguage_defaultCountry

• bundleName_defaultLanguage

• bundleName

Sind mehrere Ressourcen-Dateien im Klassenpfad, so integriert sie getBundle(…). Eine Datei wie HelloWorld_de.properties erweitert (und überschreibt unter Umständen) die Inhalte von HelloWorld.properties. Eine localeCountry ist zum Beispiel »CH« (das ist keine Variante), was zu einem Dateinamen HelloWorld_de_CH.properties führt.

Listing 5.5resources/HelloWorld_de_CH.properties

Die Anfrage bundle.getString("Hello") liefert »Grüezi«, und bundle.getString("Bye") retourniert »Tschüss« aus der übergeordneten Datei. Die Datei HelloWorld_de_CH.properties überschreibt die hochdeutschen Wörter aus HelloWorld_de.properties mit Wörtern auf Schwyzerdütsch, was wiederum Wörter aus HelloWorld.properties überschreiben würde. Um das Programm zu testen, ändert folgende Zeile vor getBundle(…) die Sprache:

Gibt es dann eine Datei wie HelloWorld_de_CH.properties, aber HelloWorld_de.properties fehlt und die eingestellte Sprache ist nur Deutsch und nicht ausschließlich Schweizerdeutsch, beachtet getBundle(…) die Datei HelloWorld_de_CH.properties nicht, sondern nur eventuell vorgelagerte Dateien wie HelloWorld.properties.

• static ResourceBundle getBundle(String baseName)
  Liefert das ResourceBundle für einen Basisnamen. Eine MissingResourceException folgt, wenn kein Resource-Bundle mit diesem Basisnamen gefunden werden konnte.

• String getString(String key)
  Gibt den mit key assoziierten Wert von diesem Resource-Bundle oder von den Vätern zurück.

• boolean containsKey(String key)
  Erfragt, ob es im Resource-Bundle für den Schlüssel eine Übersetzung gibt.

• Set<String> keySet()
  Liefert alle Übersetzungen dieses Resource-Bundles.

• String getBaseBundleName()
  Liefert den Namen des Resource-Bundles oder null, falls dieser nicht gegeben ist. Neu in Java 8.

Die einfache statische Fabrikmethode getBundle(…) bezieht zum Ansprechen der Dateien die Standardsprache aus Locale.getDefault().

 

5.4.5Ladeprozess und Format anpassen * 

Die Lademethode getBundle(…) ist stark mit Logik verbunden, doch bietet die Java-API drei Varianten zur Anpassung:

• Von ResourceBundle gibt es zwei Unterklassen, ListResourceBundle und PropertyResourceBundle. Während ListResourceBundle im Grunde ein zweidimensionales Feld mit den Übersetzungen aufbaut, lädt PropertyResourceBundle aus Property-Dateien, wobei hier auch beliebige Kodierungen wie UTF-8 erlaubt sind. Beispiele liefert die API-Dokumenation.

• Die zweite Anpassung ist mit ResourceBundle.Control-Objekten möglich, die etwa bei getBundle(String baseName, ResourceBundle.Control control) übergeben werden. Diese Objekte werden »zurückgerufen« und können Einfluss auf das Laden und die Auswahl von Sprachen nehmen.

• Die dritte Variante ist ResourceBundleControlProvider und neu in Java 8. Implementierungen dieser Schnittstelle lassen sich über den Service-Loader einbinden. Die Oracle-Seite http://docs.oracle.com/javase/tutorial/i18n/serviceproviders/resourcebundlecontrolprovider.html gibt ein paar Details.

Beispiel ListResourceBundle

Ein Resource-Bundle ohne Dateien, realisiert als ListResourceBundle, kann so aussehen:

Listing 5.6com/tutego/insel/bundle/MonthResourceBundle_de_DE.java,  MonthResourceBundle_de_DE

Die Nutzung der Klasse ist wie folgt:

Listing 5.7com/tutego/insel/bundle/MonthResourceBundleDemo.java, main()

In diesem Fall lädt ResourceBundle.getBundle(…) keine Property-Datei, sondern eine Klasse im Klassenpfad. Die API von ResourceBundle bietet auch eine Methode getStringArray(), die ein Feld zurückgibt, jedoch ist das bei Ressourcen-Dateien nicht nötig, nur bei Ressourcen, die »von Hand« programmiert wurden, wie in unserem Beispiel.