wrapper.jvm.encoding

対応バージョン :3.5.35
対応エディション :プロフェッショナル版スタンダード版コミュニティー版 (未対応)
対応プラットフォーム :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

このプロパティは、JVM のデフォルトエンコーディングを Wrapper で使用しているエンコーディングと異なる値に設定する場合、または Java 18 以降で UTF-8 以外のエンコーディングを指定する場合に使用します。 wrapper.jvm.encoding で指定した値は、コマンドライン上の file.encoding システムプロパティとして JVM に渡されます。

有効な値は次のとおりです。

  • [UTF-8] : Java 18 以降で推奨される値です。それ以前の JVM でも動作します。

  • [COMPAT] (ver. 3.7.0 以降): このトークンは次のように解決されます。
    - Java 18 以降では、COMPAT はそのまま JVM に渡され、Java は Java 17 のときと同様に互換モードでデフォルトエンコーディングを決定します。
    - Java 17 以前では、COMPAT は Wrapper 自身が解釈し、Windows では ANSI コードページ、Unix では Wrapper 起動時のロケールに基づくエンコーディングに変換されます。

  • [WRAPPER] *(ver. 3.7.0 以降): このトークンは、Wrapper プロセスと同じエンコーディングを指定するために使用します(つまり、wrapper.lang.<platform>.encoding の値を対応する Java 表記に自動変換したものです)。
    これは、Java のバージョンに関係なく 3.7.0 より前の Wrapper ではデフォルトの動作であり、Java 17 以前では現在もデフォルトであることに注意してください。

  • <canonical_name> *: 現在の JVM がサポートする有効な file.encoding 値です(例: ISO-8859-1、windows-1252 など)。 たとえば、Oracle Java 17 は 次のエンコーディング をサポートしています。
    Java 18 以降では、file.encoding で公式にサポートされる値は 'UTF-8' と 'COMPAT' のみであることに注意してください。

  • [DEFAULT] : これがデフォルト値です。
    - Java 18 以降では、デフォルトの動作はエンコーディングを JVM に渡さないことです(つまり、UTF-8 を使用させます)。
    - Java 17 以前では、デフォルトの動作は WRAPPER 値について説明したとおりに JVM エンコーディングを解決することです。

* 指定したエンコーディング(または WRAPPER 使用時に解決されたエンコーディング)が現在の JVM でサポートされていない場合、 Wrapper はエラーメッセージをログに記録して停止します。ただし、wrapper.jvm.encoding.allow_unsupported を TRUE に設定することで、この制限を解除できます。

例:(JVM のデフォルトエンコーディングを 'COMPAT' モードに設定)
wrapper.jvm.encoding=COMPAT

注意

wrapper.jvm.encoding の設定は、JVM が標準出力に対して別のエンコーディングを指定できる場合にのみサポートされます。 これには、stdout.encoding および stderr.encoding システムプロパティ(Java 18 以降で利用可能)のサポート、または sun.stdout.encoding および sun.stderr.encoding プロパティ(Java 8 以降の Oracle および OpenJDK 実装で利用可能)のいずれかが必要です。 Wrapper は常にこのサポートの有無を確認しますが、wrapper.jvm.encoding が DEFAULT 以外の値に設定されている場合は、必要な条件が満たされているときのみアプリケーションを起動します。

警告

このプロパティを使用する場合('DEFAULT' 以外の任意の値)は、JVM に渡す引数 に 'file.encoding'、'stdout.encoding'、'stderr.encoding'、'sun.stdout.encoding'、または 'sun.stderr.encoding' への参照が含まれていない必要があります。含まれている場合、Wrapper は停止します。

このプロパティは、JVM が再起動し wrapper.restart.reload_configuration が TRUE に設定されていても再読み込みされません。 ただし、このプロパティが設定されている状態で上記のシステムプロパティのいずれかが JVM 引数に追加されていた場合、Wrapper は停止します。

wrapper.jvm.encoding.allow_unsupported

対応バージョン :3.7.0
対応エディション :プロフェッショナル版スタンダード版コミュニティー版 (未対応)
対応プラットフォーム :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

このプロパティを使用すると、Wrapper は wrapper.jvm.encoding の値を現在の Java バージョンがサポートするエンコーディングと照合する検証をスキップします。 これは特に Java 18 以降で役立ちます。JVM が公式にサポートするのは 'UTF-8' と 'COMPAT' のみですが、他の多くのエンコーディングは保証されなくなったものの、依然として「引き続き動作する可能性が高い」とドキュメントに記載されています。

デフォルト値は FALSE です。

例:(Java 18 以降では公式にサポートされていないにもかかわらず、'EUC-JP' を JVM に渡すことを許可)
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