[建立和构建应用程序的主要工具] 之 javac

官网-javac

1. 简述

javac工具及其选项来读取Java类和接口定义，并将它们编译为字节码和类文件。该javac命令还能够处理Java源文件和类中的注释。

2. 命令

用法: javac <options> <source files>

其中, options 可能的选项包括:
  -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 <路径>        指定查找注释处理程序的位置
  -parameters                生成元数据以用于方法参数的反射
  -d <目录>                    指定放置生成的类文件的位置
  -s <目录>                    指定放置生成的源文件的位置
  -h <目录>                    指定放置生成的本机标头文件的位置
  -implicit:{none,class}     指定是否为隐式引用文件生成类文件
  -encoding <编码>             指定源文件使用的字符编码
  -source <发行版>              提供与指定发行版的源兼容性
  -target <发行版>              生成特定 VM 版本的类文件
  -profile <配置文件>            请确保使用的 API 在指定的配置文件中可用
  -version                   版本信息
  -help                      输出标准选项的提要
  -A关键字[=值]                  传递给注释处理程序的选项
  -X                         输出非标准选项的提要
  -J<标记>                     直接将 <标记> 传递给运行时系统
  -Werror                    出现警告时终止编译
  @<文件名>                     从文件读取选项和文件名
  
sourcefiles:

要编译（例如MyClass.java）或处理注释（例如MyPackage.MyClass）的一个或多个源文件。
复制代码

3. 编译的文件传给javac的方法

• 对于少许源文件，您能够在命令行上列出文件名。
• 对于大量源文件，能够使用命令行上的选项包含列出源文件名的文件

源代码文件名必须具备.java后缀，类文件名必须具备.class后缀，源文件和类文件都必须具备标识该类的根名称。例如，一个被调用的类MyClass将被写入一个被调用的源文件中，MyClass.java并被编译成一个名为的字节码类文件MyClass.class。

内部类定义生成其余类文件。这些类文件具备组合内部和外部类名称的名称，eg: MyClass$MyInnerClass.class。

默认状况下，编译器将每一个类文件放在与其源文件相同的目录中。您能够使用该-d选项指定单独的目标目录。

4. JDK9新特性

JDK_JAVAC_OPTIONS在JDK 9中引入了一个启动器环境变量，它将其内容添加到命令行中javac。

所述的内容JDK_JAVAC_OPTIONS的环境变量，由白色空间（）或空白字符分隔（\n，\t，\r，或\f）被预置到传递到命令行参数javac做为参数的列表。

环境变量的编码要求javac与系统上的命令行相同。JDK_JAVAC_OPTIONS环境变量内容的处理方式与命令行中指定的方式相同。

单引号（'）或双引号（"）可用于包含包含空格字符的参数。经过简单地删除引号对来保留开放引用和第一个匹配的关闭引用之间的全部内容。若是找不到匹配的引号，启动器将停止并显示错误消息。支持，由于它们在命令行中指定。可是，如同不支持使用通配符同样。 @files@files

引用包含空格的参数的示例：

export JDK_JAVAC_OPTIONS='@"C:\white spaces\argfile"'
复制代码

export JDK_JAVAC_OPTIONS='"@C:\white spaces\argfile"'
复制代码

export JDK_JAVAC_OPTIONS='@C:\"white spaces"\argfile'
复制代码