Sprachunterstützung für die Ausgabe von Meldungen

BeanConnect erlaubt die Internationalisierung und Lokalisierung von Meldungen des BeanConnect Resource Adapters, des BeanConnect Proxys und der BeanConnect Management Console. Internationalisierung und Lokalisierung bedeutet, dass Meldungen, die eine Komponente an die Benutzer weiterleitet oder in Protokolldateien schreibt, korrekt für die entsprechende Umgebung (Land, Sprache) ausgegeben wird.

Daher bietet Java Klassen an, die die Internationalisierung unterstützen (wie z.B. die Klasse Locale). In BeanConnect gibt es zwei Kriterien, um festzustellen, in welcher Sprache Meldungen ausgegeben werden sollen:

• Sprache (z.B. de)

• Land (z.B. DE)

Die Sprachkennung ist durch den internationalen Standard ISO-639 definiert. Die möglichen Länderkennungen sind in ISO-3166 festgelegt.

Bei BeanConnect lauten die Standardeinstellungen für Sprache en und US für die Länderkennung. Wenn der Benutzer nicht ausdrücklich eine andere Einstellung festlegt, werden die Standardwerte von der aktuellen JVM (Default-Locale) übernommen.

BeanConnect bietet zwei Möglichkeiten, diese Standardeinstellungen zu ändern:

• Stellen Sie beim Starten eines Java-Programms die Spracheinstellung ein, indem Sie folgende zwei Systemeigenschaften definieren:

  • net.fsc.tpbasics.i18n.defaultCountry und

  • net.fsc.tpbasics.i18n.defaultLanguage

• Speichern Sie die gewünschten Einstellungen in der Datei beanconnect_i18n.properties, die im Klassenpfad der betreffenden JVM stehen muss.

BeanConnect versucht zuerst, die Einstellungen anhand der Systemeigenschaften zu ermitteln. Wenn keine Systemeigenschaften definiert wurden, sucht das System nach der Property-Datei, um die Eigenschaften von dort zu übernehmen. Standardmäßig sollte die Spracheinstellung in der Datei beanconnect_i18n.properties eingestellt werden.

Standardkonfiguration

Bei der Installation des BeanConnect Resource Adapters, des BeanConnect Proxys oder der BeanConnect Management Console wird die JAR-Datei (BeanConnectI18N.jar) deployt. Diese Datei muss in den Klassenpfad der JVM eingebunden werden. Standardmäßig hat die Datei folgenden Inhalt:

• beanconnect_i18n.properties für die Spracheinstellungen

• die Meldungsdateien für die einzelnen Komponenten (Standardsprache: en, US)

• mehrere Java-Klassen (Msg...class), die unverändert in der JAR-Datei bleiben müssen.

Um den Zugriff auf die Meldungsdateien zu ermöglichen, müssen deren Namen einem bestimmten Muster folgen.

Verschiedene Meldungsdateien mit dem Namen <component>.properties stehen zur Verfügung. Diese Dateien werden als Ersatz verwendet, wenn Sie nicht die richtigen Werte für Sprache und Land eingegeben haben.

Die aktuell verwendeten Meldungsdateien sind:

Resource adapter	basics.properties stub.properties proxy.properties ui.properties oltpmsg.properties jconnect.properties encoding.properties
Proxy	proxy.properties oltpmsg.properties
Management Console	mc.properties tpbasics.properties

Darüber hinaus kann eine Datei <component>_en_US.properties in der JAR-Datei enthalten sein. Dabei handelt es sich normalerweise um eine Kopie der Datei <component>.properties, da en_US der Standardwert für BeanConnect-Meldungsdateien ist.

Beispiele für Dateinamen:

• proxy.properties

• proxy_de.properties

• proxy_en_US.properties

• proxy_fr_FR.properties

Eine neue Sprache einführen

Sie können andere Sprachen unterstützen, indem Sie der JAR-Datei BeanConnectI18N.jar Meldungsdateien hinzufügen. Diese Meldungsdateien sind Textdateien, die mit einem Texteditor (wie z.B. Notepad, vi) bearbeitet werden können.

Das nachfolgende Beispiel zeigt die Schritte, welche ausgeführt werden müssen, um deutsche Meldungen zu erhalten.

1. Extrahieren Sie mit dem Befehl jar oder dem Programm WinZip die Standardmeldungsdatei (z.B. proxy.properties) aus der JAR-Datei. 

2. Übersetzen Sie die Meldungen ins Deutsche. 

3. Speichern Sie die neue Meldungsdatei unter dem Namen proxy_de_DE.properties und fügen Sie sie der JAR-Datei unter demselben Pfad (net.fsc.tpbasic.i18n.r) wie die Standarddatei hinzu. 

4. Extrahieren Sie die Datei beanconnect_i18n.properties. 

5. Geben Sie de für die Sprache und DE für das Land ein:

   net.fsc.tpbasics.i18n.defaultLanguage=de

   net.fsc.tpbasics.i18n.defaultCountry=DE 

6. Schreiben Sie die Datei beanconnect_i18n.properties in die JAR-Datei zurück.

Führen Sie die Schritte 1 bis 3 für alle anderen Meldungsdateien durch (stub.properties, ui.properties, etc.).

Beachten Sie beim Wechsel in eine andere Sprache, dass die Datei BeanConnectI18N.jar für den BeanConnect Resource Adapter in der Datei BeanConnect.rar bearbeitet werden muss, bevor der Connector deployt wird.

Für den BeanConnect Proxy und die BeanConnect Management Console muss die Datei BeanConnectI18N.jar im BeanConnect-Home-Verzeichnis <BC_home>/lib bearbeitet werden.