• ［wrapper.java.additional.<n>］プロパティ群
• ［wrapper.java.additional.<n>.quotable］プロパティ群
• ［wrapper.java.additional.<n>.stripquotes］プロパティ群（Wrapper ver. 3.6.0 で使用廃止）
• ［wrapper.java.additional.default.stripquotes］プロパティ群（Wrapper ver. 3.6.0 で非推奨）
• ［wrapper.java.additional.<n>.java_version.min］プロパティ群
• ［wrapper.java.additional.<n>.java_version.max］プロパティ群
• ［wrapper.java.additional.<n>.app_only］プロパティ群（Wrapper ver. 3.6.0 で非推奨）
• ［wrapper.java.additional.<n>.scope］プロパティ群
• ［wrapper.java.additional_file］プロパティ
• ［wrapper.java.additional_file.required］プロパティ
• ［wrapper.java.additional_file.quotable］プロパティ
• ［wrapper.java.additional_file.stripquotes］プロパティ群（Wrapper ver. 3.6.0 で使用廃止）
• 使用例

対応バージョン :	1.0.0
対応エディション :
対応プラットフォーム :

このプロパティには、アプリケーションを起動するとき、Java へ引き渡す追加 Java パラメーターを設定します。 アプリケーション用のパラメーターではなく、むしろ JVM 向けのパラメーターです。

追加の Java パラメーターのリストを動的に変更したい場合は、いくつかの方法があります。 そのうちの１つは、カスケード形式インクルードファイルを使用して、［wrapper.java.additional.<n>］プロパティと JVM オプションをリストした生成済み設定ファイルを追加する方法です。 もう1つの方法は、［wrapper.java.additional_file］プロパティを使用して、プロパティを省略した JVM オプションのみをリストしたパラメーターファイルを参照する方法です。最後に、Wrapper の起動時に［wrapper.java.additional.<n>］をコマンドラインプロパティとして渡す方法がもあります。

<n>コンポーネント部：

各要素は、「wrapper.java.additional.」で始まるプロパティ名を持ち、 プロパティ名の<n>コンポーネント部には、 「1」からカウントアップしていく整数値のナンバリング数値を入れて指定します。 デフォルトでは、連番であり欠番で飛ぶことはないはずです。 ［wrapper.ignore_sequence_gaps］プロパティは、 シーケンス内でギャップ（途切れ）を「許可する／許可しない」を任意に設定にすることができます。

個別のパラメーターエントリ：

各プロパティで 1 つのパラメーターのみを定義することが重要です。

wrapper.java.additional.1=-server
wrapper.java.additional.2=-Dprop=TRUE

wrapper.java.additional.1=-server -Dprop=TRUE

wrapper.java.additional.1=--add-opens module/package=target-module

引用符：

Wrapper 3.6.0 以上のバージョン

Wrapper ver. 3.6.0 以降、特殊文字の扱いが変更され、すべてのプラットフォーム間で一貫性が確保されるようになりました。 ほとんどの場合、JVM が受け取ることを意図したとおりにパラメーター値を記述できます。

ただし、先頭または末尾のスペースは例外です。これらのスペースは通常、プロパティ値から削除されます。 これらのスペースを保持するには、値を引用符で囲む必要があります。 対応する「quotable」プロパティが「TRUE」に設定されている場合、これらの引用符は削除されます。 値に引用符自体を保持するには、「\」文字でエスケープします。バックスラッシュも二重にする必要があります（「\\」）。 その他の文字はエスケープできません。

引用符を削除する場合、次の変更のみが適用されます。

• 「\\」は、「\」になります
• 「\"」は、「"」になります
• 「"」は、「」になります

wrapper.java.additional.1=-Dprop="my arg  "
wrapper.java.additional.1.quotable=TRUE

Wrapper 3.6.0 未満のバージョン

Wrapper の古いバージョンでは、引用符の扱い方がプラットフォームによって異なります。 Windows では、Java プロセスはコマンドラインを使用して作成されますが、スペースを含む引数は引用符で囲む必要があります。 プロセスの起動時に、コマンドラインから引用符は自動的に削除されます。 一方、Linux では配列が使用され、引数は直接渡されます。

