编译器

在下列各节中,编译器首选项是独立的:

问题

选项

描述

缺省值

不可达代码

(可选)可以将不可达代码报告为错误、警告或者简单地忽略它。生成字节码时始终会将它优化掉。注意,根据 Java 语言规范,不可获取的代码应为错误。

错误

无法解析的导入语句

(可选)可以将不能解析的导入语句报告为错误、警告或者忽略它。注意,根据 Java 语言规范,不可解析的导入语句应为错误。

错误

未使用(即,从未读取过)的局部变量

当启用此项时,编译器将对未使用的局部变量(即,从未读取的变量)发出错误或警告。

忽略

未使用(即,从未读取过)的参数

当启用此项时,编译器将对未使用的方法参数(即,从未读取的参数)发出错误或警告。

忽略

未使用的导入

当启用此项时,编译器将对未使用的导入引用发出错误或警告。

警告

未使用的私有类型、方法或字段

当启用此项时,每当声明了私有方法或字段,但是从未在同一单元中使用它们时,编译器就会发出错误或警告。

忽略

未外部化的字符串的使用

当启用此项时,编译器将对未外部化的字符串文字(即,未使用 //$NON-NLS-<n>$ 来标记)发出错误或警告。 

忽略

不建议使用的 API 的用法

当启用此项时,如果使用了不建议使用的 API,编译器将发出错误或警告信号。

警告

发出信号通知使用不建议使用的代码中的不建议使用的 API

当启用此项时,编译器将发出信号通知使用不建议使用的代码中的不建议使用的 API。该问题的严重性由“不建议使用的 API 的用法”选项来控制。

关闭

每个编译单元报告的最大问题数

指定每个编译单元报告的最大问题数。 

100

样式

选项

描述

缺省值

方法被覆盖,但是包不可视

包缺省方法在不同包中不可视,因此不能覆盖它。当启用此选项时,对于这种方案,编译器将发出错误或警告信号。

警告

带有构造函数名的方法

使用构造函数名来命名方法是一种不太好的编程方法。当启用此选项时,对于这种方案,编译器将发出错误或警告信号。

警告

接口方法与受保护的“Object”方法的冲突

当启用此项时,每当接口定义了与非继承的 Object 方法不兼容的方法时,编译器就会发出错误或警告。在解决此冲突之前,将不能实现这样的接口,例如

interface I {
   int clone();
}

警告

隐藏的 catch 块

对于 try 语句局部而言,某些 catch 块可能隐藏其它内容,例如:

try { throw new java.io.CharConversionException();
} catch (java.io.CharConversionException e) {
} catch (java.io.IOException e) {}.

当启用此选项时,编译器将对与检查到的异常相对应的已隐藏 catch 块发出错误或警告。

警告

对静态成员的非静态访问

当启用此项时,每当使用表达式接收器来访问静态字段或方法时,编译器就会发出错误或警告。 应当使用类型名来限定对静态成员的引用。

警告

访问封装类型的不可访问的成员

当启用此项时,每当编译器模拟访问封装类型的不可访问的成员时,编译器就会发出错误或警告。这种访问可能会影响性能。

忽略

赋值不起作用(例如,“x = x”)

当启用此项时,每当赋值不起作用时(例如,“x = x”),编译器将发出错误或警告。

警告

在字符串并置中使用 char 数组

当启用此项时,每当在字符串并置中使用 char[] 表达式时,编译器就会发出错误或警告,

"hello" + new char[]{'w','o','r','l','d'}

警告

相符和类文件

选项

描述

缺省值

编译器相符级别

指定 JDK 编译器相符级别。 

1.3

使用缺省相符设置

如果启用此项,则将应用编译器相符级别的缺省相符设置。 

打开

生成的类文件兼容性

指定生成的类文件的兼容性。 

1.1

源代码兼容性

指定源代码是否与 1.3 或 1.4 兼容。从 1.4 开始,“assert”是为断言支持保留的关键字。

1.3

将“assert”报告为标识

当启用此项时,每当将“assert”用作标识时(在 JDK 1.4 中是保留的关键字),编译器就会发出错误或警告。

忽略

向已生成的类文件添加变量属性

如果启用了此项,则会将变量属性添加至类文件。这将使局部变量名称显示在调试器中(在明确指定变量的位置)。获得的 .class 文件就更大了。

打开

向已生成的类文件添加行号属性

如果启用了此项,则会将行号信息添加至类文件。这将使得在调试器中突出显示源代码。

打开

向已生成的类文件添加源文件名

如果启用了此项,则会将源文件名添加至类文件。这将使调试器显示相应的源代码。

打开

保留未使用的局部变量

如果启用了此项,则不会从类文件中取消未使用(即,从未读取过)的局部变量。如果取消了未使用的局部变量,则会潜在地改变调试。

打开

构建路径

选项

描述

缺省值

不完整的构建路径

指示当类路径上的条目不存在、不合法或不可视(例如,关闭了引用项目)时所报告问题的严重性。

错误

循环依赖性

指示当一个项目涉及到循环时所报告问题的严重性。

错误

重复的资源

指示当要将多次出现的资源复制到输出位置中时所报告问题的严重性。

警告

构建路径出错时异常终止构建

如果类路径无效,则允许构建器异常终止。

打开

在完全构建时清空输出文件夹

指示在执行完全构建操作时是否允许“Java 构建器”清除输出文件夹。

打开

在源文件夹中启用使用排除模式

当禁用此项时,项目类路径上没有任何条目可以与排除模式相关联。

打开

允许对源文件夹使用多个输出位置

当禁用此项时,项目类路径上的任何条目都不能与特定输出位置相关联,从而防止使用多个输出位置。

打开

已过滤的资源

未复制到输出文件夹的用逗号隔开的文件模式的列表。 

''

相关概念
Java 构建器

相关任务
构建 Java 程序
使用构建路径
使用 JRE

相关参考
“类路径变量”首选项
“Java 构建路径”属性

Copyright (c) 2000, 2003 IBM Corporation and others. All Rights Reserved.