javac:語言編程編譯器-中文百科頻道

說明

兩種方法

javac 工具讀取用 Java 編程語言編寫的類和接口定義，并将它們編譯成字節碼類文件。

有兩種方法可将源代碼文件名傳遞給 javac：

如果源文件數量少,在命令行上列出文件名即可。

如果源文件數量多，則将源文件名列在一個文件中，名稱間用空格或回車行來進行分隔。然後在 javac 命令行中使用該列表文件名，文件名前冠以 @ 字符。

源代碼文件名稱必須含有 .java 後綴，類文件名稱必須含有 .class 後綴，源文件和類文件都必須有識别該類的根名。例如，名為 MyClass 的類将寫在名為 MyClass.java的源文件中，并被編譯為字節碼類文件 MyClass.class。

内部類定義産生附加的類文件。這些類文件的名稱将内部類和外部類的名稱結合在一起，例如 MyClass$MyInnerClass.class。

應當将源文件安排在反映其包樹結構的目錄樹中。例如，如果将所有的源文件放在 /workspace 中，那麼 com.mysoft.mypack.MyClass 的代碼應該在 workspacecommysoftmypackMyClass.java 中。

缺省情況下，編譯器将每個類文件與其源文件放在同一目錄中。可用 -d 選項（請參閱後面的選項）指定其它目标目錄。

查找類型

當編譯源文件時，編譯器常常需要它還沒有識别出的類型的有關信息。對于源文件中使用、擴展或實現的每個類或接口，編譯器都需要其類型信息。這包括在源文件中沒有明确提及、但通過繼承提供信息的類和接口。

例如

當擴展 java.applet.Applet 時還要用到 Applet 的祖先類：java.awt.Panel 、 java.awt.Container、 java.awt.Component 和 java.awt.Object。

當編譯器需要類型信息時，它将查找定義類型的源文件或類文件。編譯器先在自舉類及擴展類中查找，然後在用戶類路徑中查找。用戶類路徑通過兩種途徑來定義：通過設置 CLASSPATH 環境變量或使用 -classpath 命令行選項。（有關詳細資料，請參閱設置類路徑）。如果使用 -sourcepath 選項，則編譯器在 sourcepath 指定的路徑中查找源文件；否則，編譯器将在用戶類路徑中查找類文件和源文件。可用-bootclasspath 和 -extdirs 選項來指定不同的自舉類或擴展類；參閱下面的聯編選項。

成功的類型搜索可能生成類文件、源文件或兩者兼有。以下是 javac 對各種情形所進行的處理：

搜索結果隻生成類文件而沒有源文件： javac 使用類文件。

搜索結果隻生成源文件而沒有類文件： javac 編譯源文件并使用由此生成的類文件。

搜索結果既生成源文件又生成類文件： javac 确定類文件是否過時。若類文件已過時，則 javac 重新編譯源文件并使用更新後的類文件。否則， javac 直接使用類文件。

缺省情況下

隻要類文件比源文件舊， javac 就認為它已過時。（ -Xdepend 選項指定相對來說較慢但卻比較可靠的過程。）

注意

javac 可以隐式編譯一些沒有在命令行中提及的源文件。用 -verbose 選項可跟蹤自動編譯。

文件列表

