Java基础 - 常用注解@SuppressWarings

文章目录

Java基础 - 常用注解@SuppressWarings

一、概述

java.lang.SuppressWarnings是J2SE5.0中标准的Annotation之一。可以标注在类，字段、方法、构造方法以及局部变量上。

@SuppressWarings作用：告诉编译器忽略指定的警告，不用在编译完成后出现警告信息。

@SuppressWarings使用：

@SuppressWarnings(“”)
@SuppressWarnings({})
@SuppressWarnings(value={})

value -将由编译器在注释的元素中取消显示的警告集。允许使用重复的名称。忽略第二个和后面出现的名称。出现未被识别的警告名不是错误：编译器必须忽略无法识别的所有警告名。但如果某个注释包含未被识别的警告名，那么编译器可以随意发出一个警告。

各编译器供应商应该将它们所支持的警告名连同注释类型一起记录。鼓励各供应商之间相互合作，确保在多个编译器中使用相同的名称。

常用注解演示：

@SuppressWarnings(“unchecked”)

告诉编译器忽略unchecked警告信息，如使用List、ArrayList等未进行参数化产生的警告信息。
@SuppressWarnings(“serial”)

告诉编译器忽略：The serializable class WmailCalendar does notdeclare a static final serialVersionUID field of type long信息。
@SuppressWarnings(“deprecation”)

告诉编译器忽略使用注解@Deprecated警告信息
@SuppressWarnings(“unchecked”, “deprecation”)

告诉编译器同时忽略unchecked和deprecation的警告信息。

二、 @SuppressWarings注解使用

2.1. 抑制单类型的警告

@SuppressWarnings("unchecked")
public void annotationDemo(String item){
  @SuppressWarnings("rawtypes")
   List items = new ArrayList();
   items.add(item);
}

2.2. 抑制多类型的警告

@SuppressWarnings(value={"unchecked", "rawtypes"})
public void annotationDemo(String item){
   List items = new ArrayList();
   items.add(item);
}

2.3. 抑制所有类型的警告

@SuppressWarnings(value={"all"})
public void annotationDemo(String item){
   List items = new ArrayList();
   items.add(item);
}

四、注解目标

通过 @SuppressWarnings 的源码可知，其注解目标为类、字段、函数、函数入参、构造函数和函数的局部变量。

建议注解应声明在最接近警告发生的位置。

goyeer

【Java基础】 - 常用注解@SuppressWarings