Windows の挙動をシミュレートし、プラットフォーム間で同じ設定を使用するには、 特定のパラメーターに引用符削除フラグを設定することができます（stripquotes プロパティ = TRUE）。 このフラグは Unix でのみ使用され、パラメーターを JVM に渡す前に引用符を削除することを指定します。

引用符を削除すると、次の文字を除く他のすべての文字は変更されません。 When stripping quotes, all other characters except for the following will remain unchanged.

• 「\\」は、「\」になります
• 「\"」は、「"」になります
• 「"」は、「」になります

対応バージョン :	3.6.0
対応エディション :
対応プラットフォーム :

JVM 引数 (通常はシステム プロパティ) に末尾のスペースを含める必要がある場合は、 値を引用符で囲むことで末尾のスペースを保持できます。 対応する［wrapper.java.additional.<n>.quotable］プロパティを「TRUE」に設定すると、これらの引用符は削除されます。

このプロパティのデフォルト値は「FALSE」です。

「quotable」プロパティが「TRUE」に設定されている場合、 対応する値に含むべき引用符自体を保持するには、「\」文字でエスケープする必要があり、 バックスラッシュも二重にする必要があります（\\）。 その他の文字はエスケープできません。

引用符を削除すると、次の置換が行われます。

• 「\\」は、「\」になります
• 「\"」は、「"」になります
• 「"」は、「」になります

wrapper.java.additional.1=-Dprop1="末尾にスペースがある値   "
wrapper.java.additional.1.quotable=TRUE

対応バージョン :	(No longer used as of 3.6.0)
対応エディション :
対応プラットフォーム :

もし、１つの［wrapper.java.additional.<n>］の値は引用符を含むと、Windows 上では 引用符に囲まれている内容が１つの要素として Java アプリケーションへ引き渡されます。 しかし、UNIX システム上では、引用符が引数の一部として追加されます。 殆どの場合、これは UNIX での正しい挙動ではありませんが、下位互換性を維持するためにそうなっています。

［wrapper.java.additional.<n>.stripquotes］プロパティは、 Wrapper にUNIX 上で自動的にその引用符を取り除くようにします。 Windows 上ではこのプロパティは無視されます。

デフォルトでは ［wrapper.java.additional.default.stripquotes］プロパティの値に設定され、このプロパティ自体はデフォルトで「FALSE」に設定されます。

<n>コンポーネント部：

各要素は、「wrapper.java.additional.」で始まるプロパティ名を持ち、 プロパティ名の「<n>」コンポーネント部には、 「1」からカウントアップしていく整数値のナンバリング数値を入れて指定します。 デフォルトでは、連番であり欠番で飛ぶことはないはずです。 ［wrapper.ignore_sequence_gaps］プロパティは、 シーケンス内でギャップ（途切れ）を「許可する／許可しない」を任意に設定にすることができます。

wrapper.java.additional.1.stripquotes=FALSE

引用符を削除する場合、次の変更のみが適用されます。 その他の文字は変更されません。

• 「\\」は、「\」になります
• 「\"」は、「"」になります
• 「"」は、「」になります

wrapper.java.additional.1=-server
wrapper.java.additional.2=-Dprop=TRUE
wrapper.java.additional.3=-Dmyapp.data="../MyApp Home"
wrapper.java.additional.3.stripquotes=TRUE

対応バージョン :	3.5.17 (No longer used as of 3.6.0)
対応エディション :
対応プラットフォーム :

すべての［wrapper.java.additional.<n>］プロパティ値に対して同じ動作をさせたい場合に、 UNIX でのデフォルトの引用符削除動作を変更できるようにします。 デフォルト値は、「FALSE」です。 Windows 上では、このプロパティは無視されます。

wrapper.java.additional.default.stripquotes=FALSE

対応バージョン :	3.5.36
対応エディション :
対応プラットフォーム :

