Vertaling 25.12
webforJ bevat een ingebouwd vertaalsysteem voor het opzoeken van gelokaliseerde stringwaarden op basis van sleutel. Het systeem bestaat uit een vertaaloplosser die sleutels aan gelokaliseerde tekst koppelt, een HasTranslation concerninterface die een handige t()-methode biedt, App.getTranslation() voor directe toegang overal, automatische locale-detectie vanuit de browser en ondersteuning voor aangepaste vertaalbronnen zoals databases.
Vertaaloplosser
De vertaaloplosser is het systeem dat gelokaliseerde strings opzoekt voor een gegeven sleutel en locale. webforJ biedt een standaardoplosser, BundleTranslationResolver, die vertalingen laadt vanuit Java ResourceBundle-eigenschapsbestanden op het classpath. Dit werkt direct zonder extra afhankelijkheden.
Eigenschapsbestanden voor middelen
Plaats uw vertaalbestanden in de directory src/main/resources. De standaardoplosser zoekt naar bestanden met de naam messages met locale-suffixen volgens de standaard Java ResourceBundle naamgevingsconventie:
messages.properties # Standaard/fallback vertalingen
messages_en.properties # Engels
messages_de.properties # Duits
messages_fr_CA.properties # Frans (Canada)
Elk bestand bevat sleutel-waardeparen. Sleutels zijn identificaties die u in de code gebruikt, en waarden zijn de vertaalde strings. U kunt MessageFormat placeholders zoals {0}, {1} gebruiken voor dynamische waarden:
app.title=Mailbox
menu.inbox=Inbox
menu.outbox=Outbox
greeting=Hallo {0}, u heeft {1} nieuwe berichten
app.title=Postfach
menu.inbox=Posteingang
menu.outbox=Postausgang
greeting=Hallo {0}, Sie haben {1} neue Nachrichten
De oplosser verwijst door naar de standaard ResourceBundle resolutieketen van Java, die automatisch locale-matching en fallback behandelt.
Ondersteunde locales configureren
De instelling supported-locales geeft aan webforJ welke locales uw app ondersteunt. Deze lijst wordt gebruikt door autodetectie om de browserlocale van de gebruiker te vergelijken met beschikbare vertalingen. De eerste locale in de lijst wordt gebruikt als standaard fallback wanneer er geen betere match wordt gevonden. De eigenschapssleutel is webforj.i18n.supported-locales en accepteert een lijst van BCP 47 taallabels, bijv. en, de.
Zie de Configuratie sectie om te leren hoe u eigenschappen voor verschillende omgevingen kunt instellen.
De t()-methode
Componenten die de HasTranslation concerninterface implementeren, krijgen toegang tot de t()-methode voor het vertalen van tekst. De methode neemt een vertaalsleutel en retourneert de gelokaliseerde string voor de huidige app-locale:
public class MainLayout extends Composite<AppLayout> implements HasTranslation {
public MainLayout() {
// Eenvoudige vertaling
String title = t("app.title");
// Vertaling met MessageFormat parameters
String greeting = t("greeting", userName, messageCount);
// Vertaling voor een specifieke locale
String germanTitle = t(Locale.GERMAN, "app.title");
}
}
U kunt ook App.getTranslation() rechtstreeks overal gebruiken zonder de interface te implementeren:
String title = App.getTranslation("app.title");
Als een vertaalsleutel niet kan worden gevonden, retourneert t() de sleutel zelf in plaats van een uitzondering te genereren. Dit betekent dat uw app niet crasht als een vertaling ontbreekt. De sleutel wordt zoals hij is weergegeven, en er wordt een waarschuwing gelogd, zodat u ontbrekende vertalingen tijdens de ontwikkeling kunt volgen.
Vertaalde componenten implementeren
Een vertaald component combineert doorgaans HasTranslation met LocaleObserver. Gebruik t() bij het maken van UI-elementen om de initiële vertaalde tekst in te stellen. Om runtime-taalwisseling te ondersteunen, implementeert u LocaleObserver en werkt u dezelfde tekst bij in onLocaleChange().
@Route
public class MainLayout extends Composite<AppLayout>
implements HasTranslation, LocaleObserver {
private final AppLayout self = getBoundComponent();
private AppNavItem inboxItem;
private AppNavItem outboxItem;
public MainLayout() {
inboxItem = new AppNavItem(t("menu.inbox"), InboxView.class, TablerIcon.create("inbox"));
outboxItem = new AppNavItem(t("menu.outbox"), OutboxView.class, TablerIcon.create("send-2"));
AppNav appNav = new AppNav();
appNav.addItem(inboxItem);
appNav.addItem(outboxItem);
self.addToDrawer(appNav);
}
@Override
public void onLocaleChange(LocaleEvent event) {
inboxItem.setText(t("menu.inbox"));
outboxItem.setText(t("menu.outbox"));
}
}
Het gegevensbindingsysteem ondersteunt vertaalde validatie- en transformatieberichten met Supplier<String> met t(). Zie dynamische validatieberichten, dynamische transformatieberichten en locale-bewuste Jakarta Validatie.
Aangepaste vertaaloplossers
De standaardoplosser laadt vertalingen vanuit Java ResourceBundle eigenschapsbestanden. Om vertalingen uit een andere bron te laden, zoals een database of een externe service, implementeert u TranslationResolver:
public class DatabaseTranslationResolver implements TranslationResolver {
private final TranslationRepository repository;
private final List<Locale> supportedLocales;
public DatabaseTranslationResolver(TranslationRepository repository,
List<Locale> supportedLocales) {
this.repository = repository;
this.supportedLocales = List.copyOf(supportedLocales);
}
@Override
public String resolve(String key, Locale locale, Object... args) {
String value = repository
.findByKeyAndLocale(key, locale.getLanguage())
.map(Translation::getValue)
.orElse(key);
if (args != null && args.length > 0) {
value = new MessageFormat(value, locale).format(args);
}
return value;
}
@Override
public List<Locale> getSupportedLocales() {
return supportedLocales;
}
}
Een aangepaste oplosser registreren
In een standaard webforJ-app zet u de oplosser voordat de app start, bijvoorbeeld met een app lifecycle listener:
App.setTranslationResolver(new DatabaseTranslationResolver(repository, supportedLocales));
In een Spring Boot-app stelt u de oplosser beschikbaar als een bean:
@Configuration
public class MessageSourceConfig {
@Bean
TranslationResolver translationResolver(TranslationRepository repository,
SpringConfigurationProperties properties) {
List<Locale> supportedLocales = properties.getI18n().getSupportedLocales().stream()
.map(Locale::forLanguageTag)
.toList();
return new DatabaseTranslationResolver(repository, supportedLocales);
}
}
Wanneer geen aangepaste TranslationResolver bean is gedefinieerd, biedt Spring auto-configuratie een standaard BundleTranslationResolver die is geconfigureerd met de ondersteunde locales uit application.properties.