." Copyright (c) 1994, 2011, Oracle and/or its affiliates. All rights reserved.

." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

."

." This code is free software; you can redistribute it and/or modify it

." under the terms of the GNU General Public License version 2 only, as

." published by the Free Software Foundation.

."

." This code is distributed in the hope that it will be useful, but WITHOUT

." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

." FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License

." version 2 for more details (a copy is included in the LICENSE file that

." accompanied this code).

."

." You should have received a copy of the GNU General Public License version

." 2 along with this work; if not, write to the Free Software Foundation,

." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

."

." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA

." or visit www.oracle.com if you need additional information or have any

." questions.

."

.TH javac 1 "07 May 2011"

.LP

.SH "名前"

javac \- Java プログラミング言語コンパイラ

.LP

.RS 3

.TP 2

o

形式 

.TP 2

o

説明 

.TP 2

o

オプション 

.TP 2

o

コマンド行引数ファイル 

.TP 2

o

注釈処理 

.TP 2

o

型の検索 

.TP 2

o

プログラマティックインタフェース 

.TP 2

o

例 

.TP 2

o

関連項目 

.RE

.LP

.SH "形式"

.LP

.nf

\f3

.fl

        \fP\f3javac\fP [ options ] [ sourcefiles ] [ classes ] [ @argfiles ]

.fl

.fl

.fi

.LP

.LP

引数は順不同です。

.LP

.RS 3

.TP 3

options 

コマンド行オプション。 

.TP 3

sourcefiles 

コンパイルされる 1 つ以上のソースファイル (MyClass.java など) 

.TP 3

classes 

注釈の処理対象となる 1 つ以上のクラス (MyPackage.MyClass など) 

.TP 3

@argfiles 

オプションとソースファイルを列挙した 1 つ以上のファイル。このファイルの中では \f2\-J\fP オプションは指定できません。 

.RE

.LP

.SH "説明"

.LP

.LP

\f3javac\fP ツールは、Java プログラミング言語で記述されたクラスとインタフェースの定義を読み取り、バイトコードのクラスファイルにコンパイルします。また、Java ソースファイルおよびクラス内の注釈の処理も行います。

.LP

.LP

ソースコードのファイル名を \f3javac\fP に渡すには、次の 2 つの方法があります。

.LP

.RS 3

.TP 2

o

ソースファイルの数が少ない場合は、ファイル名をコマンド行で直接指定します。 

.TP 2

o

ソースファイルの数が多い場合は、ファイル名を空白または改行で区切って、1 つのファイルに列挙します。次に、このリストファイル名の先頭に \f3@\fP を付けて、\f3javac\fP のコマンド行で指定します。 

.RE

.LP

.LP

ソースコードのファイル名は \f2.java\fP 拡張子を、クラスのファイル名は \f2.class\fP 拡張子を持っていなければなりません。また、ソースファイルとクラスファイルのどちらも、該当するクラスに対応するルート名を持っていなければなりません。たとえば、 \f2MyClass\fP という名前のクラスは、 \f2MyClass.java\fP という名前のソースファイルに記述します。このソースファイルは、 \f2MyClass.class\fP という名前のバイトコードクラスファイルにコンパイルされます。

.LP

.LP

内部クラスが定義されていると、追加のクラスファイルが生成されます。これらのクラスファイルの名前は、 \f2MyClass$MyInnerClass.class\fP のように、外部クラス名と内部クラス名を組み合わせたものになります。

.LP

.LP

ソースファイルは、パッケージツリーを反映したディレクトリツリーに配置する必要があります。たとえば、すべてのソースファイルを \f3/workspace\fP に置いている場合、 \f2com.mysoft.mypack.MyClass\fP のソースコードは \f3/workspace/com/mysoft/mypack/MyClass.java\fP にある必要があります。

.LP

.LP

デフォルトでは、コンパイラは、各クラスファイルを対応するソースファイルと同じディレクトリに置きます。別の出力先ディレクトリを指定するには、\f3\-d\fP を使用します (このあとのオプションを参照)。

.LP

.SH "オプション"

.LP

.LP

コンパイラには、現在の開発環境でサポートされており、将来のリリースでもサポートされる標準オプションのセットがあります。これ以外の非標準オプションは、現在の仮想マシンおよびコンパイラの実装に固有のオプションで、将来に変更される可能性があります。非標準オプションは、\f3\-X\fP で始まります。

.LP

.SS 

標準オプション

.LP

.RS 3

.TP 3

\-Akey[=value] 

