wrapper.jvm.encoding

Kompatibel :3.5.35
Editionen :Professional EditionStandard EditionCommunity Edition (Not Supported)
Betriebssysteme :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Diese Eigenschaft wird verwendet, um die Standardkodierung der JVM festzulegen, wenn sie sich von der vom Wrapper verwendeten Kodierung unterscheiden soll, oder um bei Verwendung von Java 18 und höher eine andere Kodierung als UTF-8 festzulegen. Der mit wrapper.jvm.encoding angegebene Wert wird der JVM über die Systemeigenschaft file.encoding in der Befehlszeile übergeben.

Gültige Werte sind:

  • UTF-8: Dies ist der empfohlene Wert bei Verwendung von Java 18 und höheren Versionen. Er funktioniert auch mit früheren JVMs.

  • COMPAT (Seit ver. 3.7.0): Dieses Token wird wie folgt aufgelöst:
    - Unter Java 18 und höher wird COMPAT unverändert an die JVM übergeben, wodurch Java die Standardkodierung im Kompatibilitätsmodus bestimmt, wie es in Java 17 der Fall war.
    - Unter Java 17 und früher wird COMPAT vom Wrapper selbst interpretiert und unter Windows in die ANSI-Codepage bzw. unter Unix in die Kodierung übersetzt, die auf der Locale zum Zeitpunkt des Wrapper-Starts basiert.

  • WRAPPER * (Seit ver. 3.7.0): Dieses Token wird verwendet, um dieselbe Kodierung wie der Wrapper-Prozess festzulegen (d. h. den Wert von wrapper.lang.<platform>.encoding, der automatisch in die entsprechende Java-Notation umgewandelt wird).
    Beachten Sie, dass dies das Standardverhalten für Wrapper-Versionen vor 3.7.0 unabhängig von der Java-Version war und für Java 17 und frühere Versionen weiterhin der Standard ist.

  • <canonical_name> *: Ein gültiger file.encoding-Wert, der von der aktuellen JVM unterstützt wird (z. B. ISO-8859-1, windows-1252 usw.). Oracle Java 17 unterstützt beispielsweise die folgenden Kodierungen.
    Beachten Sie, dass in Java 18 und höher die einzigen offiziell unterstützten Werte für file.encoding 'UTF-8' und 'COMPAT' sind.

  • DEFAULT: Dies ist der Standardwert.
    - Unter Java 18 und höher besteht das Standardverhalten darin, die Kodierung nicht an die JVM zu übergeben (d. h. UTF-8 verwenden zu lassen).
    - Unter Java 17 und früher besteht das Standardverhalten darin, die JVM-Kodierung wie für den Wert WRAPPER beschrieben aufzulösen.

* Wenn die angegebene Kodierung (oder die bei Verwendung von WRAPPER aufgelöste Kodierung) von der aktuellen JVM nicht unterstützt wird, protokolliert der Wrapper eine Fehlermeldung und stoppt. Diese Einschränkung kann jedoch aufgehoben werden, indem wrapper.jvm.encoding.allow_unsupported auf TRUE gesetzt wird.

Beispiel: (Standardkodierung der JVM auf den Modus 'COMPAT' setzen)
wrapper.jvm.encoding=COMPAT

NOTE

Das Setzen von wrapper.jvm.encoding wird nur unterstützt, wenn die JVM das Festlegen einer separaten Kodierung für die Standardausgabe zulässt. Dies erfordert entweder die Unterstützung der Systemeigenschaften stdout.encoding und stderr.encoding (verfügbar in Java 18 und höher) oder der Eigenschaften sun.stdout.encoding und sun.stderr.encoding (verfügbar in Oracle- und OpenJDK-Implementierungen ab Java 8). Der Wrapper prüft diese Unterstützung immer, aber wenn wrapper.jvm.encoding auf einen anderen Wert als DEFAULT gesetzt ist, startet er die Anwendung nur, wenn die erforderlichen Bedingungen erfüllt sind.

WARNING

Die Verwendung dieser Eigenschaft (jeder andere Wert als 'DEFAULT') erfordert, dass in den an die JVM übergebenen Argumenten kein Verweis auf 'file.encoding', 'stdout.encoding', 'stderr.encoding', 'sun.stdout.encoding' oder 'sun.stderr.encoding' vorhanden ist, andernfalls stoppt der Wrapper.

Diese Eigenschaft wird nicht neu geladen, wenn die JVM neu startet und wrapper.restart.reload_configuration auf TRUE gesetzt ist. Wenn jedoch eine der oben genannten Systemeigenschaften zu den JVM-Argumenten hinzugefügt wurde, während diese Eigenschaft gesetzt ist, stoppt der Wrapper.

wrapper.jvm.encoding.allow_unsupported

Kompatibel :3.7.0
Editionen :Professional EditionStandard EditionCommunity Edition (Not Supported)
Betriebssysteme :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Diese Eigenschaft ermöglicht es dem Wrapper, die Validierung des Werts von wrapper.jvm.encoding anhand der von der aktuellen Java-Version unterstützten Kodierungen zu überspringen. Dies kann nützlich sein, insbesondere bei Verwendung von Java 18 oder höher, wo nur 'UTF-8' und 'COMPAT' offiziell von der JVM unterstützt werden, viele andere Kodierungen jedoch - obwohl nicht mehr garantiert - weiterhin als "wahrscheinlich weiterhin funktionsfähig" dokumentiert sind.

Der Standardwert ist FALSE.

Beispiel: ('EUC-JP' an die JVM übergeben, obwohl es von Java 18+ nicht offiziell unterstützt wird)
wrapper.lang=en_US
wrapper.lang.unix.encoding=UTF-8

# This will add -Dfile.encoding=EUC-JP to the command line, which is not officially supported by Java 18+.
wrapper.jvm.encoding=EUC-JP

# Without this property, the Wrapper would stop.
wrapper.jvm.encoding.allow_unsupported=TRUE