このプロパティは、Java バージョンが指定された値以上の場合にのみ、インデックス「n」のオプションを追加するために使用できます。

デフォルト値は「1.4」で、これは Wrapper でサポートされている最も古い JVM バージョンです。 これより低い値は無効であり、Wrapper を停止させます。

値のフォーマットは、Java のバージョンに関わらず、「1.major[.minor[_revision]]」、あるいは「major[.minor[.revision]]」のどちらでも可能です。 これは、「java -version」によって返された両方のナンバリングスキームをサポートするために行われます。 Java 9 以前では、最初のフォーマットが使用されていましたが、Java 9 以上では最後のフォーマットが使用されます。

角括弧は、マイナー及びリビジョンのコンポネントが任意であることを示します。 片方または両方を指定しないと、これらのプレースホルダーは任意の数値を受け入れることになります。

wrapper.java.additional.<n>.java_version.min=1.7

wrapper.java.additional.<n>.java_version.min=8.0.40

対応バージョン :	3.5.36
対応エディション :
対応プラットフォーム :

このプロパティは、Java バージョンが指定された値以下の場合にのみ、インデックス「n」のオプションを追加するために使用できます。

デフォルト値は、「UNLIMITED」です。.

値のフォーマットは、Java のバージョンに関わらず、「1.major[.minor[_revision]]」あるいは「major[.minor[.revision]]」のどちらでも可能です。 これは、「java -version」によって返された両方のナンバリングスキームをサポートするために行われます。 Java 9 未満では、最初のフォーマットが使用されていましたが、Java 9 以上では最後のフォーマットが使用されます。

角括弧は、マイナー及リビジョンのコンポネントが任意であることを示します。 片方または両方を指定しないと、これらのプレースホルダーは任意の数値を受け入れることになります。

wrapper.java.additional.<n>.java_version.max=9.0.1

wrapper.java.additional.<n>.java_version.max=9

対応バージョン :	3.5.57, Requires Java 9+ (Deprecated as of 3.5.60)
対応エディション :
対応プラットフォーム :

Java アプリケーションを実行するために JVM を起動する前に、Wrapper は「--dry-run」オプションを使用して Java コマンドラインを実行して、「--dry-run」コマンドラインが有効かどうかを確認します。

［wrapper.java.additional.<n>.app_only］プロパティを「TRUE」に設定すると、コマンドラインのオプションをスキップできます。

このプロパティは、「--dry-run」オプションをサポートしていない Java バージョン（Java 9 未満）を使用する場合には効果がありません。

デフォルト値は「FALSE」です。 これは、指定されたオプションが実際の Java コマンドラインと「--dry-run」コマンドラインの両方に表示されることを意味します。 ほとんどの場合、すべての JVM オプションが検証されるため、「FALSE」が推奨されます。

ただし、［wrapper.java.additional.<n>.app_only］プロパティを「TRUE」に 設定すると便利なケースがいくつかあります。 例えば、JVM のネイティブメモリを追跡するために「 -XX:NativeMemoryTracking=[off|summary|detail]」オプションを使用すると、「--dry-run」コマンドラインで使用すると警告が表示されます。

OpenJDK 64 ビットサーバー VM の警告: ネイティブメモリ トラッキングが正しくセットアップされませんでした。間違ったランチャーを使用していますか?

ほとんどの場合、出力は［wrapper.java.query.loglevel］プロパティで指定されたレベル (デフォルトでは DEBUG) でログに記録されるため、この警告は表示されません。 ただし、「--dry-run」オプション付き JVM ではユーザーのネイティブコードが実行されないため、 ネイティブメモリの使用状況を追跡することはできません。 したがって、「--dry-run」コマンドラインにはこのオプションを含めないことをお勧めします。

wrapper.java.additional.4=-XX:NativeMemoryTracking=summary
wrapper.java.additional.4.app_only=TRUE

対応バージョン :	3.5.60
対応エディション :
対応プラットフォーム :