為縮短或簡化 javac 命令，可以指定一個或多個每行含有一個文件名的文件。在命令行中，采用 '@' 字符加上文件名的方法将它指定為文件列表。當 javac 遇到以 `@' 字符開頭的參數時，它對那個文件中所含文件名的操作跟對命令行中文件名的操作是一樣的。這使得 Windows 命令行長度不再受限制。

例如，可以在名為 sourcefiles 的文件中列出所有源文件的名稱。該文件可能形如：

MyClass1.java

MyClass2.java

MyClass3.java

然後可用下列命令運行編譯器：

C:> javac @sourcefiles

選項

編譯器有一批标準選項，目前的開發環境支持這些标準選項，将來的版本也将支持它。還有一批附加的非标準選項是目前的虛拟機實現所特有的，将來可能要有變化。非标準選項以 -X 打頭。

标準選項

-classpath 類路徑

設置用戶類的路徑，它會複蓋 CLASSPATH 環境變量中的用戶類路徑。若既未指定 CLASSPATH 又未指定 -classpath，則用戶類路徑由當前目錄構成。有關詳細信息，請參閱設置類路徑。

若未指定 -sourcepath 選項（見下文），則将在用戶類路徑中查找類文件和源文件。

-d 目錄

設置輸出類文件的位置。如果某個類是一個包的組成部分，則 javac 将把該類文件放入反映包名的子目錄中，必要時創建目錄。例如，如果指定 -d c:myclasses 并且該類名叫 com.mypackage.MyClass，那麼類文件就叫作 c:myclassescommypackageMyClass.class。

若未指定 -d 選項，則 javac 将把類文件放到與源文件相同的目錄中。

注意： -d 選項指定的目錄不會被自動添加到用戶類路徑中。

-deprecation

顯示每種不鼓勵使用的API（包含成員和類）的使用或複蓋情況說明。沒有給出 -deprecation 選項的話， javac 将顯示這類源文件的名稱：這些源文件使用或複蓋了不鼓勵使用的API。

-encoding

設置源文件編碼名稱，例如 EUCJIS/SJIS。若未指定 -encoding 選項，則使用平台缺省的轉換器。

在windows dos環境下編譯NetBeans建立的源文件需要加上參數 -encoding utf-8。

-g

生成所有的調試信息，包括局部變量。缺省情況下，隻生成行号和源文件信息。

-g:none

不生成任何調試信息。

-g:{關鍵字列表}

隻生成某些類型的調試信息，這些類型由逗号分隔的關鍵字列表所指定。有效的關鍵字有：

source

源文件調試信息

lines

行号調試信息

vars

局部變量調試信息

-nowarn

禁用警告信息。

-O

優化代碼，縮短執行時間。使用 -O 選項可能使編譯速度下降，生成更大的類文件并使程序難以調試。

在 JDK 1.2 以前的版本中，javac 的 -g 選項和 -O 選項不能一起使用。在 JDK 1.2 中，可以将 -g 和 -O 選項結合起來，但可能會得到意想不到的結果，如丢失變量或重新定位代碼或丢失代碼。-O 選項不再自動打開 -depend 或關閉 -g 選項。同樣， -O 選項也不再允許進行跨類内嵌。

-sourcepath 源路徑

指定用來查找類或接口定義的源代碼路徑。與用戶類路徑一樣，多個源路徑項用分号 “ ; ” 進行分隔，它們可以是目錄、JAR 歸檔文件或 ZIP 歸檔文件。如果使用包，那麼目錄或歸檔文件中的本地路徑名必須反映包名。（注意：通過類路徑查找的類，如果找到了其源文件，則可能會自動被重新編譯。）

-verbose

冗長輸出。它包括了每個所加載的類和每個所編譯的源文件的有關信息。

聯編選項

缺省情況下，類是根據與 javac 一起發行的 JDK 自舉類和擴展類來編譯。但 javac 也支持聯編，在聯編中，類是根據其它 Java平台實現的自舉類和擴展類來進行編譯的。聯編時， -bootclasspath 和 -extdirs 的使用很重要；請參閱下面的聯編程序示例。

-target 版本

生成将在指定版本的虛拟機上運行的類文件。缺省情況下生成與 1.1 和 1.2 版本的虛拟機都兼容的類文件。JDK 1.2 中的 javac 所支持的版本有：

1.1

保證所産生的類文件與 1.1 和 1.2 版的虛拟機兼容。這是缺省狀态。

1.2

生成的類文件可在 1.2 版的虛拟機上運行，但不能在 1.1 版的虛拟機上運行。

-bootclasspath 自舉類路徑

根據指定的自舉類集進行聯編。和用戶類路徑一樣，自舉類路徑項用分号 (;) 進行分隔，它們可以是目錄、JAR 歸檔文件或 ZIP 歸檔文件。

-extdirs 目錄

根據指定的擴展目錄進行聯編。目錄是以分号分隔的目錄列表。在指定目錄的每個 JAR 歸檔文件中查找類文件。

非标準選項

-X

顯示非标準選項的有關信息并退出。

-Xdepend

遞歸地搜索所有可獲得的類，以尋找要重編譯的最新源文件。該選項将更可靠地查找需要編譯的類，但會使編譯進程的速度大為減慢。

-Xstdout

将編譯器信息送到System.out 中。缺省情況下，編譯器信息送到 System.err 中。

-Xverbosepath

說明如何搜索路徑和标準擴展以查找源文件和類文件。

-J選項

将選項傳給 javac 調用的 java 啟動器。例如， -J-Xms48m 将啟動内存設為 48 兆字節。雖然它不以 -X 開頭，但它并不是 javac 的‘标準選項’。用 -J 将選項傳給執行用 Java 編寫的應用程序的虛拟機是一種公共約定。

程序示例

編譯簡單程序

一個源文件 Hello.java ，它定義了一個名叫 greetings.Hello 的類。greetings 目錄是源文件和類文件兩者的包目錄，且它不是當前目錄。這讓我們可以使用缺省的用戶類路徑。它也使我們沒必要用 -d 選項指定單獨的目标目錄。

C:> dir

greetings/

C:> dir greetings

Hello.java

C:> cat greetingsHello.java

package greetings;

public class Hello {

public static void main(String[] args) {

for (int i=0; i < args.length; i++) {

System.out.println("Hello " + args);

}

C:> javac greetingsHello.java

C:> dir greetings

Hello.class Hello.java

C:> java greetings.Hello World Universe Everyone

Hello World

Hello Universe

Hello Everyone

編譯多個源文件

該示例編譯 greetings 包中的所有源文件。

C:> dir

greetings

C:> dir greetings

Aloha.java GutenTag.java Hello.java Hi.java

C:> javac greetings*.java

C:> dir greetings

Aloha.class GutenTag.class Hello.class Hi.class

Aloha.java GutenTag.java Hello.java Hi.java

指定用戶類路徑

對前面示例中的某個源文件進行更改後，重新編譯它：

C:> cd

examples

C:> javac greetingsHi.java

由于 greetings.Hi 引用了 greetings 包中其它的類，編譯器需要找到這些其它的類。上面的示例能運行是因為缺省的用戶類路徑剛好是含有包目錄的目錄。但是，假設我們想重新編譯該文件并且不關心我們在哪個目錄中的話，我們需要将 examples 添加到用戶類路徑中。可以通過設置 CLASSPATH 達到此目的，但這裡我們将使用 -classpath 選項來完成。

C:>javac -classpath examples examplesgreetingsHi.java

如果再次将 greetings.Hi 改為使用标題實用程序，該實用程序也需要通過用戶類路徑來進行訪問：

C:>javac -classpath examples:libBanners.jar

examplesgreetingsHi.java

要執行 greetings 中的類，需要訪問 greetings 和它所使用的類。

C:>java -classpath examples:libBanners.jar greetings.Hi

将源文件和類文件分開

将源文件和類文件置于不同的目錄下經常是很有意義的，特别是在大型的項目中。我們用 -d 選項來指明單獨的類文件目标位置。由于源文件不在用戶類路徑中，所以用 -sourcepath 選項來協助編譯器查找它們。

C:> dir

classes lib src

C:> dir src

farewells

C:> dir srcfarewells

Base.java GoodBye.java

C:> dir lib

Banners.jar

C:> dir classes

C:> javac -sourcepath src -classpath classes:libBanners.jar

srcfarewellsGoodBye.java -d classes

C:> dir classes

farewells

C:> dir classesfarewells

Base.class GoodBye.class

注意：編譯器也編譯了 srcfarewellsBase.java，雖然我們沒有在命令行中指定它。要跟蹤自動編譯，可使用 -verbose 選項。

聯編程序示例

這裡我們用 JDK 1.2 的 javac 來編譯将在 1.1 版的虛拟機上運行的代碼。

C:> javac -target 1.1 -bootclasspath jdk1.1.7libclasses.zip

-extdirs "" OldCode.java

-target 1.1 選項可确保生成的類文件與 1.1 版的虛拟機兼容。在 JDK1.2 中，缺省情況下 javac 編譯生成的文件是與 1.1 版的虛拟機兼容的，因此并非嚴格地需要該選項。然而，由于别的編譯器可能采用其它的缺省設置，所以提供這一選項将不失為是個好習慣。

JDK 1.2 javac 在缺省狀态下也将根據 1.2 版的自舉類來進行編譯，因此我們需要告訴 javac 讓它根據 JDK 1.1 自舉類來進行編譯。可用 -bootclasspath 和 -extdirs 選項來達到此目的。不這樣做的話，可能會使編譯器根據 1.2 版的 API 來進行編譯。由于 1.1 版的虛拟機上可能沒有該 1.2 版的 API，因此運行時将出錯。