'\" t

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

.\" Title: javac

.\" Language: English

.\" Date: 2013年11月21日

.\" SectDesc: 基本ツール

.\" Software: JDK 8

.\" Arch: 汎用

.\"

.\" 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.

.\"

.pl 99999

.TH "javac" "1" "2013年11月21日" "JDK 8" "基本ツール"

.\" -----------------------------------------------------------------

.\" * Define some portability stuff

.\" -----------------------------------------------------------------

.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.\" http://bugs.debian.org/507673

.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html

.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.ie \n(.g .ds Aq \(aq

.el       .ds Aq '

.\" -----------------------------------------------------------------

.\" * set default formatting

.\" -----------------------------------------------------------------

.\" disable hyphenation

.nh

.\" disable justification (adjust text to left margin only)

.ad l

.\" -----------------------------------------------------------------

.\" * MAIN CONTENT STARTS HERE *

.\" -----------------------------------------------------------------

.SH "NAME"

javac \- Javaクラスおよびインタフェースの定義を読み取り、バイトコードおよびクラス・ファイルにコンパイルします。

.SH "概要"

.sp

.if n \{\

.RS 4

.\}

.nf

\fIjavac\fR [ \fIoptions\fR ] [ \fIsourcefiles\fR ] [ \fIclasses\fR] [ \fI@argfiles\fR ]

.fi

.if n \{\

.\}

.PP

引数を指定する順序は任意です。

.PP

\fIoptions\fR

.RS 4

コマンドライン・オプション。オプションを参照してください。

.RE

.PP

\fIsourcefiles\fR

.RS 4

コンパイルされる1つ以上のソース・ファイル(\fIMyClass\&.java\fRなど)。

.RE

.PP

\fIclasses\fR

.RS 4

注釈の処理対象となる1つ以上のクラス(\fIMyPackage\&.MyClass\fRなど)。

.RE

.PP

\fI@argfiles\fR

.RS 4

オプションとソース・ファイルを一覧表示する1つ以上のファイル。このファイルの中では\fI\-J\fRオプションは指定できません。コマンドライン引数ファイルを参照してください。

.PP

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

.PP

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

.sp

.RS 4

.ie n \{\

\h'-04'\(bu\h'+03'\c

.\}

.el \{\

.sp -1

.IP \(bu 2.3

.\}

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

.sp

.RS 4

.ie n \{\

\h'-04'\(bu\h'+03'\c

.\}

.el \{\

.sp -1

.IP \(bu 2.3

.\}

ソース・ファイルの数が多い場合は、ファイル内のファイル名を空白または改行で区切って指定します。\fIjavac\fRコマンドで、リスト・ファイル名の先頭にアットマーク(@)を使用します。

.RE

.PP

ソース・コードのファイル名は\&.java拡張子を、クラスのファイル名は\&.class拡張子を持っている必要があります。また、ソース・ファイルとクラス・ファイルのどちらも、該当するクラスに対応するルート名を持っている必要があります。たとえば、\fIMyClass\fRという名前のクラスは、\fIMyClass\&.java\fRという名前のソース・ファイルに記述されます。このソース・ファイルは、\fIMyClass\&.class\fRという名前のバイトコード・クラス・ファイルにコンパイルされます。

.PP

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

.PP

ソース・ファイルは、パッケージ・ツリーを反映したディレクトリ・ツリーに配置します。たとえば、すべてのソース・ファイルが\fI/workspace\fRにある場合、\fIcom\&.mysoft\&.mypack\&.MyClass\fRのソース・コードを、\fI/workspace/com/mysoft/mypack/MyClass\&.java\fRに格納します。

.PP

デフォルトでは、コンパイラは、各クラス・ファイルを対応するソース・ファイルと同じディレクトリに格納します。\fI\-d\fRオプションを使用して、別の出力先ディレクトリを指定できます。

.PP

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

.sp

.RS 4

.ie n \{\

\h'-04'\(bu\h'+03'\c

.\}

.el \{\

.sp -1

.IP \(bu 2.3

.\}

クロスコンパイル・オプションを参照してください。

.RE

.sp

.RS 4

.ie n \{\

\h'-04'\(bu\h'+03'\c

.\}

.el \{\

.sp -1

.IP \(bu 2.3

.\}

非標準オプションを参照してください。

.RE

.SS "標準オプション"

.PP

\-A\fIkey\fR[\fI=value\fR]

.RS 4

注釈プロセッサに渡すオプションを指定します。これらのオプションは、\fIjavac\fRが直接解釈するのではなく、それぞれのプロセッサで使用できるようになります。\fIkey\fRの値は、1つまたは複数の識別子をドット(\&.)で区切る必要があります。

.RE

.PP

\-cp \fIpath\fR or \-classpath \fIpath\fR

.RS 4

ユーザー・クラス・ファイル、および(オプションで)注釈プロセッサとソース・ファイルを検索する場所を指定します。このクラス・パスは\fICLASSPATH\fR環境変数のユーザー・クラス・パスをオーバーライドします。\fICLASSPATH\fR、\fI\-cp\fR、\fI\-classpath\fRのいずれも指定されていない場合、ユーザーの\fIクラス・パス\fRは、現在のディレクトリになります。Setting the Class Path を参照してください。

.sp

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

.sp

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

.RE

.PP

\-Djava\&.ext\&.dirs=\fIdirectories\fR

.RS 4

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

.RE

.PP

\-Djava\&.endorsed\&.dirs=\fIdirectories\fR

.RS 4

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

.RE

.PP

\-d \fIdirectory\fR

.RS 4

クラス・ファイルの出力先ディレクトリを設定します。そのディレクトリは\fIjavac\fRでは作成されないため、すでに存在している必要があります。クラスがパッケージの一部である場合、\fIjavac\fRは、パッケージ名を反映したサブディレクトリ内にクラス・ファイルを格納し、必要に応じてディレクトリを作成します。

.sp

\fI\-d\fR

\fI/home/myclasses\fRと指定し、クラスの名前が\fIcom\&.mypackage\&.MyClass\fRである場合、クラス・ファイルは\fI/home/myclasses/com/mypackage/MyClass\&.class\fRになります。

.sp

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

.sp

\fB注意:\fR

\fI\-d\fRオプションによって指定されたディレクトリは、ユーザー・クラス・パスに自動的に追加されません。

.RE

.PP

\-deprecation

.RS 4

非推奨のメンバーまたはクラスが使用またはオーバーライドされるたびに、説明を表示します。\fI\-deprecation\fRオプションが指定されていない場合、\fIjavac\fRは、非推奨のメンバーまたはクラスを使用またはオーバーライドしているソース・ファイルのサマリーを表示します。\fI\-deprecation\fRオプションは、\fI\-Xlint:deprecation\fRの省略表記です。

.RE

.PP

\-encoding \fIencoding\fR

.RS 4

ソース・ファイルのエンコーディング名(EUC\-JPやUTF\-8など)を設定します。\fI\-encoding\fRオプションが指定されていない場合は、プラットフォームのデフォルト・コンバータが使用されます。

.RE

.PP

\-endorseddirs \fIdirectories\fR

.RS 4

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

.RE

.PP

\-extdirs \fIdirectories\fR

.RS 4

\fIext\fRディレクトリの位置をオーバーライドします。directories変数には、コロンで区切ったディレクトリのリストを指定します。指定したディレクトリ内の各JARファイルから、クラス・ファイルが検索されます。検出されたすべてのJARファイルは、クラス・パスの一部になります。

.sp

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

.RE

.PP

\-g

.RS 4

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

.RE

.PP

\-g:none

.RS 4

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

.RE

.PP

\-g:[\fIkeyword list\fR]

.RS 4

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

.PP

source

.RS 4

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

.RE

.PP

lines

.RS 4

行番号のデバッグ情報。

.RE

.PP

vars

.RS 4

ローカル変数のデバッグ情報。

.RE

.PP

\-help

.RS 4

標準オプションの概要を出力します。

.RE

.PP

\-implicit:[\fIclass, none\fR]

.RS 4

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

.RE

.PP

\-J\fIoption\fR

.RS 4

Java仮想マシン(JVM)に\fIoption\fRを渡します。optionには、Java起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。

.sp

\fB注意:\fR

\fICLASSPATH\fR、\fI\-classpath\fR、\fI\-bootclasspath\fRおよび\fI\-extdirs\fRオプションは、\fIjavac\fRの実行に使用されるクラスを指定しません。これらのオプションおよび変数を使用してコンパイラの実装をカスタマイズしようとすると、リスクが高く、多くの場合、必要な処理が実行されません。コンパイラの実装をカスタマイズする必要がある場合、\fI\-J\fRオプションを使用して、基礎となるJava起動ツールにオプションを渡します。

.RE

.PP

\-nowarn

.RS 4

警告メッセージを無効にします。このオプションは、\fI\-Xlint:none\fRオプションと同じように動作します。

.RE

.PP

\-parameters

.RS 4

リフレクションAPIのメソッド\fIjava\&.lang\&.reflect\&.Executable\&.getParameters\fRが取得できるように、生成されるクラス・ファイル内のコンストラクタとメソッドの仮パラメータ名を格納します。

.RE

.PP

\-proc: [\fInone\fR, \fIonly\fR]

.RS 4

注釈処理およびコンパイルを実行するかを制御します。\fI\-proc:none\fRは、注釈処理なしでコンパイルが実行されることを意味します。\fI\-proc:only\fRは、注釈処理のみが実行され、後続のコンパイルはまったく実行されないことを意味します。

.RE

.PP

\-processor \fIclass1\fR [,\fIclass2\fR,\fIclass3\fR\&.\&.\&.]

.RS 4

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

.RE

.PP

\-processorpath \fIpath\fR

.RS 4

注釈プロセッサを検索する場所を指定します。このオプションが使用されない場合、クラス・パスのプロセッサが検索されます。

.RE

.PP

\-s \fIdir\fR

.RS 4

生成されたソース・ファイルの格納先となるディレクトリを指定します。そのディレクトリは\fIjavac\fRでは作成されないため、すでに存在している必要があります。クラスがパッケージの一部である場合、コンパイラは、パッケージ名を反映したサブディレクトリ内にソース・ファイルを格納し、必要に応じてディレクトリを作成します。

.sp

\fI\-s /home/mysrc\fRと指定し、クラスの名前が\fIcom\&.mypackage\&.MyClass\fRである場合、ソース・ファイルは\fI/home/mysrc/com/mypackage/MyClass\&.java\fRに格納されます。

.RE

.PP

\-source \fIrelease\fR

.RS 4

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

.PP

1\&.3

.RS 4

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

.PP

1\&.4

.RS 4

Java SE 1\&.4で導入された、アサーションを含むコードを受け付けます。

.RE

.PP

1\&.5

.RS 4

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

.RE

.PP

5

.RS 4

1\&.5と同義です。

.RE

.PP

1\&.6

.RS 4

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

.RE

.PP

6

.RS 4

1\&.6と同義です。

.RE

.PP

1\&.7

.RS 4

これがデフォルト値です。Java SE 7で導入された機能を含むコードを受け付けます。

.PP

7

.RS 4

1\&.7と同義です。

.RE

.RE

.PP

\-sourcepath \fIsourcepath\fR

.RS 4

クラスまたはインタフェースの定義を検索するソース・コード・パスを指定します。ユーザー・クラス・パスと同様に、ソース・パスのエントリは、Oracle Solarisではコロン(:)で、Windowsではセミコロンで区切り、ここには、ディレクトリ、JARアーカイブまたはZIPアーカイブを指定できます。パッケージを使用している場合は、ディレクトリまたはアーカイブ内のローカル・パス名がパッケージ名を反映している必要があります。

.sp

\fB注意:\fR

ソース・ファイルも見つかった場合、クラス・パスにより見つかったクラスは再コンパイルされる可能性があります。型の検索を参照してください。

.PP

\-verbose

.RS 4

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

.RE

.PP

\-version

.RS 4

リリース情報を出力します。

.RE

.PP

\-werror

.RS 4

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

.RE

.PP

\-X

.RS 4

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

.SS "クロスコンパイル・オプション"

.PP

デフォルトでは、クラスのコンパイルは、\fIjavac\fRが添付されているプラットフォームのブートストラップ・クラスおよび拡張機能クラスに対して行われます。ただし、\fIjavac\fRは、異なるJavaプラットフォームに実装されたブートストラップ・クラスおよび拡張機能クラスに対してコンパイルを行うクロスコンパイルもサポートしています。クロスコンパイルを行う場合は、\fI\-bootclasspath\fRおよび\fI\-extdirs\fRオプションを使用することが重要です。

.PP

\-target \fIversion\fR

.RS 4

仮想マシンの指定されたリリースを対象とするクラス・ファイルを生成します。クラス・ファイルは、指定されたターゲット以降のリリースでは動作しますが、それより前のリリースのJVMでは動作しません。有効なターゲットは、1\&.1、1\&.2、1\&.3、1\&.4、1\&.5 (5も可)、1\&.6 (6も可)および1\&.7 (7も可)です。

.sp

\fI\-target\fRオプションのデフォルトは、\fI\-source\fRオプションの値によって異なります。

.sp

.RS 4

.ie n \{\

\h'-04'\(bu\h'+03'\c

.\}

.el \{\

.sp -1

.IP \(bu 2.3

.\}

\fI\-source\fRオプションが指定されていない場合、\fI\-target\fRオプションの値は1\&.7です。

.RE

.sp

.RS 4

.ie n \{\

\h'-04'\(bu\h'+03'\c

.\}

.el \{\

.sp -1

.IP \(bu 2.3

.\}

\fI\-source\fRオプションが1\&.2の場合、\fI\-target\fRオプションの値は1\&.4です。

.RE

.sp

.RS 4

.ie n \{\

\h'-04'\(bu\h'+03'\c

.\}

.el \{\

.sp -1

.IP \(bu 2.3

.\}

\fI\-source\fRオプションが1\&.3の場合、\fI\-target\fRオプションの値は1\&.4です。

.sp

.RS 4

.ie n \{\

\h'-04'\(bu\h'+03'\c

.\}

.el \{\

.sp -1

.IP \(bu 2.3

.\}

\fI\-source\fRオプションが1\&.5の場合、\fI\-target\fRオプションの値は1\&.7です。

.RE

.sp

.RS 4

.ie n \{\

\h'-04'\(bu\h'+03'\c

.\}

.el \{\

.sp -1

.IP \(bu 2.3

.\}

\fI\-source\fRオプションが1\&.6の場合、\fI\-target\fRオプションの値は1\&.7です。

.RE

.sp

.RS 4

.ie n \{\

\h'-04'\(bu\h'+03'\c

.\}

.el \{\

.sp -1

.IP \(bu 2.3

.\}

\fI\-source\fRオプションの他のすべての値の場合、\fI\-target\fRオプションの値は、\fI\-source\fRオプションの値になります。

.RE

.RE

.PP

\-bootclasspath \fIbootclasspath\fR

.RS 4

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

.RE

.SS "コンパクト・プロファイル・オプション"

.PP

JDK 8以降から、\fIjavac\fRコンパイラはコンパクト・プロファイルをサポートします。コンパクト・プロファイルを使用すると、Javaプラットフォーム全体を必要としないアプリケーションは、デプロイ可能で、小さいフットプリントで実行できます。コンパクト・プロファイル機能は、アプリケーション・ストアからのアプリケーションのダウンロード時間を短縮するのに使用できます。この機能は、JREをバンドルするJavaアプリケーションの、よりコンパクトなデプロイメントに役立ちます。この機能は、小さいデバイスでも役立ちます。

.PP

サポートされているプロファイル値は、\fIcompact1\fR、\fIcompact2\fRおよび\fIcompact3\fRです。これらは、追加のレイヤーです。大きい番号の各コンパクト・プロファイルには、小さい番号の名前のプロファイル内のすべてのAPIが含まれます。

.PP

\-profile

.RS 4

コンパクト・プロファイルを使用する場合、このオプションは、コンパイル時にプロファイル名を指定します。次に例を示します。

.sp

.if n \{\

.RS 4

.\}

javac \-profile compact1 Hello\&.java

.if n \{\

.RE

.\}

javacは、指定されたプロファイルにない任意のJava SE APIを使用するソース・コードをコンパイルしません。これは、そのようなソース・コードをコンパイルしようとすることによって生じるエラー・メッセージの例です。

.sp

.if n \{\

.RS 4

.\}

cd jdk1\&.8\&.0/bin

\&./javac \-profile compact1 Paint\&.java

Paint\&.java:5: error: Applet is not available in profile \*(Aqcompact1\*(Aq

import java\&.applet\&.Applet;

.if n \{\

.RE

.\}

この例では、\fIApplet\fRクラスを使用しないようにソースを変更することによって、エラーを修正できます。\-profileオプションを指定せずにコンパイルすることによって、エラーを修正することもできます。コンパイルは、Java SE APIの完全なセットに対して実行されます。(どのコンパクト・プロファイルにも、\fIApplet\fRクラスは含まれていません。)

.sp

コンパクト・プロファイルを使用してコンパイルするための別の方法として、\fI\-bootclasspath\fRオプションを使用して、プロファイルのイメージを指定する\fIrt\&.jar\fRファイルへのパスを指定します。かわりに\fI\-profile\fRオプションを使用すると、プロファイル・イメージは、コンパイル時にシステム上に存在する必要がありません。これは、クロスコンパイル時に役立ちます。

.RE

.SS "非標準オプション"

.PP

\-Xbootclasspath/p:\fIpath\fR

.RS 4

ブートストラップ・クラス・パスに接尾辞を追加します。

.RE

.PP

\-Xbootclasspath/a:\fIpath\fR

.RS 4

ブートストラップ・クラス・パスに接頭辞を追加します。

.RE

.PP

\-Xbootclasspath/:\fIpath\fR

.RS 4

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

.RE

.PP

\-Xdoclint:[\-]\fIgroup\fR [\fI/access\fR]