使用批处理编译器

查找批处理编译器

批处理编译器类包含在 JDT 核心插件中。这个类的名称是 org.eclipse.jdt.compiler.batch.BatchCompiler。它打包在 plugins/org.eclipse.jdt.core_<version>.jar 中。从版本 3.2 开始,还可以作为单独的下载获得此类。文件名为 ecj.jar。还提供了其相应的源。要获取它们,转至下载页并搜索 JDT Core Batch Compiler 一节。此 JAR 包含批处理编译器和 javac Ant 适配器。

从版本 3.3 开始,这个 JAR 文件还包含对 jsr199 的支持(编译器 API)以及对 jsr269 的支持(注释处理)。为了使用注释处理支持,需要 1.6 VM。

因此,可以将它作为独立的应用程序在 Eclipse 外部的 Ant 构建中使用。

运行批处理编译器

可以使用哪些选项?

建议的选项带有橙色背景。

多次设置某些选项后,批处理编译器会按从左至右的顺序使用这些选项。如果在没有“+”或“-”的情况下使用警告选项 (-warn:....),那么这会覆盖先前指定的警告集合。所以用户应确保在使用任何其他 -warn 选项之前指定此类选项。

此规则同样适用于 -err: 选项。

名称 用法
类路径选项
-bootclasspath <dir 1>;<dir 2>;...;<dir P> 这是目录或 jar 文件的列表,用来引导编译器使用的类文件。缺省情况下,将使用正在运行的 VM 的库。这些条目是由平台路径分隔符分隔的。
每个目录或文件都可以在“[”与“]”之间指定类型的访问规则。

如果未指定引导类路径,那么编译器将按顺序使用系统属性 sun.boot.class.path、vm.boot.class.path 或 org.apache.harmony.boot.class.path 来推断引导类路径。

