关于Java中@SuppressWarnings的正确使用方法

2023-05-19 17:05:04 java 正确 使用方法

@SuppressWarnings比较常见,理解和使用起来都很简单。

通过源码可以看出,支持在类、属性、方法、参数、构造方法、本地变量上使用。

img

@SuppressWarnings注解的使用有三种:

  • @SuppressWarnings(“unchecked”) [抑制单类型的警告]
  • @SuppressWarnings(“unchecked”,“rawtypes”) [抑制多类型的警告]
  • @SuppressWarnings(“all”) [ 抑制所有类型的警告]

下面一个简单的例子:

public class Machine {
    private List versions;
    public void addVersion(String version) {
        versions.add(version);
    }
}

编译器会发出使用原始数据类型的警告

如果不想修复这个问题,可以通过@SuppressWarnings注解来抑制编译器的警告。

该注解允许指定忽略该方法的哪些特定警告。 不同的编译器或IDE的警告类型可能会不同,最常见的两种类型是deprecation和unchecked。

deprecation 告诉编译器忽略过时的方法或类型检查。

unchecked 告诉编译器忽略原始类型检查

public class Machine {
    private List versions;
    @SuppressWarnings("unchecked")
    // or
    @SuppressWarnings({"unchecked"})
    public void addVersion(String version) {
        versions.add(version);
    }
}

如果想抑制多种类型的警告,可以采用字符串数组方式

@SuppressWarnings({<!--{C}%3C!%2D%2D%20%2D%2D%3E-->"unchecked", "deprecated"})

Eclipse Galileo版本支持的抑制警告的名称:

关键字用途
allto suppress all warnings (抑制所有警告)
boxingto suppress warnings relative to boxing/unboxing operations (抑制装箱、拆箱操作时候的警告)
castto suppress warnings relative to cast operations (抑制映射相关的警告)
dep-annto suppress warnings relative to deprecated annotation (抑制启用注释的警告)
deprecationto suppress warnings relative to deprecation (抑制过期方法警告)
fallthroughto suppress warnings relative to missing breaks in switch statements (抑制确在switch中缺失breaks的警告)
finallyto suppress warnings relative to finally block that don’t return (抑制finally模块没有返回的警告)
hidingto suppress warnings relative to locals that hide variable(抑制相对于隐藏变量的局部变量的警告)
incomplete-switchto suppress warnings relative to missing entries in a switch statement (enum case)(忽略没有完整的switch语句)
nlsto suppress warnings relative to non-nls string literals( 忽略非nls格式的字符)
nullto suppress warnings relative to null analysis( 忽略对null的操作)
rawtypesto suppress warnings relative to un-specific types when using generics on class params( 使用generics时忽略没有指定相应的类型)
restrictionto suppress warnings relative to usage of discouraged or forbidden references( 抑制禁止使用劝阻或禁止引用的警告)
serialto suppress warnings relative to missing serialVersionUID field for a serializable class( 忽略在serializable类中没有声明serialVersionUID变量)
static-accessto suppress warnings relative to incorrect static access( 抑制不正确的静态访问方式警告)
synthetic-accessto suppress warnings relative to unoptimized access from inner classes( 抑制子类没有按最优方法访问内部类的警告)
uncheckedto suppress warnings relative to unchecked operations( 抑制没有进行类型检查操作的警告)
unqualified-field-accessto suppress warnings relative to field access unqualified( 抑制没有权限访问的域的警告)
unusedto suppress warnings relative to unused code( 抑制没被使用过的代码的警告)

到此这篇关于关于Java中@SuppressWarnings的正确使用方法的文章就介绍到这了,更多相关Java中@SuppressWarnings使用内容请搜索以前的文章或继续浏览下面的相关文章希望大家以后多多支持!

相关文章