Java アプリケーションを起動する前に、Wrapper は java コマンドを数回実行し、現在の Java インストールの特性と アプリケーションに適切な設定を判断します。 ほとんどの場合、これらの Java 呼び出しのコマンドラインは Wrapper によって自動的に作成されるため、 ユーザーは何も気にする必要はありません。 しかし、ごくまれに、これらのコマンドラインに特定のオプションを追加または削除する必要がある場合があります。 まず、これらの Java 呼び出しとその役割のリストを一覧にしてみましょう。

• java --version：この呼び出しは、現在の Java インストールに関する情報 (バージョン、ベンダーなど) を取得します。「--version」パラメーターのみを使用するため、追加のオプションは必要ありません。

• WrapperBootstrap クラスへの呼び出し： この呼び出しは、Java アプリケーションに関する情報 (メインモジュール、メインクラス、パッケージなど) を取得します。 Wrapper は独自のオプションとパラメーターを使用してコマンドラインを構築します。 特に、クラスパス、モジュールパス、モジュールリストは、 アプリケーションの起動時に使用されるコマンドのものと完全に一致する必要があります。 まれに、メインクラスをロードするために、ユーザーが追加の引数を追加する場合があります。

• 「--dry-run」オプションを使用して呼び出し：「--dry-run」オプションは Java 9 で導入されたため、この呼び出しは以前の Java バージョンでは実行されません。 この呼び出しは、アプリケーションを実行する直前に Java コマンドラインを検証するために使用されます。 コマンドラインは、基本的に、メインメソッドを実行しないよう指定する「--dry-run」オプションを追加して、 アプリケーションを起動するときに使用されるものです。

  まれに、ドライランコンテキストに関係のない特定のオプションを削除したい場合があります。 たとえば、JVM のネイティブメモリを追跡するために「-XX:NativeMemoryTracking=[off|summary|detail]」オプションを使用すると、--dry-run コマンドラインで使用すると警告が表示されます。

  OpenJDK 64 ビットサーバー VM の警告: ネイティブメモリ トラッキングが正しくセットアップされませんでした。間違ったランチャーを使用していますか?

  ほとんどの場合、出力は［wrapper.java.query.loglevel］プロパティで指定されたレベル (デフォルトでは DEBUG) でログに記録されるため、この警告は表示されません。 ただし、「--dry-run」 JVM ではユーザーのネイティブコードが実行されないため、ネイティブメモリの使用状況を追跡することはできません。 したがって、このオプションを「--dry-run」コマンドラインに含めない方がよいでしょう。

［wrapper.java.additional.<n>.scope］プロパティは、インデック「n」 のパラメーターがどのコマンドラインで参照されるかを設定します。

可能な値は：

• [DRYRUN_APP] ：パラメーターを --dry-run インスタンスとアプリケーションの両方に渡します。この値はほとんどの場合に適しています。

• [APP] ：パラメーターをアプリケーションだけに渡します。

• [BOOTSTRAP_DRYRUN_APP] ：パラメーターをブートストラップインスタンス、--dry-run インスタンス、およびアプリケーションに渡します。

デフォルト値は「DRYRUN_APP」です。

# 次のオプションは、--dry-run およびアプリケーション呼び出しに使用されます。
wrapper.java.additional.1=-Xmx1g
wrapper.java.additional.1.scope=DRYRUN_APP

# 次のオプションは、ブートストラップ、--dry-run、およびアプリケーション呼び出しに使用されます。
wrapper.java.additional.2=-agentlib:mylib
wrapper.java.additional.2.scope=BOOTSTRAP_DRYRUN_APP

# 次のオプションはアプリケーション専用です。
wrapper.java.additional.3=-XX:NativeMemoryTracking=summary
wrapper.java.additional.3.scope=APP

対応バージョン :	3.5.16
対応エディション :
対応プラットフォーム :

一部のケースでは、Wrapper 設定ファイル内に Java パラメーターをリスト化すると、 不便な場合もあります。 このプロパティは、アプリケーションに渡される１つ以上の JVM 引数を含むファイルを指定する方法を提供します。 これは、パラメーターリストを動的に、またはインストーラーを介して生成する必要がある場合に非常に役立ちます。

