Nuclos Regeln lokalisieren: BusinessException, InputRequiredException, MessageContext, Lokalisierungsschlüssel, Locale, withArgs, DoNotTranslate.

globe with meridians Sprache: Deutsch · English

hammer and wrench Regeln lokalisieren

Regelmeldungen übersetzbar machen – BusinessException, InputRequiredException und MessageContext mit Schlüsseln, Locale und Platzhaltern.

Auf dieser Seite

Überblick

Regelmeldungen an den Benutzer lassen sich seit v4.2025.15 lokalisieren. Unterstützung bieten die Klassen BusinessException, InputRequiredException und MessageContext. Übergib nach Möglichkeit immer eine Locale – sonst versucht Nuclos, das Nuclet über das Package zu ermitteln.

Der schnelle Weg

Für statische Texte: automatische Schlüsselerzeugung per Boolean-Flag true.

hier
throw new BusinessException(new DoNotTranslate(machineApi.getErrorMessage()));

Der optimale Weg

Vergib einen festen, eindeutigen Lokalisierungsschlüssel. So kannst du den Ausgangstext später ändern, ohne dass Übersetzungen komplett neu aufgebaut werden.

throw new BusinessException(new DoNotTranslate(machineApi.getErrorMessage()));

Lokalisierung verhindern

Text als DoNotTranslate-Objekt übergeben:

throw new BusinessException(new DoNotTranslate(machineApi.getErrorMessage()));

Meldungen parametrisieren

Dynamische Teile über withArgs/withMessageArgs – übersetzt wird nur das Template mit {}-Platzhaltern:

Verwandte Seiten

globe with meridians Lokalisierung


Übersicht.

Öffnen →

gear Regelwerke


Regeln.

Öffnen →

electric plug Unterstützende Klassen


Regel-API.

Öffnen →