注釈プロセッサに渡されるオプション。これらは、javac によって直接解釈されず、個々のプロセッサによって使用されます。\f2key\fP には、1 つまたは複数の識別子を「.」で区切ったものを指定してください。 

.TP 3

\-cp path または \-classpath path 

ユーザーのクラスファイルおよび (場合によっては) 注釈プロセッサやソースファイルの検索場所を指定します。このクラスパスは \f3CLASSPATH\fP 環境変数のユーザークラスパスをオーバーライドします。\f3CLASSPATH\fP、\f3\-cp\fP、\f3\-classpath\fP のいずれも指定されていない場合、ユーザークラスパスは、現在のディレクトリになります。詳細は、「クラスパスの設定」を参照してください。 

.LP

\f3\-sourcepath\fP オプションが指定されていない場合は、ソースファイルもユーザークラスパスから検索されます。 

.LP

\f3\-processorpath\fP オプションが指定されていない場合は、注釈プロセッサもユーザークラスパスから検索されます。  

.TP 3

\-Djava.ext.dirs=directories 

インストール型拡張機能の位置をオーバーライドします。 

.TP 3

\-Djava.endorsed.dirs=directories 

承認された標準パスの位置をオーバーライドします。 

.TP 3

\-d directory 

クラスファイルの出力先ディレクトリを設定します。そのディレクトリはすでに存在している必要があります。\f3javac\fP は作成しません。クラスがパッケージの一部である場合、\f3javac\fP は、必要に応じてディレクトリを作成し、パッケージ名を反映したサブディレクトリにクラスファイルを置きます。たとえば、\f3\-d /home/myclasses\fP と指定し、クラスの名前が \f2com.mypackage.MyClass\fP である場合、クラスファイルは \f2/home/myclasses/com/mypackage/MyClass.class\fP になります。 

.LP

\f3\-d\fP が指定されなかった場合、\f3javac\fP は各クラスファイルを、その生成元となるソースファイルと同じディレクトリ内に格納します。 

.LP

\f3注:\fP \f3\-d\fP で指定したディレクトリはユーザークラスパスに自動的には追加されません。  

.TP 3

\-deprecation 

推奨されないメンバーやクラスが、使用またはオーバーライドされるたびに説明を表示します。\f3\-deprecation\fP が指定されていない場合、\f3javac\fP は、推奨されないメンバーやクラスを使用またはオーバーライドしているソースファイルの要約を表示します。\f3\-deprecation\fP は \f3\-Xlint:deprecation\fP の省略表記です。 

.TP 3

\-encoding encoding 

ソースファイルのエンコーディング名 ( \f2EUC\-JP や UTF\-8\fP など) を指定します。\f3\-encoding\fP が指定されていない場合は、プラットフォームのデフォルトコンバータが使われます。  

.TP 3

\-endorseddirs directories 

承認された標準パスの位置をオーバーライドします。 

.TP 3

\-extdirs directories 

\f2ext\fP ディレクトリの位置をオーバーライドします。\f2directories\fP 変数には、コロンで区切ったディレクトリのリストを指定します。指定したディレクトリ内の各 JAR アーカイブから、クラスファイルが検索されます。見つかったすべての JAR アーカイブは自動的にクラスパスの一部になります。 

.LP

クロスコンパイル (異なる Java プラットフォームに実装されたブートストラップクラスや拡張機能クラスに対してコンパイルを行う) を実行する場合、このオプションには拡張機能クラスを含むディレクトリを指定します。詳細は、「クロスコンパイルオプション」を参照してください。  

.TP 3

\-g 

局所変数を含むすべてのデバッグ情報を生成します。デフォルトでは、行番号およびソースファイル情報だけが生成されます。 

.TP 3

\-g:none 

デバッグ情報を生成しません。 

.TP 3

\-g:{keyword list} 

コンマで区切られたキーワードリストにより指定された、特定の種類のデバッグ情報だけを生成します。次のキーワードが有効です。 

.RS 3

.TP 3

source 

ソースファイルのデバッグ情報 

.TP 3

lines 

行番号のデバッグ情報 

.TP 3

vars 

局所変数のデバッグ情報 

.RE

.TP 3

\-help 

標準オプションの形式を表示します。 

.TP 3

\-implicit:{class,none} 

暗黙的にロードされたソースファイルに対するクラスファイルの生成を制御します。クラスファイルを自動生成するには、\f3\-implicit:class\fP を使用します。クラスファイルの生成を抑制するには、\f3\-implicit:none\fP を使用します。このオプションが指定されなかった場合のデフォルト動作は、クラスファイルの自動生成になります。その場合、そのようなクラスファイルが生成された時に注釈処理も実行されると、コンパイラから警告が発行されます。このオプションが明示的に設定された場合には、警告は発行されません。「型の検索」を参照してください。  

