javac文档格式.docx
《javac文档格式.docx》由会员分享，可在线阅读，更多相关《javac文档格式.docx（15页珍藏版）》请在冰豆网上搜索。
（有关详细资料，请参阅设置类路径）。
如果使用-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将把该类文件放入反映包名的子目录中，必要时创建目录。
例如，如果指定-dc:
/myclasses并且该类名叫com.mypackage.MyClass，那么类文件就叫作c:
/myclasses/com/mypackage/MyClass.class。
若未指定-d选项，则javac将把类文件放到与源文件相同的目录中。
-d选项指定的目录不会被自动添加到用户类路径中。
-deprecation
显示每种不鼓励使用的成员或类的使用或覆盖的说明。
没有给出-deprecation选项的话，javac将显示这类源文件的名称：
这些源文件使用或覆盖不鼓励使用的成员或类。
-encoding
设置源文件编码名称，例如EUCJIS/SJIS。
若未指定-encoding选项，则使用平台缺省的转换器。
-g
生成所有的调试信息，包括局部变量。
缺省情况下，只生成行号和源文件信息。
-g:
none
不生成任何调试信息。
{关键字列表}
只生成某些类型的调试信息，这些类型由逗号分隔的关键字列表所指定。
有效的关键字有：
source
源文件调试信息
lines
行号调试信息
vars
局部变量调试信息
-nowarn
禁用警告信息。
-O
优化代码以缩短执行时间。
使用-O选项可能使编译速度下降、生成更大的类文件并使程序难以调试。
在JDK1.2以前的版本中，javac的-g选项和-O选项不能一起使用。
在JDK1.2中，可以将-g和-O选项结合起来，但可能会得到意想不到的结果，如丢失变量或重新定位代码或丢失代码。
-O选项不再自动打开-depend或关闭-g选项。
同样，-O选项也不再允许进行跨类内嵌。
-sourcepath源路径
指定用以查找类或接口定义的源代码路径。
与用户类路径一样，源路径项用分号（;
）进行分隔，它们可以是目录、JAR归档文件或ZIP归档文件。
如果使用包，那么目录或归档文件中的本地路径名必须反映包名。
通过类路径查找的类，如果找到了其源文件，则可能会自动被重新编译。
-verbose
冗长输出。
它包括了每个所加载的类和每个所编译的源文件的有关信息。
联编选项
缺省情况下，类是根据与javac一起发行的JDK自举类和扩展类来编译。
但javac也支持联编，在联编中，类是根据其它Java平台实现的自举类和扩展类来进行编译的。
联编时，-bootclasspath和-extdirs的使用很重要；
请参阅下面的联编程序示例。
-target版本
生成将在指定版本的虚拟机上运行的类文件。
缺省情况下生成与1.1和1.2版本的虚拟机都兼容的类文件。
JDK1.2中的javac所支持的版本有：
1.1
保证所产生的类文件与1.1和1.2版的虚拟机兼容。
这是缺省状态。
1.2
生成的类文件可在1.2版的虚拟机上运行，但不能在1.1版的虚拟机上运行。
-bootclasspath自举类路径
根据指定的自举类集进行联编。
和用户类路径一样，自举类路径项用分号（;
-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选项指定单独的目标目录。
dir
greetings/
dirgreetings
Hello.java
catgreetings/Hello.java
packagegreetings;
publicclassHello{
publicstaticvoidmain（String[]args）{
for（inti=0;
i<
args.length;
i++）{
System.out.println（"
Hello"
+args[i]）;
}
javacgreetings/Hello.java
Hello.classHello.java
javagreetings.HelloWorldUniverseEveryone
HelloWorld
HelloUniverse
HelloEveryone
编译多个源文件
该示例编译greetings包中的所有源文件。
Aloha.javaGutenTag.javaHello.javaHi.java
javacgreetings/*.java
Aloha.classGutenTag.classHello.classHi.class
指定用户类路径
对前面示例中的某个源文件进行更改后，重新编译它：
cd
/examples
javacgreetings/Hi.java
由于greetings.Hi引用了greetings包中其它的类，编译器需要找到这些其它的类。
上面的示例能运行是因为缺省的用户类路径刚好是含有包目录的目录。
但是，假设我们想重新编译该文件并且不关心我们在哪个目录中的话，我们需要将/examples添加到用户类路径中。
可以通过设置CLASSPATH达到此目的，但这里我们将使用-classpath选项来完成。
javac-classpath/examples/examples/greetings/Hi.java
如果再次将greetings.Hi改为使用标题实用程序，该实用程序也需要通过用户类路径来进行访问：
javac-classpath/examples:
/lib/Banners.jar/
/examples/greetings/Hi.java
要执行greetings中的类，需要访问greetings和它所使用的类。
java-classpath/examples:
/lib/Banners.jargreetings.Hi
将源文件和类文件分开
将源文件和类文件置于不同的目录下经常是很有意义的，特别是在大型的项目中。
我们用-d选项来指明单独的类文件目标位置。
由于源文件不在用户类路径中，所以用-sourcepath选项来协助编译器查找它们。
classes/lib/src/
dirsrc
farewells/
dirsrc/farewells
Base.javaGoodBye.java
dirlib
Banners.jar
dirclasses
javac-sourcepathsrc-classpathclasses:
lib/Banners.jar/
src/farewells/GoodBye.java-dclasses
dirclasses/farewells
Base.classGoodBye.class
编译器也编译了src/farewells/Base.java，虽然我们没有在命令行中指定它。
要跟踪自动编译，可使用-verbose选项。
联编程序示例
这里我们用JDK1.2的javac来编译将在1.1版的虚拟机上运行的代码。
javac-target1.1-bootclasspathjdk1.1.7/lib/classes.zip/
-extdirs"
"
OldCode.java
-target1.1
JDK1.2javac在缺省状态下也将根据1.2版的自举类来进行编译，因此我们需要告诉javac让它根据JDK1.1自举类来进行编译。
可用-bootclasspath和-extdirs选项来达到此目的。
不这样做的话，可能会使编译器根据1.2版的API来进行编译。
由于1.1版的虚拟机上可能没有该1.2版的API，因此运行时将出错。
选项可确保生成的类文件与1.1版的虚拟机兼容。
在JDK1.2中，缺省情况下javac编译生成的文件是与1.1版的虚拟机兼容的，因此并非严格地需要该选项。
然而，由于别的编译器可能采用其它的缺省设置，所以提供这一选项将不失为是个好习惯。
java命令
（源文：
-classpath，设定要搜索的类的路径，可以是目录，jar文件，zip文件（里面都是class文件），会覆盖掉所有的CLASSPATH的设定。
由于所要执行的类也是要搜索的类的一部分，所以一定要把这个类的路径也放到-classpath的设置里面。
表现在，在要执行的类的路径里面执行java时，一定要添加上点号（.）标示本目录也要搜索。
假设abc.class在路径c:
/src里面可以在任何路径下执行以下命令
java-classpathc:
/classes;
c:
/jar/abc.jar;
c:
/zip/abc.zip;
/srcabc
问题：
如果main.class属于c:
/jar/abc.jar，并且在blogs.jeffchen这个包里，那么执行java-classpath/classes;
blogs.jeffchen.main即可。
在windows下，文件路径的分割符为反斜杠/，类或者java文件列表的分割符为分号；
在linux下，文件路径的分隔符位斜杠/，类或者java文件列表的分隔符为冒号:
一个linux下编译和运行的例子
/usr/local/java/bin/javac-classpath/tmp/javatest/lib/mail-1.3.3.jar-d/tmp/javatest/bin//tmp/javatest/src/jp/co/realseed/Capability.java
/usr/local/java/bin/java-classpath/tmp/javatest/lib/mail-1.3.3.jar:
/tmp/javatest/bin/jp.co.realseed.Capability
jar命令详解
http:
//www.yuanma.org/data/2006/1020/article_1693.htm）
jar是随JDK安装的，在JDK安装目录下的bin目录中，Windows下文件名为jar.exe，Linux下文件名为jar。
它的运行需要用到JDK安装目录下lib目录中的tools.jar文件。
不过我们除了安装JDK什么也不需要做，因为SUN已经帮我们做好了。
我们甚至不需要将tools.jar放到CLASSPATH中。
用法
使用不带任何的jar命令我们可以看到jar命令的用法如下：
jar{ctxu}[vfm0M][jar-文件][manifest-文件][-C目录]文件名...
其中{ctxu}是jar命令的子命令，每次jar命令只能包含ctxu中的一个，它们分别表示：
-c 创建新的JAR文件包
-t 列出JAR文件包的内容列表
-x 展开JAR文件包的指定文件或者所有文件
-u 更新已存在的JAR文件包（添加文件到JAR文件包中）
[vfm0M]中的选项可以任选，也可以不选，它们是jar命令的选项参数
-v 生成详细报告并打印到标准输出
-f 指定JAR文件名，通常这个参数是必须的
-m 指定需要包含的MANIFEST清单文件
-0 只存储，不压缩，这样产生的JAR文件包会比不用该参数产生的体积大，但速度更快
-M 不产生所有项的清单（MANIFEST〕文件，此参数会忽略-m参数
[jar-文件]即需要生成、查看、更新或者解开的JAR文件包，它是-f参数的附属参数
[manifest-文件]即MANIFEST清单文件，它是-m参数的附属参数
[-C目录]表示转到指定目录下去执行这个jar命令的操作。
它相当于先使用cd命令转该目录下再执行不带-C参数的jar命令，它只能在创建和更新JAR文件包的时候可用。
文件名...指定一个文件/目录列表，这些文件/目录就是要添加到JAR文件包中的文件/目录。
如果指定了目录，那么jar命令打包的时候会自动把该目录中的所有文件和子目录打入包中。
例子
下面举一些例子来说明jar命令的用法：
1）jarcftest.jartest
该命令没有执行过程的显示，执行结果是在当前目录生成了test.jar文件。
如果当前目录已经存在test.jar，那么该文件将被覆盖。
2）jarcvftest.jartest
该命令与上例中的结果相同，但是由于v参数的作用，显示出了打包过程，如下：
标明清单（manifest）
增加：
test/（读入=0）（写出=0）（存储了0％）
test/Test.class（读入=7）（写出=6）（压缩了14％）
3）jarcvfMtest.jartest
该命令与2）结果类似，但在生成的test.jar中没有包含META-INF/MANIFEST文件，打包过程的信息也略有差别：
4）jarcvfmtest.jarmanifest.mftest
运行结果与2）相似，显示信息也相同，只是生成JAR包中的META-INF/MANIFEST内容不同，是包含了manifest.mf的内容
manifest.mf文件例子Manifest-Version:
1.0
Created-By:
1.4.2（SunMicrosystemsInc.）
Main-Class:
Music
一般我们修改Music这个地方就可以了
5）jartftest.jar
在test.jar已经存在的情况下，可以查看test.jar中的内容，如对于2）和3）生成的test.jar分别应该此命令，结果如下；
对于2）
META-INF/
META-INF/MANIFEST.MF
test/
test/Test.class
对于3）
6）jartvftest.jar
除显示5）中显示的内容外，还包括包内文件的详细信息，如：
0WedJun1915:
39:
06GMT2002META-INF/
86WedJun1915:
06GMT2002META-INF/MANIFEST.MF
33:
04GMT2002test/
7WedJun1915:
04GMT2002test/Test.class
7）jarxftest.jar
解开test.jar到当前目录，不显示任何信息，对于2）生成的test.jar，解开后的目录结构如下：
==
|--META-INF
| `--MANIFEST
`--test
`--Test.class
8）jarxvftest.jar
运行结果与7）相同，对于解压过程有详细信息显示，如：
创建：
展开：
9）jaruftest.jarmanifest.mf
在test.jar中添加了文件manifest.mf，此使用jartf来查看test.jar可以发现test.jar中比原来多了一个manifest。
这里顺便提一下，如果使用-m参数并指定manifest.mf文件，那么manifest.mf是作为清单文件MANIFEST来使用的，它的内容会被添加到MANIFEST中；
但是，如果作为一般文件添加到JAR文件包中
升级会员 