-cp
-classpath <dir 1>;<dir 2>;...;<dir P>
这是用来编译源文件的目录或 jar 文件的列表。缺省值是“java.class.path”属性的值。这些条目是由平台路径分隔符分隔的。
每个目录或文件都可以在“[”与“]”之间指定类型的访问规则。例如,[-X] 禁止访问类型 X,[~X] 不鼓励访问类型 X,[+p/X:-p/*] 禁止访问包 p 中的所有类型,但允许访问 p/X。
编译器以递归方式按 JAR 文件的清单的 Class-Path 子句执行处理,如果所引用的每个 JAR 文件尚未包括在类路径中,那么编译器会将其追加到类路径末尾。
-extdirs <dir 1>;<dir 2>;...;<dir P> 这是用来指定扩展 zip/jar 文件位置的目录列表。这些条目是由平台路径分隔符分隔的。
-endorseddirs <dir 1>;<dir 2>;...;<dir P> 这是用来指定已签署的 zip/jar 文件位置的目录列表。这些条目是由平台路径分隔符分隔的。
-sourcepath <dir 1>;<dir 2>;...;<dir P> 这是用来指定源文件的目录列表。这些条目是由平台路径分隔符分隔的。
每个目录都可以在“[”与“]”之间指定类型的访问规则。
-d <dir 1>|none 此选项用来指定生成的 .class 文件应该被转储到的目录。如果省略此选项,那么不会创建任何包目录结构。
如果您根本不想生成 .class 文件,请使用 -d none。
-encoding <encoding name> 指定所有源文件的缺省编码。也可以通过对每个输入源文件名/文件夹名追加后缀 [<encoding name>] 逐个文件指定定制编码。例如,X.java[utf8] 将对当前用户目录中的编译单元 X.java 指定 UTF-8 编码。

如果指定了多种缺省源文件编码,那么会使用最后一种编码。

例如:

  • ... -encoding UTF-8 X.java[Cp1252] Y.java[UTF-16] Z.java ....
    所有源文件将使用 UTF-8 编码读取(这包含 Z.java)。X.java 将使用 Cp1252 编码读取,Y.java 将使用 UTF-16 编码读取。
  • ... -encoding UTF-8 -encoding UTF-16 ....
    所有源文件将使用 UTF-16 编码读取。UTF-8 的 -encoding 选项被忽略。
  • ... -encoding Cp1252 /foo/bar/X.java[UTF-16] /foo/bar[UTF-8] ....
    所有源文件将使用 Cp1252 编码读取。X.java 是 /foo/bar 目录中将使用 UTF-16 编码读取的唯一文件。该目录中的所有其他文件将使用 UTF-8 编码读取。
一致性选项
-target 1.1 到 1.7 或者(5、5.0 等等) 此选项指定 .class 文件目标设置。可能的值是:
  • 1.1(主版本:45,次版本:3)
  • 1.2(主版本:46,次版本:0)
  • 1.3(主版本:47,次版本:0)
  • 1.4(主版本:48,次版本:0)
  • 1.5、5 或 5.0(主版本:49,次版本:0)
  • 1.6、6 或 6.0(主版本:50,次版本:0)
  • 1.7、7 或 7.0(主版本:51,次版本:0)
缺省值是:
  • 1.1(在 -1.3 方式下)
  • 1.2(在 -1.4 方式下)
  • 1.5(在 -1.5 方式下)
  • 1.6(在 -1.6 方式下)
  • 1.7(在 -1.7 方式下)

可以使用 clcd1.1 来生成 StackMap 属性。

-1.3 将一致性级别设置为 1.3。实际上是指 -source 1.3 -target 1.1。
-1.4 将一致性级别设置为 1.4(缺省值)。实际上是指 -source 1.3 -target 1.2。
-1.5 将一致性级别设置为 1.5。实际上是指 -source 1.5 -target 1.5。
-1.6 将一致性级别设置为 1.6。实际上是指 -source 1.6 -target 1.6。
-1.7 将一致性级别设置为 1.7。实际上是指 -source 1.7 -target 1.7。
-source 1.1 到 1.7 或者(5、5.0 等等) 这用于指定编译器所期望的源代码级别。
可能的值是:
  • 1.3
  • 1.4
  • 1.5、5 或 5.0
  • 1.6、6 或 6.0
  • 1.7、7 或 7.0
缺省值是:
  • 1.3(在 -1.3 方式下)
  • 1.3(在 -1.4 方式下)
  • 1.5(在 -1.5 方式下)
  • 1.6(在 -1.6 方式下)
  • 1.7(在 -1.7 方式下)
在 1.4 中,assert 被视为关键字。在 1.5 和 1.6 中,enum 和 assert 都被视为关键字。
警告选项
-?:warn -help:warn 显示高级警告选项
-warn:... 指定启用的警告集合。
例如:-warn:unusedLocal,deprecation
-warn:none 禁用所有警告
-warn:<用 , 分隔的警告标记> 仅启用列示的警告
-warn:+<用 , 分隔的警告标记> 启用其他警告
-warn:-<用 , 分隔的警告标记> 禁用特定警告
在下文的缺省值列中,标记“+/-”指示选项涵盖多个细粒度的警告变体,其中的一部分在缺省情况下已启用,其他已禁用。这表示,指定带有“+”的给定选项将启用多于缺省值的警告,而指定“-”将禁用缺省情况下已启用的某些警告。
缺省 标记名称 描述
+/- allDeadCode 包括没有意义的 if(DEBUG) 检查的死代码
+/- allDeprecation 建议不要使用的内容,即使在建议不要使用的代码中亦如此
- allJavadoc Javadoc 无效或缺少 Javadoc
- allOver-ann 所有缺少的 @Override 注释(超类和超接口)
- all-static-method 所有方法都可以声明为静态警告
+ assertIdentifier 出现了用作标识的 assert
- boxing 自动装箱转换
+ charConcat 在字符串并置中使用了字符型数组,但未显式地将其转换为字符串
+ compareIdentical 对完全相同的表达式进行比较
- conditionAssign 可能的意外布尔赋值
+ constructorName 具有构造函数名的方法
+ deadCode 排除了没有意义的 if (DEBUG) 检查的死代码
- dep-ann 缺少 @Deprecated 注释
+/- deprecation 在建议不要使用的代码外部使用了建议不要使用的类型或成员
+ discouraged 使用了与不鼓励使用的访问规则相匹配的类型
- emptyBlock 未记录的空块
+ enumIdentifier 出现了用作标识的 enum
+ enumSwitch 不完整的 enum 开关
- enumSwitchPedantic 即使存在 default case 也报告缺少枚举 switch case
- fallthrough 可能的跳转 case
- fieldHiding 字段隐藏了另一个变量
+ finalBound 带最终界限的类型参数
+ finally finally 块未正常结束
+ forbidden 使用了与被禁止的访问规则相匹配的类型
- hashCode 覆盖 equals() 时缺少 hashCode() 方法
+/- hiding 用于 fieldHiding、localHiding、typeHiding 和 maskedCatchBlock 的宏
- includeAssertNull 对于在 assert 表达式中被破坏的变量生成空警告
- indirectStatic 对静态成员的间接引用
+ intfAnnotation 用作超接口的注释类型
+ intfNonInherited 接口非继承方法兼容性
- intfRedundant 查找多余的超接口
- javadoc Javadoc 无效
- localHiding 局部变量隐藏了另一个变量
+ maskedCatchBlock 隐藏的 catch 块
- nls 非 nls 字符串文字(缺少标记 //$NON-NLS-<n>)
+ noEffectAssign 无作用的赋值
+/- null 可能缺少 null 检查或 null 检查冗余
- nullAnnot 启用基于注释的空分析。
如果需要,可以通过追加 (nullable|nonnull|nonnullbydefault) 来指定要由编译器解释的注释类型,其中使用标准名称来指定每个注释类型。
另请参阅下文的 -nonNullByDefault。
- nullDereference 缺少 null 检查
- over-ann 缺少的 @Override 注释(仅适用于超类)
- paramAssign 对参数赋值
+ pkgDefaultMethod 尝试覆盖包缺省方法
+ raw 原始类型(而不是参数化类型)的用法
+/- 资源 类型为 Closeable 的资源的(可能)不安全使用
- semicolon 不必要的分号或空语句
+ serial 缺少 serialVersionUID
- specialParamHiding 构造函数或 Setter 方法参数隐藏了另一个字段
+/- static-access indirectStatic 和 staticReceiver 的宏
- static-method 可能为静态方法的实例方法
+ staticReceiver 如果使用了非静态接收方来获取静态字段或调用静态方法
- super 覆盖了方法,但未进行超调用
+ suppress 启用 @SuppressWarnings
- switchDefault 缺少 default case 的 switch 语句
- syncOverride 同步方法覆盖中缺少“同步”
- syntheticAccess 当对内部类执行复合访问时
- tasks 启用对源代码中的任务标记的支持
+ typeHiding 类型参数隐藏了另一个类型
+ unavoidableGenericProblems 忽略由于原始 API 而产生的不可避免的类型安全问题
+ unchecked 未校验的类型操作
- unnecessaryElse 不必要的 else 子句
- unqualifiedField 对字段的未限定引用
+/- unused unusedAllocation、unusedArgument、unusedImport、unusedLabel、unusedLocal、unusedPrivate、unusedThrown 和 unusedTypeArgs 的宏
- unusedAllocation 分配未使用的对象
- unusedArgument 未使用的方法参数
+ unusedImport 未使用的导入引用
+ unusedLabel 未使用的标签
+ unusedLocal 未使用的局部变量
+ unusedPrivate 未使用的私有成员声明
- unusedThrown 未使用的声明的抛出异常
+ unusedTypeArgs 方法和构造函数的未使用的类型参数
- uselessTypeCheck 不必要的强制类型转换/instanceof 操作
+ varargsCast varargs 参数需要显式强制类型转换
+/- warningToken @SuppressWarnings 中未处理或未使用的警告标记
-nowarn 没有任何警告(等同于 -warn:none)
-err:... 指定转换为错误的已启用警告集。
例如,-err:unusedLocal,deprecation
unusedLocal 和不推荐使用的警告将转换为错误。所有其他警告仍将报告为警告。
-err:<用 , 分隔的警告标记> 正好将列示的警告转换为错误
-err:+<用 , 标记的警告标记> 将其他警告转换为错误
-err:-<用 , 分隔的警告标记> 阻止特定警告转换为错误
-deprecation 等同于 -warn:+deprecation。
-properties <file> 根据属性文件内容设置警告/错误选项。此选项可与 -nowarn、-err:.. 或 -warn:.. 选项配合使用,但命令行上的最后一项设置要使用的选项。

属性文件内容可通过以下方式生成:在现有 Java 项目上设置特定于项目的设置并在 .settings/org.eclipse.jdt.core.prefs 文件中将该文件用作属性文件,或者其内容是定义的条目/值对的简单文本文件(使用在org.eclipse.jdt.core.JavaCore 类中定义的常量)。

...
org.eclipse.jdt.core.compiler.problem.annotationSuperInterface=warning
org.eclipse.jdt.core.compiler.problem.assertIdentifier=warning
org.eclipse.jdt.core.compiler.problem.autoboxing=ignore
...
调试选项
-g[:none|:lines,vars,source] 设置调试属性级别
-g 所有调试信息(等同于 -g:lines,vars,source)
-g:none 无调试信息
-g:[lines,vars,source] 选择性的调试信息
-preserveAllLocals 显式地请求编译器保留所有局部变量(用于调试目的)。如果省略此选项,编译器将除去未使用的局部变量。
注释处理选项(需要 1.6 或更高版本的 VM,并且仅当一致性级别设置为 1.6 时才使用)
-Akey[=value] 传递至注释处理器的注释处理器选项。key 是一组由逗号分隔的标识。
-proc:[only|none] 如果指定了 -proc:only,那么注释处理器将运行,但不执行编译。如果指定了 -proc:none,那么将不会发现或运行注释处理器;并且,将以找不到注释处理器的方式执行编译。缺省情况下,编译器必须在类路径中搜索注释处理器。因此,如果不需要注释处理器,那么指定 -proc:none 可以提高编译速度。
-processor <class1[,class2,...]> 要运行的注释处理器的限定类名。如果指定了此参数,那么将跳过正常的处理器发现过程。
-processorpath <dir 1>;<dir 2>;...;<dir P> 一组目录或 JAR 文件,将在这些目录或文件中搜索注释处理器。这些条目是由平台路径分隔符分隔的。如果未指定此选项,那么将搜索类路径。
-s <dir> 此选项指定一个目录,将在该目录中创建所生成的源文件。
-XprintProcessorInfo 显示关于处理器所要处理的注释和元素的信息
-XprintRounds 显示关于注释处理回合的信息
-classNames <class1[,class2,...]> 需要处理的二进制类型的限定名
已忽略的选项(为了与 javac 选项兼容)
-J<option> 将选项传递至虚拟机
-X<option> 指定非标准选项。将不忽略 -Xemacs。
-X 显示非标准选项并退出
-O 优化执行时间
高级选项
@<file> 从文件中读取命令行参数
-maxProblems <n> 每个编译单元的最大问题数(缺省值为 100)
-log <filename> 指定一个日志文件,编译器的所有输出都将被转储到该文件中。如果您想要调试批处理编译器或者获取包含批处理构建所生成的所有错误和警告的文件,此选项就特别有用。如果扩展名是 .xml,那么生成的日志将会是 XML 文件。
-Xemacs 使用 emacs 样式以在控制台和常规文本日志中显示错误和警告位置。XML 日志不受此选项影响。在此选项处于活动状态时,消息:
2. WARNING in /workspace/X.java
(at line 8)...

显示为:
/workspace/X.java:8: warning: The method...
-proceedOnError[:Fatal] 即使出现错误也继续编译,并转储包含问题方法或问题类型的类文件。仅当您希望即使未解决全部错误也能够运行应用程序时,才建议指定此选项。
通过使用“:Fatal”,所有可选错误被视为致命并且这会导致编码为运行时产生错误时异常终止。如果不使用“:Fatal”,那么可选错误不会阻止正常的代码生成,并且产生的 .class 文件可正常运行。
-verbose 在控制台中(或者在日志文件中,如果指定的话)打印已访问的/已处理的编译单元。
-referenceInfo 计算引用信息。仅当已连接到构建器时,此选项才有用。否则,引用信息是没有用的。
-progress 显示进度(仅在 -log 方式下)。
-time 显示速度信息。
-noExit 编译结束时不调用 System.exit(n)(如果没有错误,那么 n=0)。
-repeat <n> 将编译过程重复 <n> 次(性能分析)。
-inlineJSR 直接插入 JSR 字节码(如果 target >= 1.5,那么是隐式的)。
-enableJavadoc 考虑 Javadoc 内的引用。
-missingNullDefault 已启用基于注释的空分析(使用上文的“nullAnnot”)时,只要没有对于包或类型的缺省注释,此选项就会发出警告。
帮助选项
-? -help 显示帮助消息。
-v -version 显示编译器的构建号。此选项对于报告错误来说非常有用。
-showversion 显示编译器的构建号并继续。此选项对于报告错误来说非常有用。

示例

d:\temp -classpath rt.jar -time -g -d d:/tmp 此命令编译 d:\temp 及其子文件夹中的所有源文件。类路径仅仅是 rt.jar。它生成所有调试属性,并将生成的所有 .class 文件转储到 d:\tmp。批处理过程一旦完成,就会显示编译器的速度。
d:\temp\Test.java -classpath d:\temp;rt.jar -g:none 此命令仅编译 Test.java 及其依赖文件(如果有的话,从 d:\temp 中检索依赖文件)。类路径是 d:\temp,后跟 rt.jar,这表示首先在 d:\temp 中搜索所有必需的类,然后在 rt.jar 中搜索。它不生成任何调试属性,并将生成的所有 .class 文件转储到 d:\temp。