javac命令详解

JAVAC 命令详解

 

结构

javac [ options ] [ sourcefiles ] [ @files ]

参数可按任意次序排列。

options

命令行选项。

sourcefiles

一个或多个要编译的源文件(例如 MyClass.java)。

@files

一个或多个对源文件进行列表的文件。

说明

javac

有两种方法可将源代码文件名传递给 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 编程语言编写的类和接口定义,并将它们编译成字节码类文件。

查找类型

当编译源文件时,编译器常常需要它还没有识别出的类型的有关信息。对于源文件中使用、扩展或实现的每个类或接口,编译器都需要其类型信息。这包括在源文件中没有明确提及、但通过继承提供信息的类和接口。

例如,当扩展java.applet.Applet时还要用到Applet的祖先类:java.awt.Paneljava.awt.Containerjava.awt.Componentjava.awt.Object

当编译器需要类型信息时,它将查找定义类型的源文件或类文件。编译器先在自举类及扩展类中查找,然后在用户类路径中查找。用户类路径通过两种途径来定义:通过设置CLASSPATH环境变量或使用-classpath命令行选项。(有关详细资料,请参阅设置类路径)。如果使用-sourcepath选项,则编译器在 sourcepath指定的路径中查找源文件;否则,编译器将在用户类路径中查找类文件和源文件。可用-bootclasspath-extdirs选项来指定不同的自举类或扩展类;参阅下面的联编选项。

成功的类型搜索可能生成类文件、源文件或两者兼有。以下是javac对各种情形所进行的处理:

·        搜索结果只生成类文件而没有源文件: javac 使用类文件。

·        搜索结果只生成源文件而没有类文件: javac 编译源文件并使用由此生成的类文件。

·        搜索结果既生成源文件又生成类文件:确定类文件是否过时。若类文件已过时,则 javac 重新编译源文件并使用更新后的类文件。否则, javac 直接使用类文件。

缺省情况下,只要类文件比源文件旧,javac就认为它已过时。(-Xdepend选项指定相对来说较慢但却比较可靠的过程。)

javac

注意: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

显示每种不鼓励使用的成员或类的使用或覆盖的说明。没有给出 -deprecation 选项的话, javac 将显示这类源文件的名称:这些源文件使用或覆盖不鼓励使用的成员或类。

-encoding

设置源文件编码名称,例如EUCJIS/SJIS。若未指定 -encoding 选项,则使用平台缺省的转换器。

-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[i]);

}

}

}

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.jargreetings.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 -classpathclasses: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 -bootclasspathjdk1.1.7\lib\classes.zip \

-extdirs "" OldCode.java

-target 1.1

JDK 1.2 javac在缺省状态下也将根据 1.2 版的自举类来进行编译,因此我们需要告诉javac让它根据 JDK 1.1 自举类来进行编译。可用-bootclasspath-extdirs选项来达到此目的。不这样做的话,可能会使编译器根据 1.2 版的 API 来进行编译。由于 1.1 版的虚拟机上可能没有该 1.2 版的 API,因此运行时将出错。

选项可确保生成的类文件与 1.1 版的虚拟机兼容。在 JDK1.2 中,缺省情况下 javac 编译生成的文件是与 1.1 版的虚拟机兼容的,因此并非严格地需要该选项。然而,由于别的编译器可能采用其它的缺省设置,所以提供这一选项将不失为是个好习惯。

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章