javah - C ヘッダーとスタブファイルジェネレータ
javah は、Java クラスから C ヘッダーファイルと C ソースファイルを作成します。これらのファイルは、Java プログラミング言語で書かれたコードと、C などのその他の言語で書かれたコードを接続し、コードが相互に作用するようにします。
形式
javah [ options ] fully-qualified-classname. . .
説明
javah は、ネイティブメソッドを実装するために必要な C ヘッダーとソースファイルを生成します。作成されたヘッダーとソースファイルは、ネイティブソースコードからオブジェクトのインスタンス変数を参照するために C プログラムによって使用されます。.h ファイルは、対応するクラスと一致する配置を持つ構造体定義を含みます。構造体のフィールドは、クラスのインスタンス変数に対応します。
ヘッダーファイルとその中で宣言される構造体の名前はクラスの名前から派生します。javah に渡されるクラスがパッケージの中にある場合、パッケージ名はヘッダーファイル名と構造体名の両方に付加されます。下線 (_) が名前の区切り文字として使用されます。
デフォルトでは javah は、コマンド行にリストされる各クラスのヘッダーファイルを作成し、現在のディレクトリにファイルを置きます。ソースファイルを作成するには、-stubs オプションを使用してください。1 つのファイルの中に、リストされたすべてのクラスの結果を連結するには、-o オプションを使用してください。
新しいネイティブメソッドインタフェースである Java Native Interface (JNI) は、ヘッダー情報またはスタブファイルを必要としません。現在では、javah は、JNI 形式のネイティブメソッドに必要なネイティブメソッド機能プロトタイプを生成します。デフォルトでは、javah は JNI 形式で出力され、その結果は .h ファイルに格納されます。
オプション
- -o outputfile
- コマンド行にリストされたすべてのクラスに対して、結果のヘッダーまたはソースファイルを連結して outputfile に格納します。-o または -d のどちらか一方だけが使われます。
- -d directory
- javah がヘッダーファイルまたはスタブファイルを保存する、ディレクトリを設定します。-d または -o のどちらか一方だけが使われます。
- -stubs
- javah が、Java オブジェクトファイルから C 宣言を生成します。
- -verbose
- 詳細出力を指定し、生成されるファイルのステータスに関するメッセージを、javah が標準出力に出力します。
- -help
- javah の使用法についてのヘルプメッセージを出力します。
- -version
- javah のバージョン情報を出力します。
- -jni
- JNI 形式のネイティブメソッド機能プロトタイプを含む出力ファイルを、javah が作成します。これは標準出力であるため、-jni の使用はオプションです。
- -classpath path
- javah がクラスを探すために使用するパスを指定します。デフォルトまたは CLASSPATH 環境変数設定を上書きします。ディレクトリはセミコロンで分割します。したがって、path の一般形式は次のようになります。
.;<your_path>
たとえば、.;C:\users\dac\classes;C:\tools\java\classes
便宜上、
*のベース名を含むクラスパス要素は、ディレクトリ内の拡張子.jarまたは.JARを持つすべてのファイルのリストを指定するのと同じとみなされます (Java プログラムはこの 2 つの呼び出しを区別できない)。
たとえば、ディレクトリfooにa.jarとb.JARが含まれている場合、クラスパス要素foo/*はA.jar:b.JARに展開されます (JAR ファイルの順番は不確定)。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべての JAR ファイルが含まれます。*だけから成るクラスパスエントリは、カレントディレクトリ内のすべての JAR ファイルのリストに展開されます。CLASSPATH環境変数 (定義されているとき) も同様に展開されます。クラスパスのワイルドカード展開は必ず、Java 仮想マシンの起動前に実行されます。たとえば、System.getenv("CLASSPATH") を呼び出すことで。 - -bootclasspath path
- ブートストラップクラスをロードするパスを指定します。ブートストラップクラスは、デフォルトでは jre\lib\rt.jar およびほかのいくつかの JAR ファイルにある、コア Java プラットフォームを実装するクラスです。
- -old
- 古い JDK1.0 形式のヘッダーファイルを生成するように指定します。
- -force
- 出力ファイルが常に書き込まれるように指定します。
- -Joption
- Java 仮想マシンに option を渡します (option は、「Java アプリケーション起動ツール」のリファレンスページに記載されているいずれかのオプション)。たとえば、-J-Xms48m と指定すると、スタートアップメモリーは 48M バイトに設定されます。
環境変数
- CLASSPATH
- ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはセミコロンで分割されています。次に例を示します。
.;C:\users\dac\classes;C:\tools\java\classes