javah

javahツールは、JavaクラスからCヘッダー・ファイルおよびソース・ファイルを生成する場合に使用します。

注意:

javahツールは、JDK 9から非推奨となり、将来のJDKリリースでは削除される可能性があります。このツールは、JDK 8でjavacに追加された-hオプションに置き換えられています。

形式

javah [options] fully-qualified-class-name ...

options

コマンド行オプションを指定します。「javahのオプション」を参照してください。

fully-qualified-class-name

Cヘッダー・ファイルおよびソース・ファイルに変換されるクラスの完全修飾された場所を指定します。

各クラスは、完全修飾名で指定する必要があり、オプションで先頭にモジュール名と続けてスラッシュ(/)を指定することもできます。例:

java.lang.Object

java.base/java.io.File

説明

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

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

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

Java Native Interface (JNI)は、ヘッダー情報やスタブ・ファイルを必要としません。引き続きjavahコマンドを使用して、JNI形式のネイティブ・メソッドに必要なネイティブ・メソッド機能プロトタイプを生成できます。javahコマンドは、JNI形式の出力を生成し、その結果を.hファイルに格納します。

javahのオプション

注意:

--形式のオプションをサポートするツールでは、GNU形式のオプションで空白のかわりに等号(=)を使用して、オプションの名前とその値を区切ることができます。

-o outputfile

コマンド行にリストされたすべてのクラスに対して、結果のヘッダーまたはソース・ファイルを連結して出力ファイルに格納します。オプション-oまたは-dのどちらか一方のみを使用できます。

-d directory

javahコマンドがヘッダー・ファイルまたはスタブ・ファイルを保存するディレクトリを設定します。オプション-dまたは-oのどちらか一方のみを使用できます。

-vまたは-verbose

詳細出力を指定し、javahコマンドが生成したファイルのステータスに関するメッセージをstdoutに出力するようにします。

-h、-helpまたは-?

javahの使用法についてのヘルプ・メッセージを出力します。

-version

javahコマンドのリリース情報を出力します。

-jni

javahコマンドがJNI形式のネイティブ・メソッド機能プロトタイプを含む出力ファイルを作成するようにします。これはデフォルトの出力であり、-jniの使用はオプションです。

-force

出力ファイルが常に書き込まれるように指定します。

--module-path path

アプリケーション・モジュールのロード元となるパスを指定します。

--system jdk

システム・モジュールの検索場所を指定します。

--class-path path、-classpath pathまたは-cp path

javahコマンドでクラスを探すために使用するパスを指定します。デフォルトまたはCLASSPATH環境変数(設定されている場合)をオーバーライドします。ディレクトリは、Oracle Solarisではコロンで区切り、Windowsではセミコロンで区切ります。pathの一般的な形式は次のようになります。

Oracle Solaris、LinuxおよびOS X:

:your-path

例: :/home/avh/classes:/usr/local/java/classes
Windows:

;your-path

例: ;C:\users\dac\classes;C:\tools\java\classes

便宜上、アスタリスク(*)付きのベース名を含むクラス・パス要素は、ディレクトリ内の拡張子.jarまたは.JARを持つすべてのファイルのリストを指定するのと同じと見なされます。

たとえば、ディレクトリmydirにa.jarとb.jarが含まれている場合、クラス・パス要素mydir/*はa.jar:b.JARに展開されますが、JARファイルの順番は決まっていません。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべてのJARファイルが含まれます。アスタリスク(*)からなるクラス・パス・エントリは、現在のディレクトリ内のすべてのJARファイルのリストに展開されます。CLASSPATH環境変数(定義されているとき)も同様に展開されます。クラス・パスのワイルドカード展開は、Java仮想マシン(JVM)の起動前に実行されます。System.getenv("CLASSPATH")の呼出しなどによって環境を照会しないかぎり、Javaプログラムが展開されていないワイルドカードを認識することはありません。

-bootclasspath path

ブートストラップ・クラスをロードするパスを指定します。