• ［wrapper.app.property.<n>］プロパティ群
• ［wrapper.app.property.<n>.quotable］プロパティ群
• ［wrapper.app.property.<n>.java_version.min］プロパティ群
• ［wrapper.app.property.<n>.java_version.max］プロパティ群
• ［wrapper.app.property_file］プロパティ
• ［wrapper.app.property_file.required］プロパティ
• ［wrapper.app.property_file.quotable］プロパティ

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

接続が確立された後、Wrapper からバックエンドパイプまたはソケット経由で JVM に送信されるアプリケーション固有のプロパティのリストです。

ユーザーアプリケーションは、すべてのプロパティが受信され、Java 側に設定された後に起動します。 これにより、アプリケーションの起動時にすべてのプロパティが利用可能であることが保証されます。

［wrapper.app.property.<n>］プロパティを使用することは、プロセス一覧表示ツールにプレーンテキストで露出してしまう ［wrapper.java.additional.<n>］を設定するよりも安全です。 そのため、パスワードやアプリケーションが使用する機密データには、アプリケーションプロパティを使用することを強くお勧めします。

設定ファイルに保存されているデータを保護するためのベストプラクティスは、機密値を含む［wrapper.app.property.<n>］プロパティを別の 「インクルードファイル」に隔離し、制限付きの読み取り権限（管理者または所有者のみなど）を割り当てることです。

さらに、パスワードや機密データが Wrapper のログ出力にプレーンテキストとして出力されるのを防ぐために、%...|mask% 構文を使用してください。

【<n> コンポーネント部】

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

wrapper.app.property.1=mypassword=%secret|mask%

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

プロパティ値に末尾のスペースを含める必要がある場合は、値を引用符で囲うことでそれらを保持できます。 対応する［wrapper.app.property.<n>.quotable］プロパティを「TRUE」に設定すると、これらの引用符は除去されます。

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

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

引用符を除去する際、以下の置換が行われます。

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

wrapper.app.property.1=prop1="value with trailing spaces   "
wrapper.app.property.1.quotable=TRUE

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

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

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

値は Java のバージョンに関係なく、「1.major[.minor[_revision]]」または「major[.minor[.revision]]」の形式にすることができます。 これは「java -version」によって返される両方の番号付けスキームをサポートするために行われます。Java 9 より前は最初の形式が使用され、Java 9 以降は２番目の形式が使用されます。

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

wrapper.app.property.<n>.java_version.min=1.7

wrapper.app.property.<n>.java_version.min=8.0.40

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

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

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

値は Java のバージョンに関係なく、「1.major[.minor[_revision]]」または「major[.minor[.revision]]」の形式にすることができます。 これは「java -version」によって返される両方の番号付けスキームをサポートするために行われます。 Java 9 より前は最初の形式が使用され、Java 9 以降は２番目の形式が使用されます。

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

wrapper.app.property.<n>.java_version.max=9.0.1

wrapper.app.property.<n>.java_version.max=9

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

このプロパティは、Java アプリケーションに渡す１つ以上のプロパティを含むファイルを指定する方法を提供します。 これは、プロパティリストを動的に生成する必要がある場合や、インストーラー経由で生成する必要がある場合に非常に便利です。

このファイルで定義されたプロパティは、標準の［wrapper.app.property.<n>］プロパティを 使用して定義されたプロパティの後に表示されます。

Wrapper ver. 3.5.23 以降、ファイル内の 環境変数 の参照は展開されます。

【ファイルの記述形式】

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

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

@encoding=UTF-8
# サンプルプロパティ：1行に1つのプロパティ
prop1=Value1
prop2=Value2 with space
prop3=Value3 with space
prop4=Value4

@encoding=UTF-8
# サンプルプロパティ：1行に複数のプロパティ
prop1=Value1 prop2="Value2 with space" "prop3=Value3 with space"

# その他の引数
prop4=Value4

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

プロパティファイルが必須かどうかを指定します。 必須でありながら見つからない場合、Wrapper は JVM を起動せずに停止します。 必須でない場合、ファイルが見つからないときは無視されます。

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

wrapper.app.property_file.required=FALSE

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

「TRUE」に設定すると、プロパティファイルに含まれる引用符が除去されます。 これにより、値の区切り文字として引用符を使用できるようになり、単一の行に複数のパラメーターーをリストできます。

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

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

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

引用符を除去する際、以下の置換が行われます。

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

wrapper.app.property_file.quotable=TRUE

@encoding=UTF-8
prop1=Value1 prop2="Test Value with spaces."

• [ 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.stop.parameter.<n> ] (3.7.0)

  アプリケーションを停止するときに使用するパラメーターを設定します。

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

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

• [ wrapper.app.stop.parameter_file ] (3.7.0)

  アプリケーションを停止するときに使用する引数が含まれる停止パラメーターファイルへのパスを指定します。

• [ wrapper.app.stop.parameter_file.quotable ] (3.7.0)

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

• [ wrapper.app.stop.parameter_file.required ] (3.7.0)

  停止パラメーターファイルが必要かどうかを指定します。

• [ 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」ログレベルでメッセージをログ化するかを指定します。