Java知识点：javac命令

javac命令初窥

注：以下红色标记的参数在下文中有所讲解。

用法: javac <options> <source files>

其中, 可能的选项包括:

  -g                         生成所有调试信息

  -g:none                    不生成任何调试信息

  -g:{lines,vars,source}     只生成某些调试信息

  -nowarn                    不生成任何警告

  -verbose                   输出有关编译器正在执行的操作的消息

  -deprecation               输出使用已过时的 API 的源位置

  -classpath <路径>            指定查找用户类文件和注释处理程序的位置

  -cp <路径>                   指定查找用户类文件和注释处理程序的位置

  -sourcepath <路径>           指定查找输入源文件的位置

  -bootclasspath <路径>        覆盖引导类文件的位置

  -extdirs <目录>              覆盖所安装扩展的位置

  -endorseddirs <目录>         覆盖签名的标准路径的位置

  -proc:{none,only}          控制是否执行注释处理和/或编译。

  -processor <class1>[,<class2>,<class3>...] 要运行的注释处理程序的名称; 绕过默认的搜索进程

  -processorpath <路径>        指定查找注释处理程序的位置

  -d <目录>                    指定放置生成的类文件的位置

  -s <目录>                    指定放置生成的源文件的位置

  -implicit:{none,class}     指定是否为隐式引用文件生成类文件

  -encoding <编码>             指定源文件使用的字符编码

  -source <发行版>              提供与指定发行版的源兼容性

  -target <发行版>              生成特定 VM 版本的类文件

  -version                   版本信息

  -help                      输出标准选项的提要

  -A关键字[=值]                  传递给注释处理程序的选项

  -X                         输出非标准选项的提要

  -J<标记>                     直接将 <标记> 传递给运行时系统

  -Werror                    出现警告时终止编译

  @<文件名>                     从文件读取选项和文件名

-g、-g:none、-g:{lines,vars,source}

• -g：在生成的class文件中包含所有调试信息（行号、变量、源文件）
• -g:none ：在生成的class文件中不包含任何调试信息。

这个参数在javac编译中是看不到什么作用的，因为调试信息都在class文件中，而我们看不懂这个class文件。

为了看出这个参数的作用，我们在eclipse中进行实验。在eclipse中，我们经常做的事就是“debug”，而在debug的时候，我们会

• 加入“断点”，这个是靠-g:lines起作用，如果不记录行号，则不能加断点。
• 在“variables”窗口中查看当前的变量，如下图所示，这是靠-g:vars起作用，否则不能查看变量信息。
• 在多个文件之间来回调用，比如 A.java的main()方法中调用了B.java的fun()函数，而我想看看程序进入fun()后的状态，这是靠-g:source，如果没有这个参数，则不能查看B.java的源代码。

在eclipse中，假设有一个名为 Test 的项目，则可以"右击Test项目" -> "Properties" -> "Java compiler"，进入下图界面。

上面用红色方框圈起来的选项，作用就等价于 -g:vars,-g:lines,-g:source。

下面来做几个试验：

实验一：

• 实验内容：去掉全部的三个选项。
• 结论：不能进行调试，因为不能加断点，不能查看当前的变量。

实验二：

• 实验内容：只去掉第1个选项。
• 结论：在“variables”窗口中，没有记录任何变量。

实验三：

• 实验内容：去掉第2个选项。
• 结论：不能加BreakPoint。

实验四：

• 实验内容：去掉第3个选项。
• 结论：如果要查看其它文件，则出现： source not found.

-bootclasspath、-extdirs

-bootclasspath和-extdirs 几乎不需要用的，因为他是用来改变 “引导类”和“扩展类”。

• 引导类(组成Java平台的类)：Javajdk1.7.0_25jrelib t.jar等，用-bootclasspath设置。
• 扩展类：Javajdk1.7.0_25jrelibext目录中的文件，用-extdirs设置。
• 用户自定义类：用-classpath设置。

我们用-verbose编译后出现的“类文件的搜索路径”，就是由上面三个路径组成，如下：

[类文件的搜索路径: C:Javajdk1.7.0_25jrelib esources.jar,C:Javajdk1.7.0_25
jrelib t.jar,C:Javajdk1.7.0_25jrelibsunrsasign.jar,C:Javajdk1.7.0_25j
relibjsse.jar,C:Javajdk1.7.0_25jrelibjce.jar,C:Javajdk1.7.0_25jrelib
charsets.jar,C:Javajdk1.7.0_25jrelibjfr.jar,C:Javajdk1.7.0_25jreclasses
,C:Javajdk1.7.0_25jrelibextaccess-bridge-32.jar,C:Javajdk1.7.0_25jreli
bextdnsns.jar,C:Javajdk1.7.0_25jrelibextjaccess.jar,C:Javajdk1.7.0_25
jrelibextlocaledata.jar,C:Javajdk1.7.0_25jrelibextsunec.jar,C:Javajdk
1.7.0_25jrelibextsunjce_provider.jar,C:Javajdk1.7.0_25jrelibextsunmsca
pi.jar,C:Javajdk1.7.0_25jrelibextsunpkcs11.jar,C:Javajdk1.7.0_25jrelib
extzipfs.jar,..in]             //紫色表示引导类和扩展类路径，绿色表示用户定义类路径