.TP 3

\-Joption 

\f3javac\fP が呼び出す \f3java\fP 起動ツールに、\f2option\fP を渡します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。 

.LP

\f3注:\fP \f3CLASSPATH\fP、\f3\-classpath\fP、\f3\-bootclasspath\fP、および \f3\-extdirs\fP は、\f3javac\fP を実行するために使うクラスを指定するものではありません。このような方法でコンパイラの実装を操作することは、通常は無意味であり、常に危険を伴います。このような方法を使う必要がある場合は、\f3\-J\fP オプションを使って、必要なオプションを背後の \f3java\fP 起動ツールに渡してください。  

.TP 3

\-nowarn 

警告メッセージを無効にします。これは \f3\-Xlint:none\fP と同じ意味です。 

.TP 3

\-proc: {none,only} 

注釈処理、コンパイル、その両方、のいずれを実行するかを制御します。\f3\-proc:none\fP は、注釈処理なしでコンパイルが実行されることを意味します。\f3\-proc:only\fP は、注釈処理だけが実行され、後続のコンパイルはまったく実行されないことを意味します。 

.TP 3

\-processor class1[,class2,class3...] 

実行する注釈プロセッサの名前。これを指定した場合、デフォルトの検索処理は省略されます。 

.TP 3

\-processorpath path 

注釈プロセッサの検索場所を指定します。このオプションを使用しなかった場合、クラスパス内でプロセッサの検索が行われます。 

.TP 3

\-s dir 

生成されたソースファイルの格納先となるディレクトリを指定します。そのディレクトリはすでに存在している必要があります。\f3javac\fP は作成しません。クラスがパッケージの一部になっていた場合、コンパイラはそのソースファイルを、パッケージ名を反映したサブディレクトリ内に格納します。その際、必要に応じてディレクトリを作成します。たとえば、ユーザーが \f3\-s /home/mysrc\fP と指定し、クラスの名前が \f2com.mypackage.MyClass\fP であった場合、そのソースファイルは \f2/home/mysrc/com/mypackage/MyClass.java\fP 内に格納されます。 

.TP 3

\-source release 

受け付けるソースコードのバージョンを指定します。\f2release\fP には次の値を指定できます。 

.RS 3

.TP 3

1.3 

このコンパイラでは、JDK 1.3 以降に導入されたアサーション、総称、または他の言語機能をサポートしません。 

.TP 3

1.4 

JDK 1.4 で導入された、アサーションを含むコードを受け付けます。 

.TP 3

1.5 

JDK 5 で導入された総称および他の言語機能を含んだコードを受け付けます。 

.TP 3

5 

1.5 と同義です。 

.TP 3

1.6 

これがデフォルト値です。Java SE 6 では言語に対する変更は導入されませんでしたが、ソースファイル内のエンコーディングエラーが、以前のような「警告」ではなく、「エラー」として報告されるようになりました。 

.TP 3

6 

1.6 と同義です。 

.TP 3

1.7 

JDK 7 で導入された機能を含むコードを受け付けます。 

.TP 3

7 

1.7 と同義です。 

.RE

.TP 3

\-sourcepath sourcepath 

クラスまたはインタフェースの定義を検索するソースコードパスを指定します。ユーザークラスパスと同様に、ソースパスの複数のエントリはコロン (\f3:\fP) で区切ります。ソースパスのエントリには、ディレクトリ、JAR アーカイブ、または ZIP アーカイブを指定できます。パッケージを使っている場合は、ディレクトリまたはアーカイブ内のローカルパス名がパッケージ名を反映していなければなりません。 

.LP

\f3注:\fP\ クラスパスからクラスだけでなくそのソースも見つかった場合、そのクラスは自動再コンパイルの対象になることがあります。「型の検索」を参照してください。  

.TP 3

\-verbose 

詳細な出力を表示します。ロードされるクラスおよびコンパイルされるソースファイルごとの情報が出力されます。 

.TP 3

\-version 

バージョン情報を出力します。  

.TP 3

\-Werror 

警告が発生した場合にコンパイルを終了します。 

.TP 3

\-X 

非標準オプションに関する情報を表示して終了します。 

.RE

.LP

.SS 

クロスコンパイルオプション

.LP

.LP

