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

警告

このプロパティの説明を読まずに、パラメータを変更することは絶対にしないで下さい。 設定を間違えると、期待どおりに動作せず、Wrapperの動作不良や不具合の原因となります。

Java Service Wrapper のJavaコンポーネントは、 システムシグナルの取り扱いを可能にしたり、 Java API を使えない他の機能を実行したりするために、 ネイティブライブラリーをロード（読み込み）しておく必要があります。 このプロパティでは、特有のアプリケーションのニーズに合わせて「ライブラリー名」を編集できるようになっています。 一般的に、ほとんどのユーザーは、このプロパティの利用は不要であると思われます。

Java言語は、どのようにJava ネイティブライブラリー (JNI)をネーミングするか、いくつかのルールを指定します。 Wrapperのライブラリーも例外ではなく、それらのネーミングの約束事に従わなければなりません。

これを説明するために、例として、デフォルトベース名「Wrapper」を使います。

設定例： 
wrapper.native_library=wrapper
  • Windowsシステム上で、 ライブラリーファイル名は「wrapper.dll」です。
  • Mac OSX システム上で、 ライブラリーファイル名「libwrapper.jnilib」です。
  • 他の全てのLinux/UNIXプラットフォーム上で、 ライブラリーファイル名「libwrapper.so」です。

もし、このプロパティに、何か他の値が与えられている場合、 上記のルールを使っている実際のネイティブライブラリーファイル名を構成するために、 その基本名が利用されます。

ライブラリーパス：

名前の指定に関わらず、ネイティブライブラリーは、 ［wrapper.java.library.path.<n>］ プロパティを使って指定しているディレクトリー内に配置されていなければなりません。

プラットフォーム仕様によるネイティブライブラリー：

Wrapperでは、たとえアプリケーションがネイティブライブラリーを利用していたとしても、 どんなプラットフォーム上でも動作するバイナリ配布を、簡単に作成できるように、ファシリティを提供しています。 詳しくは、プラットフォーム仕様によるネイティブライブラリーをご覧ください。

参照： ライブラリー
  • [ wrapper.java.library.path.<n> ] (2.2.9)

    Wrapper や Java アプリケーションが利用するネイティブライブラリーを含むディレクトリのリストを指定します。

  • [ wrapper.java.library.path.append_system_path ] (3.1.0)

    環境変数 PATH の内容を Java ライブラリパスに追加します。

  • [ wrapper.native_library ] (3.1.0)

    Wrapper のネイティブライブラリーのベース名を設定します。

  • [ wrapper.working.dir ] (3.1.0)

    作業ディレクトリのパスを指定します。