如果利用 -bootclasspath 重新定义： javac -bootclasspath src Xxx.java，则会出现下面错误：

致命错误: 在类路径或引导类路径中找不到程序包 java.lang

-sourcepath和-classpath（-cp）

• -classpath(-cp)指定你依赖的类的class文件的查找位置。在Linux中，用“:”分隔classpath，而在windows中，用“;”分隔。
• -sourcepath指定你依赖的类的java文件的查找位置。

举个例子，

public class A
{
    public static void main(String[] args) {
        B b = new B();
        b.print();
    }
}

public class B
{
    public void print()
    {
        System.out.println("old");
    }
}

目录结构如下：

sourcepath          //此处为当前目录
　　|-src
　　　　|-com
　　　　　　|- B.java
　　　　|- A.java
　　|-bin
　　　　|- B.class               //是 B.java 编译后的类文件

如果要编译 A.java，则必须要让编译器找到类B的位置，你可以指定B.class的位置，也可以是B.java的位置，也可以同时都存在。

javac -classpath bin src/A.java                            //查找到B.class
javac -sourcepath src/com src/A.java                   //查找到B.java
javac -sourcepath src/com -classpath bin src/A.java    //同时查找到B.class和B.java

如果同时找到了B.class和B.java，则：

• 如果B.class和B.java内容一致，则遵循B.class。
• 如果B.class和B.java内容不一致，则遵循B.java，并编译B.java。

以上规则可以通过 -verbose选项看出。

-proc:{none,only}、-procpath、-processor

这三个命令是用来自定义“Annotation Processor”的，即你可以自定义注释，比如@Hello，@First 等，解析这些注释就需要"Annotation Processor"。

• -processor <CustomProcessor> ：自定义注释处理器的类
• -procpath：注释处理器的查找目录。
• -proc:only：只运行注释处理器，而不编译源文件。
• -proc:none：不使用注释处理器，只编译源文件。

任务：自定义一个@HelloWorld 注释，并自定义注释处理器“HelloWorldProcessor”，使得在javac编译时输出：HelloWorld.

第一步：定义 @HelloWorld注释。

public @interface HelloWorld
{    
}

第二步：使用@HelloWorld注释。

@HelloWorld
public class Dummy
{
}

第三步：编写注释处理器 HelloWorldProcessor。

• 必须要继承 AbstractProcessor.
• 对于process方法，每个Annotation都会调用process()方法一次。

import java.util.Set;
import javax.annotation.processing.*;
import javax.lang.model.SourceVersion;
import javax.lang.model.element.TypeElement;
import javax.tools.Diagnostic;

@SupportedAnnotationTypes("HelloWorld")            //注释处理器支持的注释：HelloWorld
@SupportedSourceVersion(SourceVersion.RELEASE_7)        //注释处理器支持的JDK版本：7
public class HelloWorldProcessor extends AbstractProcessor {        //继承 AbstractProcessor
     @Override
     public synchronized void init(ProcessingEnvironment processingEnv) 
     {
         super.init(processingEnv);
     }

     @Override
     public boolean process(Set<? extends TypeElement> annotations,
                                RoundEnvironment roundEnv) 
     {
         if (!roundEnv.processingOver()) {
             processingEnv.getMessager().printMessage(    //注释处理器的报告
             Diagnostic.Kind.NOTE, "Hello World!");
         }
         return true;
     }
}

在命令行中输入：

javac HelloWorldProcessor.java 
javac -processor HelloWorldProcessor *.java        

输出：

注: Hello World!

-d

• d就是 destination，用于指定.class文件的生成目录，在eclipse中，源文件都在src中，编译的class文件都是在bin目录中。

这里我用来实现一下这个功能，假设项目名称为project，此目录为当前目录，且在src/com目录中有一个Main.java文件。‘

package com;
public class Main
{
    public static void main(String[] args) {
        System.out.println("Hello");
    }
}

javac -d bin src/com/Main.java

上面的语句将Main.class生成在bin/com目录下。

-implicit:{none,class}

• 如果有文件为A.java（其中有类A），且在类A中使用了类B，类B在B.java中，则编译A.java时，默认会自动编译B.java，且生成B.class。
• implicit:none：不自动生成隐式引用的类文件。
• implicit:class（默认）：自动生成隐式引用的类文件。

public class A
{
    public static void main(String[] args) {
        B b = new B();
    }
}

public class B
{
}

如果使用：

 javac -implicit:none A.java

则不会生成 B.class。

-source和-target

• -source：使用指定版本的JDK编译，比如：-source 1.4表示用JDK1.4的标准编译，如果在源文件中使用了泛型，则用JDK1.4是不能编译通过的。
• -target：指定生成的class文件要运行在哪个JVM版本，以后实际运行的JVM版本必须要高于这个指定的版本。

javac -source 1.4 Xxx.java

javac -target 1.4 Xxx.java

-encoding

• 指定源文件的编码格式，如果源文件是UTF-8编码的，而-encoding GBK，则源文件就变成了乱码（特别是有中文时）。