デフォルトでは、クラスのコンパイルは、\f3javac\fP が添付されているプラットフォームのブートストラップクラスおよび拡張機能クラスに対して行われます。ただし、\f3javac\fP は、異なる Java プラットフォームに実装されたブートストラップクラスおよび拡張機能クラスに対してコンパイルを行う「クロスコンパイル」もサポートしています。クロスコンパイルを行う場合は、\f3\-bootclasspath\fP および \f3\-extdirs\fP を使うことが重要です。このあとの「クロスコンパイルの例」を参照してください。

.LP

.RS 3

.TP 3

\-target version 

指定されたバージョンの VM をターゲットにしたクラスファイルを生成します。このクラスファイルは、指定されたターゲット以降のバージョンでは動作しますが、それより前のバージョンの VM では動作しません。有効なターゲットは、\f31.1\fP、\f31.2\fP、\f31.3\fP、\f31.4\fP、\f31.5\fP (\f35\fP も可)、\f31.6\fP (\f36\fP も可)、および \f31.7\fP (\f37\fP も可) です。 

.LP

\f3\-target\fP のデフォルトは、次のように \f3\-source\fP の値によって決まります。 

.RS 3

.TP 2

o

\-source が\f3指定されなかった\fP場合、\-target の値は \f31.7\fP になります。 

.TP 2

o

\-source が\f31.2\fP の場合、\-target の値は \f31.4\fP になります。 

.TP 2

o

\-source が\f31.3\fP の場合、\-target の値は \f31.4\fP になります。 

.TP 2

o

\-source が\f3それ以外の値の場合はすべて\fP、\f3\\\-target\fP の値は \f3\-source\fP の値になります。 

.RE

.TP 3

\-bootclasspath bootclasspath 

指定された一連のブートクラスに対してクロスコンパイルを行います。ユーザークラスパスと同様に、ブートクラスパスの複数のエントリはコロン (\f3:\fP) で区切ります。ブートクラスパスのエントリには、ディレクトリ、JAR アーカイブ、または ZIP アーカイブを指定できます。 

.RE

.LP

.SS 

非標準オプション

.LP

.RS 3

.TP 3

\-Xbootclasspath/p:path 

ブートストラップクラスパスの前に追加します。 

.TP 3

\-Xbootclasspath/a:path 

ブートストラップクラスパスの後ろに追加します。 

.TP 3

\-Xbootclasspath/:path 

ブートストラップクラスファイルの位置をオーバーライドします。 

.TP 3

\-Xlint 

推奨されるすべての警告を有効にします。このリリースでは、利用可能なすべての警告を有効にすることが推奨されています。 

.TP 3

\-Xlint:all 

推奨されるすべての警告を有効にします。このリリースでは、利用可能なすべての警告を有効にすることが推奨されています。 

.TP 3

\-Xlint:none 

すべての警告を無効にします。 

.TP 3

\-Xlint:name 

警告 \f2name\fP を有効にします。このオプションで有効にできる警告のリストについては、「\-Xlint オプションを使って有効または無効にできる警告」を参照してください。 

.TP 3

\-Xlint:\-name 

警告 \f2name\fP を無効にします。このオプションで無効にできる警告のリストについては、「\-Xlint オプションを使って有効または無効にできる警告」を参照してください。 

.TP 3

\-Xmaxerrs number 

印刷するエラーの最大数を設定します。 

.TP 3

\-Xmaxwarns number 

印刷する警告の最大数を設定します。 

.TP 3

\-Xstdout filename 

コンパイラのメッセージを、指定されたファイルに送ります。デフォルトでは、コンパイラのメッセージは \f2System.err\fP に送られます。 

.TP 3

\-Xprefer:{newer,source} 

ある型に対してソースファイルとクラスファイルの両方が見つかった場合、そのどちらのファイルを読み取るべきかを指定します (「型の検索」を参照)。\f2\-Xprefer:newer\fP を使用した場合、ある型に対するソースファイルとクラスファイルの新しい方が読み取られます (デフォルト)。\f2\-Xprefer:source\fP オプションを使用した場合、ソースファイルが読み取られます。SOURCE の保存ポリシーを使って宣言された注釈に任意の注釈プロセッサがアクセスできるようにする場合は、\f2\-Xprefer:source\fP \f2を使用してください\fP。  

.TP 3

\-Xpkginfo:{always,legacy,nonempty} 

パッケージ情報ファイルの処理を指定します。 

.TP 3

\-Xprint 

指定された型のテキスト表現をデバッグ目的で出力します。注釈処理、コンパイルのどちらも実行しません。出力形式は変更される可能性があります。 

.TP 3

\-XprintProcessorInfo 

