wrapper.java.classpath.<n> プロパティ群

対応バージョン :1.0.0
対応エディション :プロフェッショナル版スタンダード版コミュニティー版
対応プラットフォーム :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

このプロパティには、利用するJavaクラスパスを設定します。 アプリケーションを起動するときに使う様々なクラスパスエレメントをリストアップしたプロパティシリーズが必要なはずです。

このリストには、「wrapper.jar」ファイルが含まれていなければなりません。 また、クラスファイルを含んでいるディレクトリー同様に、「jar」ファイルを含めることができます。

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

各エレメントは「プロパティ名」を持ち、その名前は [wrapper.java.classpath.]で始まり、 プロパティ名の「<n>」コンポーネント部には、 「1」からカウントアップしていくインテージャー(整数値)のナンバリング数値を入れて指定します。 デフォルトでは、連番であり欠番で飛ぶことはないはずです。 [wrapper.ignore_sequence_gaps] プロパティで、シーケンス内でギャップ(途切れ)検索を「許可する/許可しない」を任意に設定にすることができます。

設定例:
wrapper.java.classpath.1=../lib/wrapper.jar
wrapper.java.classpath.2=../lib/myapp.jar
wrapper.java.classpath.3=../lib/mysql.jar
wrapper.java.classpath.4=../classes

もしクラスパスエントリー内部でワイルドカード文字を利用する場合には、 該当する全てのファイルがクラスパスへ追加され、JVMインスタンスを起動するときに利用されます。

有効なワイルドカード文字は次のとおり:

  • [*] 文字は、「0 (ゼロ)」や複数文字が該当します
  • [?] 文字は、キッチリ1文字に該当します

ソート(並び替え):

Wrapperバージョン3.3.8から、 Wrapperは、ワイルドカード文字を含む個別のクラスパスプロパティが該当する jarファイルリストをソート(並び替え)します。 これは、アプリケーションのインストール全てにおいて、 正確に同じクラスパスが使われていることを確認するために実施されます。 通常は、これは問題になりませんが、しかしながら時折、リソースファイルやクラスが、 1つ以上のjarで重複していることがあります。 jarの順番をコントロールすることで、 同じバージョンが常に利用されている、という保証になります。

設定例:
wrapper.java.classpath.1=../lib/*.jar
wrapper.java.classpath.2=../classes

環境変数を利用する:

もし、Wrapperのクラスパスの一部として、クラスパスを定義するシステムを含めたい場合には、 適切な環境変数を参照することで解決できます。 その結果となる「wrapper.conf」ファイルは、 なおもクロスプラットフォーム互換であり続けることができます。 なぜならば、含まれているクラスパスのパスセパレーターは、現在のプラットフォームに対して常に正しいからです。

環境変数を利用した設定例:
wrapper.java.classpath.1=%CLASSPATH%

問題?:

もしクラスパスに関連する問題に遭遇した場合には、まず最初にするべきことは、 Wrapperによって生成された完全なフルクラスパスを確認することです。 そうするためには、 [wrapper.debug] プロパティを使ってデバッグのログ出力を有効にするか、 [wrapper.java.command.loglevel] プロパティを使ってJavaコマンドの表示を有効にしてください。

注意

スペースを含むクラスパスエントリー:

Wrapperでは、スペース(空白)を含むクラスパスエレメントを正しく取り扱います。 最終の生成されたクラスパスを引用符で囲むことでWrapperが自動的に処理します。 個別のクラスパスエレメントのプロパティ値は、スペース(空白)を含んでいても 引用符を含む定義をするべきではありません。

参照: クラスパス