HOWTO: JNI 依存ライブラリー用のライブラリーパスの設定方法
対応バージョン :2.2.9
対応エディション :プロフェッショナル版スタンダード版コミュニティー版
対応プラットフォーム :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

Java は、［java.library.path.］ システムプロパティで定義されたパスを検索して、ネイティブライブラリー（JNI）をロード（読み込み）します。 Java Service Wrapper では、 ［wrapper.java.library.path.<n>］ プロパティを活用することで、プラットフォームに依存しない独立型でも、とても簡単にこのパスの設定することができます。

次の例では、「../lib/」と「../lib2/」 ディレクトリーで JNI ライブラリーを検索するライブラリーパスを設定しています： 

wrapper.java.library.path.1=../lib/
wrapper.java.library.path.1=../lib2/

ほとんどの JNI ライブラリーでは、これで十分ですが、 一部のライブラリーでは、その他のリンクされたライブラリーをダイナミック（動的）に活用します。 Java は、Java ライブラリーパスを使い、初期 JNI ライブラリーを配置しますが、 セカンダリーライブラリーは、そのプラットフォームのデフォルトメカニズムを使い、ロード（読み込み）されます。

Windows システムでは、まず現在の作業ディレクトリー （「wrapper.exe」の配置場所）を覗き、その後、 「Windows system32」ディレクトリーと Windows ディレクトリーを覗きます。 最後に、システムパス「PATH」全体を検索します。 もし両方の DLL ファイルが自分のアプリケーションの「lib」ディレクトリー に配置されていた場合、次のように、そのパスをシステムパスに追加する必要があるかもしれません。 その「set.PATH」は Windows 用の設定であり、 「set.LD_LIBRARY_PATH」は、 クロスプラットフォーム向けのコンフィギュレーションファイル用の設定であるため、UNIX システム上でも同様に動作します。 Mac OSX では、「set.DYLD_LIBRARY_PATH」変数も活用できます。 

set.PATH=..%WRAPPER_FILE_SEPARATOR%lib%WRAPPER_PATH_SEPARATOR%%PATH%
set.LD_LIBRARY_PATH=..%WRAPPER_FILE_SEPARATOR%lib%WRAPPER_PATH_SEPARATOR%%LD_LIBRARY_PATH%
set.DYLD_LIBRARY_PATH=..%WRAPPER_FILE_SEPARATOR%lib%WRAPPER_PATH_SEPARATOR%%DYLD_LIBRARY_PATH%

現在の作業ディレクトリーの中でなく、 「PATH」上に、セカンダリーライブラリーを配置すると、 他のアプリケーションによってインストールされた古いバージョンのライブラリーが、 「Windows system32」ディレクトリーで 競合するかもしれないというリスクがありますので、ご注意ください。 これは、システムがファイルを検索する順番によるものです。

この問題は、システム上に SAP アプリケーションもインストールされている場合に、 SAP の JCO ライブラリーの動作にも見られることです。

さらに詳細は［wrapper.java.library.path.<n>］プロパティ をご覧ください。