javac -encoding UTF-8 Xxx.java

-deprecation

• 如果你在源文件中使用了“已过时的API”，则生成详细警告信息。

import java.util.Date;
public class Javac01
{
    public static void main(String[] args) {
        Date date = new Date(2012,12,12);6     }
}

上面的代码中，第5行使用了过时的API，如果使用 javac Javac01.java 编译，则生成：

注: Javac01.java使用或覆盖了已过时的 API。
注: 有关详细信息, 请使用 -Xlint:deprecation 重新编译。

上面的输出并不详细。但是如果使用 javac -deprecation Javac01.java 编译，则：

Javac01.java:5: 警告: [deprecation] Date中的Date(int,int,int)已过时
Date date = new Date(2012,12,12);
                     ^

-verbose

输出详细的编译信息，包括：classpath、加载的类文件信息。

比如，我写了一个最简单的HelloWorld程序，在命令行中输入：

D:Java>javac -verbose -encoding UTF-8 HelloWorld01.java

输出：

[语法分析开始时间 RegularFileObject[HelloWorld01.java]]
[语法分析已完成, 用时 21 毫秒]
[源文件的搜索路径: .,D:大三下编译原理cupjava-cup-11a.jar,E:javajflexlibJ           //-sourcepath
Flex.jar]
[类文件的搜索路径: C:Javajdk1.7.0_25jrelib esources.jar,C:Javajdk1.7.0_25      //-classpath、-bootclasspath、-extdirs
jrelib t.jar,C:Javajdk1.7.0_25jrelibsunrsasign.jar,C:Javajdk1.7.0_25j
relibjsse.jar,C:Javajdk1.7.0_25jrelibjce.jar,C:Javajdk1.7.0_25jrelib
charsets.jar,C:Javajdk1.7.0_25jrelibjfr.jar,C:Javajdk1.7.0_25jreclasses
,C:Javajdk1.7.0_25jrelibextaccess-bridge-32.jar,C:Javajdk1.7.0_25jreli
bextdnsns.jar,C:Javajdk1.7.0_25jrelibextjaccess.jar,C:Javajdk1.7.0_25
jrelibextlocaledata.jar,C:Javajdk1.7.0_25jrelibextsunec.jar,C:Javajdk
1.7.0_25jrelibextsunjce_provider.jar,C:Javajdk1.7.0_25jrelibextsunmsca
pi.jar,C:Javajdk1.7.0_25jrelibextsunpkcs11.jar,C:Javajdk1.7.0_25jrelib
extzipfs.jar,.,D:大三下编译原理cupjava-cup-11a.jar,E:javajflexlibJFlex
.jar]
[正在加载ZipFileIndexFileObject[C:Javajdk1.7.0_25libct.sym(META-INF/sym/rt.j
ar/java/lang/Object.class)]]
[正在加载ZipFileIndexFileObject[C:Javajdk1.7.0_25libct.sym(META-INF/sym/rt.j
ar/java/lang/String.class)]]
[正在检查Demo]
[正在加载ZipFileIndexFileObject[C:Javajdk1.7.0_25libct.sym(META-INF/sym/rt.j
ar/java/lang/AutoCloseable.class)]]
[正在加载ZipFileIndexFileObject[C:Javajdk1.7.0_25libct.sym(META-INF/sym/rt.j
ar/java/lang/System.class)]]
[正在加载ZipFileIndexFileObject[C:Javajdk1.7.0_25libct.sym(META-INF/sym/rt.j
ar/java/io/PrintStream.class)]]
[正在加载ZipFileIndexFileObject[C:Javajdk1.7.0_25libct.sym(META-INF/sym/rt.j
ar/java/io/FilterOutputStream.class)]]
[正在加载ZipFileIndexFileObject[C:Javajdk1.7.0_25libct.sym(META-INF/sym/rt.j
ar/java/io/OutputStream.class)]]
[已写入RegularFileObject[Demo.class]]
[共 447 毫秒]

编写一个程序时，比如写了一句：System.out.println("hello")，实际上还需要加载：Object、PrintStream、String等类文件，而上面就显示了加载的全部类文件。

-J <标记>

• 传递一些信息给 Java Launcher.

javac -J-Xms48m   Xxx.java          //set the startup memory to 48M.

-@<文件名>

如果同时需要编译数量较多的源文件(比如1000个)，一个一个编译是不现实的（当然你可以直接 javac *.java ），比较好的方法是：将你想要编译的源文件名都写在一个文件中（比如sourcefiles.txt），其中每行写一个文件名，如下所示：

HelloWorld01.java
HelloWorld02.java
HelloWorld03.java

则使用下面的命令：

javac @sourcefiles.txt

编译这三个源文件。

Reference

[1] http://docs.oracle.com/javase/6/docs/technotes/tools/windows/javac.html
[2] http://www.cnblogs.com/JeffChen/archive/2008/01/16/1041783.html
[3] Java类查找: http://m.oschina.net/blog/109442
[4] The Hacker's Guide to Javac: http://scg.unibe.ch/archive/projects/Erni08b.pdf