批处理编译器类包含在 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 构建中使用。
java -jar org.eclipse.jdt.core_<version>.jar -classpath rt.jar A.java
或者:
java -jar ecj.jar -classpath rt.jar A.java
compile(String commandLine, PrintWriter outWriter, PrintWriter errWriter, CompilationProgress progress) 方法。org.eclipse.jdt.compiler.CompilationProgress progress = null; // instantiate your subclass org.eclipse.jdt.internal.compiler.batch.BatchCompiler.compile( "-classpath rt.jar A.java", new PrintWriter(System.out), new PrintWriter(System.err), progress);
通过创建 org.eclipse.jdt.compiler.CompilationProgress 类的子类,您可以控制进度的报告方式或者取消批处理编译器的方式。
建议的选项带有橙色背景。
多次设置某些选项后,批处理编译器会按从左至右的顺序使用这些选项。如果在没有“+”或“-”的情况下使用警告选项 (-warn:....),那么这会覆盖先前指定的警告集合。所以用户应确保在使用任何其他 -warn 选项之前指定此类选项。
此规则同样适用于 -err: 选项。
| 名称 | 用法 | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 类路径选项 | |||||||||||||||
| -bootclasspath <dir 1>;<dir 2>;...;<dir P> | 这是目录或 jar 文件的列表,用来引导编译器使用的类文件。缺省情况下,将使用正在运行的 VM 的库。这些条目是由平台路径分隔符分隔的。 每个目录或文件都可以在“[”与“]”之间指定类型的访问规则。 如果未指定引导类路径,那么编译器将按顺序使用系统属性
|
||||||||||||||
| -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 编码。如果指定了多种缺省源文件编码,那么会使用最后一种编码。 例如:
|
||||||||||||||
| 一致性选项 | |||||||||||||||
| -target 1.1 到 1.7 或者(5、5.0 等等) | 此选项指定 .class 文件目标设置。可能的值是:
可以使用 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 等等) | 这用于指定编译器所期望的源代码级别。 可能的值是:
|
||||||||||||||
| 警告选项 | |||||||||||||||
| -?:warn -help:warn | 显示高级警告选项 | ||||||||||||||
| -warn:... | 指定启用的警告集合。 例如:-warn:unusedLocal,deprecation
|
||||||||||||||
| 缺省 | 标记名称 | 描述 | |||||||||||||
| +/- | 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 和不推荐使用的警告将转换为错误。所有其他警告仍将报告为警告。
|
||||||||||||||
| -deprecation | 等同于 -warn:+deprecation。 | ||||||||||||||
| -properties <file> | 根据属性文件内容设置警告/错误选项。此选项可与 -nowarn、-err:.. 或 -warn:.. 选项配合使用,但命令行上的最后一项设置要使用的选项。
属性文件内容可通过以下方式生成:在现有 Java 项目上设置特定于项目的设置并在 ... 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] | 设置调试属性级别
|
||||||||||||||
| -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显示为: /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。 |