• コンフィギュレーション・プロパティの概要
• プロパティ一覧（カテゴリー別）
• プロパティ一覧（名前別）

Wrapperでは、いかなるコンフィギュレーション・プロパティでも コマンドラインから設定できるようになっています。 そのため、コンフィギュレーション値がランタイムの環境下だけで設定される場合に便利に使うことができます。 一例として、Wrapperに同梱して提供しているシェルスクリプト（sh）を見てみましょう。

Wrapperの起動時に、コンフィギュレーション・ファイルを読み込み、そのプロパティ（設定値）を読みとることにより、 コマンドライン上で、コンフィギュレーション・プロパティを設定することができます。 各プロパティは、「プロパティ名＝プロパティ値」の構成で成り立っています。 「wrapper.conf」ファイルに見られるように、 このシンタックス（構造文法ルール）は、常に同じです。

利用例：

この例では、Wrapperを使って、デバックのログ化を有効にして、 あるJavaアプリケーションを起動させています。

wrapper.exe -c ..\conf\wrapper.conf wrapper.java.command=java wrapper.debug=TRUE

./wrapper ../conf/wrapper.conf wrapper.java.command=java wrapper.debug=TRUE

優先度：

コマンドラインで設定するプロパティは、他のデフォルトのプロパティよりも優先され、 コンフィギュレーション・ファイル内で設定されているデフォルトのプロパティ値や、 コンフィギュレーション・ファイル参照を含めたインクルード・ファイル（カスケード形式）を上書きします。

Wrapper コマンドを使うとき、どんなコマンドでも、コマンドラインからプロパティを指定することができます。 Windowsシステム上でアプリケーションを１つのサービスとしてインストールするために使われる、 ［-i］コマンドなどを含みます。

Wrapperが動作している状態で、 ［-c］コマンドを使ってコンソール・アプリケーションとしてJVMを動かしている時、 そこで指定されたプロパティがある場合は、 デフォルトの「wrapper.conf」の値を上書きして、 そして、JVMを起動するときに利用されます。

同様に、Wrapperを１つのサービスとしてインストールするために使われる ［-i］コマンドは、指定されたプロパティを記憶しておき、 あとで実際にサービスとしてスタートしたときに、その記憶しておいたプロパティを使います。 同様に、サービスがインストールされている間は、 「wrapper.conf」の値を上書きして、 コマンドラインで指定されたプロパティが使われます。

そのほか全てのコマンドでも、コンフィギュレーション・ファイルの値を上書きして、 コマンドライン・プロパティを使います。 これで、そのサービスを参照する手段やログ化をもたらし、JVMが動作している上では効果はありません。 例えば、［-t］コマンドを使って開始している間、 サービスへプロパティ値を渡すことは不可能です。

スペース（空白）の取り扱い：

注意

コマンドラインで指定するプロパティに、引用符で囲まずにスペース（空白）を含めることはできません。 もしプロパティ値にスペース（空白）を含める必要がある場合には、 単純に、そのプロパティ・セット（プロパティ名とその値）の全体を、開始と終わりの引用符（“　”）で囲ってください： パス値にスペース（空白）が含まれる例: wrapper.exe -c ..\conf\wrapper.conf "wrapper.java.command=C:\My App\jre\bin\java.exe"

Windowsでの引用問題：

注意

Windows上でパスの値を引用するとき、 Windowsが引用符で囲まれた値を解体して解釈してしまうという問題がありますので覚えておいてください。 通常は引用符で囲まれた値の中で、トレーリング・バックスラッシュを除き、 全てのバックスラッシュ（'\'）を通常どおりに取り扱います。下記の例を見てみると、 トレーリング・バックスラッシュが引用符をエスケープしており、結果として、 意図としない引数が、Wrapperへ引き渡されています。 問題の例: wrapper.exe -c ..\conf\wrapper.conf "wrapper.working.dir=C:\" wrapper.debug=TRUE" 本来この意図とするオペレーションは、 引数（ ［-c］、 ［..\conf\wrapper.conf］、 ［wrapper.working.dir=C:\］、 ［wrapper.debug=TRUE］ ）を用いてWrapperを呼び出すことです。 しかし、実際に起きていることは、２つ目の引用符がエスケープとして解釈されてしまい、 結果として、それに続く３つ目と４つ目の引数が結合されてしまい、 ［wrapper.working.dir=C:" wrapper.debug=TRUE］となっています。 まず簡単な解決策としては、トレーリング・バックスラッシュを使わない、ということです。 しかしながら、今回の例「C:\」では、それは不可能です。 従って、他の解決策としては、バックスラッシュの後に、トレーリング・ピリオドを追加する、ということです。 つまり、「C:\.」の明記は、 「C:\」ディレクトリーと同じ意味になりますが、 Windowsによっては、正しく解釈されます。 改善策の例: wrapper.exe -c ..\conf\wrapper.conf "wrapper.working.dir=C:\." wrapper.debug=TRUE"

If you notice something that is incorrect, missing, or simply feel that some part of this page could be explained better, feel free to log in and add a comment. You will need to register before you can log on.