標準の［wrapper.java.additional.<n>］プロパティで定義されたものが先で、 その後に、このファイル定義によるパラメーターが適用されます。

ファイルの記述形式：

ファイルの記述形式はシンプルです。

• まず、Wrapper 設定ファイルと同様に、 一行目にエンコードディレクティブを記載しなければなりません。 これは、Wrapper がファイルを読み込む際のエンコードを明示して、ファイルを正しく解釈するために必要です。 もし、このディレクティブ行が記述されていない場合、Wrapper は、ログに警告を記録して、処理の試みを続けます。 このファイルで利用されているエンコードが、他の設定ファイルのエンコードとは異なる場合もあります。
• 「#」記号は、コメント文字として解釈されますので、 プロパティ値に「#」記号を含める場合には、引用符で囲う（"#"）か、エスケープ文字として「#」をもう一つ書きます。
• デフォルトでは、コメントではない空でない行は、値が行全体にわたるパラメーターとして解釈されます。 この挙動は、［wrapper.app.parameter_file.quotable］プロパティを「TRUE」に設定することで変更できます。 このモードでは、引数は引用符で囲まれていないスペースで区切られます。 これにより、複数のパラメーターを同じ行に記述できます。 スペースを含む値は引用符で囲む必要があります。これらの引用符はファイルの解析中に削除されます。

@encoding=UTF-8
# 引数の例：1行に1つの引数
-DTEST1=Value1
-DTEST2=Value2 スペースを含む
-DTEST3=Value3 スペースを含む
-DTEST4=Value4

@encoding=UTF-8
# 引数の例：１行に複数のい引数
-DTEST1=Value1 -DTEST2="Value2 スペースを含む" "-DTEST3=Value3 スペースを含む"

# その他の引数
-DTEST4=Value4

対応バージョン :	3.5.36
対応エディション :
対応プラットフォーム :

このプロパティには、Java 追加ファイルが必要かどうか設定されます。 必要な時にそのファイルが検出できない場合、Wrapper は JVM を起動せず、停止します。 必要でない場合は検出されなくても無視されます。

デフォルト値は「TRUE」です。

wrapper.java.additional_file.required=FALSE

対応バージョン :	3.6.0
対応エディション :
対応プラットフォーム :

「TRUE」に設定すると、「追加ファイル」に含まれる引用符が削除されます。 これにより、引用符を値の区切り文字として使用し、複数の引数を1行に列挙できるようになります。

また、引用符を区切り文字として使用して、引数値の先頭または末尾のスペースを保持することもできます。

このプロパティのデフォルト値は「FALSE」です。

"-Dprop1=val 1" -Dprop1="val 2" -Dprop1=val3

「quotable」プロパティが「TRUE」に設定されている場合、 対応する値に含むべき引用符自体を保持するには、「\」文字でエスケープする必要があり、 バックスラッシュも二重にする必要があります（\\）。 その他の文字はエスケープできません。

引用符を削除すると、次の置換が行われます。

• 「\\」は、「\」になります
• 「\"」は、「"」になります
• 「"」は、「」になります

wrapper.java.additional_file.quotable=TRUE

@encoding=UTF-8
-DTEST1=Value1 -DTEST2="Test Value with spaces."

対応バージョン :	3.5.16 (No longer used as of 3.6.0)
対応エディション :
対応プラットフォーム :

プラットフォームによって、スペースを含むパラメーターの扱いが異なります。 特定の設定を一貫して動作させるには、これらの値は常に引用符で囲む必要があります。 Windows では、値はそのまま使用されますが、UNIX プラットフォームでは、コマンドラインが パラメーターリストに分割されるため、引用符は削除されます。

ほとんどの場合、これらの引用符を削除する必要があります。 デフォルト値は、「FALSE」です。

wrapper.java.additional_file.stripquotes=FALSE

