Mehrsprachige Anwendungen (Internationalisierung)

Texte auslagern

• Zu übersetzende Anwendungstexte können im Markup mit wicket:message ausgelagert werden:

  <wicket:message key="someKey">some placeholder</wicket:message>

• Alternativ können Übersetzungen mit einem ResourceModel erreicht werden:

  add(new Label("someLabel", new ResourceModel("someKey", "some default value")));

• Alternativ können über Localizer Texte für Komponenten abgefragt werden:

  getLocalizer().getString("someKey", "some default value")

Ablage von Übersetzungen

• Die Texte werden in Property Resource Bundles abgelegt:

  someKey=Some translated value
  someOtherKey=Some other translated value

• Alternativ können die Übersetzungen in XML-Dateien abgelegt werden (insb. da Properties immer ISO-8859-1 kodiert sind):

  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
  <properties>
      <entry key="someKey">Some translated value</entry>
      <entry key="someOtherKey">Some other translated value</entry>
  </properties>

Auflösung von Übersetzungen

1. Wicket sucht zunächst parallel zur Komponente, z.B. SomeForm.properties bzw. SomeForm.xml

2. Danach geht Wicket die Komponentenhierarchie bis zum Wurzelelement ab und versucht eine Übersetzung zu finden (z.B. in einer SomePage.properties oder BasePage.properties)

3. Dabei wird jeweils mit dem aktuellen Locale mit Fallback gesucht:

   SomePage_de_DE.properties
   SomePage_de.properties
   SomePage.properties

4. Gehört der Key zu einer Komponente, wird zunächst nach componentId.someKey gesucht, danach nach someKey.

Sprachauswahl

• Das Locale wird bei der Erzeugung der Web-Session automatisch anhand des HTTP-Headers Accept-Language ermittelt (Einstellung der bevorzugten Sprache im Browser).

• Zugriff erfolgt mit Session.get().getLocale/setLocale, z.B.:

  add(new Link("german") {
  
      public void onClick() {
          Session.get().setLocale(Locale.GERMAN);
      }
  
      public boolean isEnabled() {
          return !Locale.GERMAN.equals(Session.get().getLocale());
      }
  
  });

Übersetzung von Validierungsmeldungen

• Bezeichnungen für Komponenten werden automatisch anhand der ID in Property-Files nachgeschlagen oder können mit formComponent.setLabel explizit gesetzt werden.
• Validierungsmeldungen können für die Anwendung überschrieben werden, siehe org.apache.wicket.application_*.properties für die Standard-Texte bzw. die Key-Bezeichnungen.