Java 6：不支持的 @SuppressWarnings(“rawtypes”) 警告

Question

我搬到了一台装有最新 Sun Java 编译器的新机器，并注意到现有 Java 6 代码中出现了一些警告。 Eclipse IDE 建议我用以下内容注释分配：

@SuppressWarnings("rawtypes")

例如：

class Foo<T> {
...
}
...
@SuppressWarnings("rawtypes")
Foo foo = new Foo();

当我移回使用旧编译器 (JDK 1.6.0_20) 的机器时，我注意到这个旧编译器现在发出关于抑制“rawtypes”警告的警告，声称这种抑制不受支持，并建议将其替换为 @SuppressWarnings("unchecked")。另外，在某些地方，默认情况下，最新的编译器让我同时放置“未检查”和“原始类型” - 使用旧编译器编译该代码会产生相同的警告。

如何强制两者之间的向后/向前兼容性，以便编译器都不产生警告？

Answer 1

您可以使用 eclipse 编译器和 javac 都支持的 @SuppressWarnings("unchecked")。

但请记住，@SuppressWarnings 注释是由编译器使用的，它可以有自己的值。 JLS 仅强制编译器理解“未选中”和“已弃用”值（目前）。

编译器供应商应记录他们支持的与此注释类型相关的警告名称。 鼓励他们合作，以确保相同的名称可以在多个编译器中工作。

如果您使用 Helios，则需要设置一个特定选项以允许使用 @SuppressWarnings("unchecked") 而不是 @SuppressWarnings("rawtypes")，

如果无法使用新令牌更新代码，可以在启动 Eclipse 时设置 suppressRawWhenUnchecked=true 系统属性。

---

资源：

• JLS - @SuppressWarnings()
• Eclipse JDT （Java 编译器，@SuppressWarnings 注释的新“rawtypes”标记）

---

编辑：这是现在不可用的 knol用作参考的文章，最初由 Alex Miller 撰写。

Java 中的 @SuppressWarnings 注解

用于抑制各种警告的标准注释

SuppressWarnings 注释已作为标准注释添加到 Java SE 5 中。

定义

@SuppressWarnings 注释在 Java 语言规范 第 9.6.1.5 节。本节规定：

<块引用>

注释类型SuppressWarnings支持程序员控制由Java编译器发出的警告。它包含一个 String 数组元素。如果程序声明使用注释 @SuppressWarnings(value = {S1, ... , Sk}) 进行注释，则 Java 编译器不得报告由 S1、... 之一标识的任何警告。 , Sk 是否会因带注释的声明或其任何部分而生成该警告。

未检查的警告由字符串“unchecked”标识。

后续部分 @Deprecation 还提到可以使用 @SuppressWarnings("deprecation") 抑制这些警告。

有效的警告类型

规范本身中唯一提到的两个警告字符串是“unchecked”和“deprecation”。然而，Sun JDK 在编译器中使用更大的字符串集。您可以通过执行以下命令来确定当前集：

<前><代码>javac -X

它将向您显示（除其他外）-Xlint 的有效设置。

例如，Sun JDK 1.5 显示：

• all - 禁止此代码中的所有警告
• 弃用 - 禁止使用已弃用的代码发出警告
• 未选中 - 禁止来自未选中的调用或未选中的强制转换的警告
• fallthrough - 如果开关在没有找到有效案例（并且没有默认值）的情况下失败，则抑制警告
• 路径 -
• serial - 如果可序列化类未定义serialVersionUID，则抑制警告
• finally - 禁止在finally中返回警告（这将忽略try中的返回）

Sun JDK 1.6 添加了：

• 演员
• divzero - 如果检测到整数除以零，则抑制警告
• 空
• 覆盖
• 无

IDE 和静态分析工具通常支持 @SuppressWarnings 的大量其他可能值。这些值对应于 IDE 执行的特定静态分析检查。

日食

Eclipse 3.3 的 Eclipse 警告值为 记录在 JDT 文档中。

• all - 抑制所有警告
• 装箱 - 抑制与装箱/拆箱操作相关的警告
• cast - 抑制与强制转换操作相关的警告
• dep-ann - 抑制与已弃用注释相关的警告
• 弃用 - 抑制与弃用相关的警告
• fallthrough - 抑制与 switch 语句中缺少中断相关的警告
• finally - 抑制与不返回的finally 块相关的警告
• 隐藏 - 抑制与隐藏变量的局部变量相关的警告
• incomplete-switch - 抑制与 switch 语句中缺少条目相关的警告（枚举情况）
• nls - 抑制与非 nls 字符串文字相关的警告
• null - 抑制与 null 分析相关的警告
• 限制 - 抑制与使用不鼓励或禁止的引用相关的警告
• serial - 抑制与可序列化类缺少serialVersionUID字段相关的警告
• static-access - 抑制与不正确的静态访问相关的警告
• synthetic-access - 抑制与来自内部类的未优化访问相关的警告
• 未检查 - 抑制与未检查操作相关的警告
• unqualified-field-access - 抑制与不合格字段访问相关的警告
• 未使用 - 抑制与未使用代码相关的警告

IntelliJ

NetBeans

示例

指定单个警告的示例：

@SuppressWarnings(“未选中”)
公共无效方法WithScaryWarnings（）{
    列表 rawList = new ArrayList();
    列表<字符串> stringList = (List)rawList;
}

使用两个警告的示例：

@SuppressWarnings({"unchecked","deprecation"})
公共无效方法WithScaryWarnings（）{
    调用DeprecatedMethod();
}

Answer 2

请注意，Eclipse 3.5 不理解原始类型并标记警告以切换到未选中状态。令人沮丧的是 Eclipse 提出了 rawtypes 注释，它导致的问题多于解决的问题。他们应该坚持使用标准的。