@encoding=UTF-8
-DTEST1=Value1 -DTEST2="スペース を含むテスト値。"

• [ wrapper.app.parameter.<n> ] (1.0.0)

  Java アプリケーションのパラメーターを設定します。

• [ wrapper.app.parameter.<n>.quotable ] (3.6.0)

  アプリケーションパラメーター内の区切り文字として引用符を使用できるようになります。

• [ wrapper.app.parameter.backend ] (3.6.0)

  アプリケーションパラメーターをコマンドラインではなくバックエンド経由で渡すことを可能にします。

• [ wrapper.app.parameter_file ] (3.5.17)

  アプリケーションパラメーターを含むファイルのパスを指定します。

• [ wrapper.app.parameter_file.quotable ] (3.6.0)

  「パラメーターファイル」にリストされている値の区切り文字として引用符を使用できるようにします。

• [ wrapper.app.parameter_file.required ] (3.5.17)

  パラメーターファイルは必須かどうか設定します。

• [ wrapper.app.property.<n> ] (3.5.57)

  アプリケーション固有のプロパティがパイプまたはソケット経由で送信されるように設定します。

• [ wrapper.app.property.<n>.java_version.min ] (3.5.57) ( スタンダード版/プロフェッショナル版 )

  Java バージョンが指定された値以上の場合にのみ、インデックス「n」を持つアプリケーション プロパティを追加します。

• [ wrapper.app.property.<n>.java_version.max ] (3.5.57) ( スタンダード版/プロフェッショナル版 )

  Java バージョンが指定された値以下である場合にのみ、インデックス「n」を持つアプリケーションプロパティを追加します。

• [ wrapper.app.property.<n>.quotable ] (3.6.0)

  アプリケーションプロパティで引用符を区切り文字として使用できるようにします。

• [ wrapper.app.property_file ] (3.5.57)

  アプリケーションのプロパティを含むファイルのパスを指定します。

• [ wrapper.app.property_file.quotable ] (3.6.0)

  「プロパティファイル」にリストされている値の区切り文字として引用符を使用できるようにします。

• [ wrapper.app.property_file.required ] (3.5.57)

  プロパティファイルが必須かどうかを指定します。

• [ wrapper.java.additional.<n> ] (1.0.0)

  JVM へ引き渡す追加パラメーターを設定します。

• [ wrapper.java.additional.<n>.java_version.max ] (3.5.36) ( スタンダード版/プロフェッショナル版 )

  Java バージョンが指定された値よりも小さいか、それに等しい場合にのみ、インデックス「n」のオプションを追加します。

• [ wrapper.java.additional.<n>.java_version.min ] (3.5.36) ( スタンダード版/プロフェッショナル版 )

  バージョンが指定された値よりも大きいか、それに等しい場合にのみ、インデックス「n」のオプションを追加します。

• [ wrapper.java.additional.<n>.quotable ] (3.6.0)

  JVM パラメーター内の区切り文字として引用符を使用できるようになります。

• [ wrapper.java.additional_file ] (3.5.16)

  JVM パラメーターを含むファイルのパスを指定します。

• [ wrapper.java.additional_file.quotable ] (3.6.0)

  「追加ファイル」にリストされている値の区切り文字として引用符を使用できるようにします。

• [ wrapper.java.additional_file.required ] (3.5.36)

  Java 追加ファイルが必須かどうかを指定します。

• [ wrapper.java.mainclass ] (1.0.0)

  Wrapper が JVM を起動するときに呼び出すメインメソッドのあるクラスを指定します。

• [ wrapper.java.tmpdir.<x> ] (3.5.0)
• [ wrapper.java.tmpdir.required ] (3.5.0)

  Java 一時ディレクトリへ書き込みできないと検知した場合、Wrapper を終了するかどうかを指定します。

• [ wrapper.java.tmpdir.warn_silently ] (3.5.0)

  Java 一時ディレクトリへ書き込みできないときに「DEBUG」或いは「WARN」ログレベルでメッセージをログ化するかを指定します。