javah - C ヘッダとスタブファイルジェネレータ

javah は、Java(tm) クラスから C ヘッダファイルと C ソースファイルを作成します。これらのファイルは、Java プログラミング言語で書かれたコードと、C などのその他の言語で書かれたコードを接続する糊のような役目をし、コードが相互に作用するようにします。

機能説明

javah [ options ] classname. . .
javah_g [ options ] classname. . .

説明

javah は、ネイティブメソッドを実装するために必要な C ヘッダとソースファイルを生成します。作成されたヘッダとソースファイルは、ネイティブソースコードからオブジェクトのインスタンス変数を参照するために C プログラムによって使用されます。.h ファイルは、対応するクラスと一致する配置をもつ構造体定義を含みます。構造体のフィールドは、クラスのインスタンス変数に対応します。

ヘッダファイルとその中で宣言される構造体の名前はクラスの名前から派生します。javah に渡されるクラスがパッケージの中にある場合、パッケージ名はヘッダファイル名と構造体名の両方に付加されます。下線 ( _ ) が名前の区切り文字として使用されます。

デフォルトでは javah は、コマンド行にリストされる各クラスのヘッダファイルを作成し、現在のディレクトリにファイルを置きます。ソースファイルを作成するためには -stubs オプションを使用してください。1 つのファイルの中に、リストされたすべてのクラスの結果を連結するためには、-o オプションを使用してください。

新しいネイティブメソッドインタフェースの Java Native Interface (JNI) は、ヘッダ情報またはスタブファイルを必要としません。現行では、javah-jni オプションを使用して、JNI形式のネイティブメソッドに必要なネイティブメソッド機能プロトタイプを生成します。その結果は .h ファイルに置かれます。

javah_g は、jdb のようなデバッガに適した、javah の最適化されていないバージョンです。

オプション

-o outputfile
コマンド行にリストされたすべてのクラスに対して、結果のヘッダまたはソースファイルを連結して outputfile へ入れます。

-d directory
javah が、ヘッダファイルまたはスタブファイルを保存するディレクトリを設定します。

-td directory
javah が、一時ファイルを格納するディレクトリを設定します。デフォルトでは、javah は、一時ファイルを %TEMP% 環境変数によって指定されたディレクトリに格納します。%TEMP% が指定されていない場合、javah は %TMP% 環境変数のチェックを行います。そして最終的に、%TMP% が指定されていない場合、javah がディレクトリ C:\tmp を作成し、そこにファイルを格納します。

-stubs
javah に Java オブジェクトファイルから C 宣言を生成させます。

-v
詳細出力を指定し、作成ファイルの状態に関するメッセージを、javah に標準出力にプリントさせます。

-help
このメッセージをプリント出力します。

-trace
stubs ファイルにトレース情報を追加します。

-version
作成バージョンを出力します。

-jni
JNI 形式のネイティブファイルプロトタイプを含む出力ファイルを、javah が作成します。

-classpath path
クラスを探すために javah が使用するパスを指定します。デフォルトまたは CLASSPATH 環境変数の設定を上書きします。ディレクトリは、セミコロンで分割します。したがって、path のための一般形式は次のようになります。
   .;<your_path>
たとえば、パスの指定は次のとおりです。
   .;C:\users\dac\classes;C:\tools\java\classes

環境変数

CLASSPATH
ユーザ定義クラスへのパスをシステムに指定します。ディレクトリはセミコロンで分割します。たとえば、次のとおりです。
   .;C:\users\dac\classes;C:\tools\java\classes

参照

javac, java, jdb, javap, javadoc