ある特定のプロセッサが処理を依頼されている注釈に関する情報を出力します。 

.TP 3

\-XprintRounds 

初回および後続の注釈処理ラウンドに関する情報を出力します。 

.RE

.LP

.SS 

\-Xlint オプションを使って有効または無効にできる警告

.LP

.LP

\f3\-Xlint:\fP\f2name\fP オプションを使って警告 \f2name\fP を有効にします。ただし、\f2name\fP は次の警告名のいずれかになります。同様に、\f3\-Xlint:\-\fP\f2name\fP オプションを使って警告 \f2name\fP を無効にできます。

.LP

.RS 3

.TP 3

cast 

不要で冗長なキャストについて警告します。次に例を示します。 

.nf

\f3

.fl

String s = (String)"Hello!"

.fl

\fP

.fi

.TP 3

classfile 

クラスファイルの内容に関連した問題について警告します。 

.TP 3

deprecation 

非推奨項目の使用について警告します。次に例を示します。 

.nf

\f3

.fl

    java.util.Date myDate = new java.util.Date();

.fl

    int currentDay = myDate.getDay();

.fl

\fP

.fi

.LP

メソッド \f2java.util.Date.getDay\fP は JDK 1.1 以降は推奨されていません。  

.TP 3

dep\-ann 

\f2@deprecated\fP Javadoc コメントでドキュメント化されているが、 \f2@Deprecated\fP 注釈が付いていない項目について警告します。次に例を示します。 

.nf

\f3

.fl

  /**

.fl

   * @deprecated As of Java SE 7, replaced by {@link #newMethod()}

.fl

   */

.fl

.fl

  public static void deprecatedMethood() { }

.fl

.fl

  public static void newMethod() { }

.fl

\fP

.fi

.TP 3

divzero 

一定の整数 0 で除算されることについて警告します。次に例を示します。 

.nf

\f3

.fl

    int divideByZero = 42 / 0;

.fl

\fP

.fi

.TP 3

empty 

\f2if\fP 文以降が空の文であることについて警告します。次に例を示します。 

.nf

\f3

.fl

class E {

.fl

    void m() {

.fl

        if (true) ;

.fl

    }

.fl

}

.fl

\fP

.fi

.TP 3

fallthrough 

fall\-through ケースの \f2switch\fP ブロックをチェックし、検出されたものに対して警告メッセージを表示します。Fall\-through ケースは、\f2switch\fP ブロック内の最後のケースを除くケースです。このコードには \f2break\fP 文は含まれません。コードの実行をそのケースから次のケースへ移動します。たとえば、この \f2switch\fP ブロック内の \f2case 1\fP ラベルに続くコードは、\f2break\fP 文で終わっていません。 

.nf

\f3

.fl

switch (x) {

.fl

case 1:

.fl

       System.out.println("1");

.fl

       //  No break statement here.

.fl

case 2:

.fl

       System.out.println("2");

.fl

}

.fl

\fP

.fi

.LP

このコードのコンパイル時に \f2\-Xlint:fallthrough\fP フラグが使用されていた場合、コンパイラは 当該ケースの行番号とともに、fall\-through ケースの可能性があることを示す警告を発行します。  

.TP 3

finally 

正常に完了できない \f2finally\fP 節について警告します。次に例を示します。 

.nf

\f3

.fl

  public static int m() {

.fl

    try {

.fl

      throw new NullPointerException();

.fl

    } catch (NullPointerException e) {

.fl

      System.err.println("Caught NullPointerException.");

.fl

      return 1;

.fl

    } finally {

.fl

      return 0;

.fl

    }

.fl

  }

.fl

\fP

.fi

.LP

この例では、コンパイラは \f2finally\fP ブロックに関する警告を生成します。このメソッドが呼び出されると、値 1 ではなく \f20\fP が \f2返されます\fP。 \f2finally\fP ブロックは、 \f2try\fP ブロックが終了すると必ず実行されます。この例では、制御が \f2catch\fP に移された場合、メソッドは終了します。ただし、 \f2finally\fP ブロックは実行される必要があるため、制御がすでにこのメソッドの外部に移されていても、このブロックは実行されます。  

.TP 3

options 

コマンド行オプションの使用に関する問題について警告します。この種の警告の例については、「クロスコンパイルの例」を参照してください。 

.TP 3

overrides 

メソッドのオーバーライドに関する問題について警告します。たとえば、次の 2 つのクラスがあるとします。 

.nf

\f3

.fl

public class ClassWithVarargsMethod {

.fl

  void varargsMethod(String... s) { }