javac

javac

javac是java語言編程編譯器。全稱java compiler。javac工具讀由java語言編寫的類和介面的定義,並將它們編譯成位元組代碼的class文件。javac可以隱式編譯一些沒有在命令行中提及的源文件。用verbose選項可跟蹤自動編譯。

結構


參數

[ options ] [ sourcefiles ] [ @files ]
參數可按任意次序排列。

options

命令行選項。

sourcefiles

一個或多個要編譯的源文件(例如 MyClass.java)。

說明


兩種方法

javac 工具讀取用 Java 編程語言編寫的類和介面定義,並將它們編譯成位元組碼類文件。
有兩種方法可將源代碼文件名傳遞給 javac:
如果源文件數量少,在命令行上列出文件名即可。
如果源文件數量多,則將源文件名列在一個文件中,名稱間用空格或回車行來進行分隔。然後在 javac 命令行中使用該列表文件名,文件名前冠以 @ 字元。
源代碼文件名稱必須含有 .java 後綴,類文件名稱必須含有 .class 後綴,源文件和類文件都必須有識別該類的根名。例如,名為 MyClass 的類將寫在名為 MyClass.java的源文件中,並被編譯為位元組碼類文件 MyClass.class。
內部類定義產生附加的類文件。這些類文件的名稱將內部類和外部類的名稱結合在一起,例如 MyClass$MyInnerClass.class。
應當將源文件安排在反映其包樹結構的目錄樹中。例如,如果將所有的源文件放在 /workspace 中,那麼 com.mysoft.mypack.MyClass 的代碼應該在 \workspace\com\mysoft\mypack\MyClass.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:\myclasses\com\mypackage\MyClass.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 編寫的應用程序的虛擬機是一種公共約定。

注意

CLASSPATH 、 -classpath 、 -bootclasspath 和 -extdirs 並 不 指定用於運行 javac 的類。如此濫用編譯器的實現通常沒有任何意義而且總是很危險的。如果確實需要這樣做,可用 -J 選項將選項傳給基本的 java 啟動器。

程序示例


編譯簡單程序

一個源文件 Hello.java ,它定義了一個名叫 greetings.Hello 的類。greetings 目錄是源文件和類文件兩者的包目錄,且它不是當前目錄。這讓我們可以使用預設的用戶類路徑。它也使我們沒必要用 -d 選項指定單獨的目標目錄。
C:> dir
greetings/
C:> dir greetings
Hello.java
C:> cat greetings\Hello.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 greetings\Hello.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 greetings\Hi.java
由於 greetings.Hi 引用了 greetings 包中其它的類,編譯器需要找到這些其它的類。上面的示例能運行是因為預設的用戶類路徑剛好是含有包目錄的目錄。但是,假設我們想重新編譯該文件並且不關心我們在哪個目錄中的話,我們需要將 \examples 添加到用戶類路徑中。可以通過設置 CLASSPATH 達到此目的,但這裡我們將使用 -classpath 選項來完成。
C:>javac -classpath \examples \examples\greetings\Hi.java
如果再次將 greetings.Hi 改為使用標題實用程序,該實用程序也需要通過用戶類路徑來進行訪問:
C:>javac -classpath \examples:\lib\Banners.jar \
\examples\greetings\Hi.java
要執行 greetings 中的類,需要訪問 greetings 和它所使用的類。
C:>java -classpath \examples:\lib\Banners.jar greetings.Hi

分開

將源文件和類文件置於不同的目錄下經常是很有意義的,特別是在大型的項目中。我們用 -d 選項來指明單獨的類文件目標位置。由於源文件不在用戶類路徑中,所以用 -sourcepath 選項來協助編譯器查找它們。
C:> dir
classes\ lib\ src\
C:> dir src
farewells\
C:> dir src\farewells
Base.java GoodBye.java
C:> dir lib
Banners.jar
C:> dir classes
C:> javac -sourcepath src -classpath classes:lib\Banners.jar \
src\farewells\GoodBye.java -d classes
C:> dir classes
farewells\
C:> dir classes\farewells
Base.class GoodBye.class
注意:編譯器也編譯了 src\farewells\Base.java,雖然我們沒有在命令行中指定它。要跟蹤自動編譯,可使用 -verbose 選項。

聯編程序示例

這裡我們用 JDK 1.2 的 javac 來編譯將在 1.1 版的虛擬機上運行的代碼。
C:> javac -target 1.1 -bootclasspath jdk1.1.7\lib\classes.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,因此運行時將出錯。

另請參閱


java

- Java 應用程序啟動器

jdb

- Java 應用程序調試程序

javah

- C 頭文件和 stub 文件生成器

javap

- 類文件解析器

javadoc

- API 文檔生成器

jar

- JAR 歸檔工具 Java 擴展框架