java注解：@Deprecated(不建议使用的，废弃的), @SuppressWarnings(忽略警告，达到抑制编译器产生警告的目的)
@Deprecated可以修饰类、方法、变量，在java源码中被@Deprecated修饰的类、方法、变量等表示不建议使用的，可能会出现错误的，可能以后会被删除的类、方法等，如果现在使用，则在以后使用了这些类、方法的程序在更新新的JDK、jar包等就会出错，不再提供支持。 个人程序中的类、方法、变量用@Deprecated修饰同样是不希望自己和别人在以后的时间再次使用此类、方法。 当编译器编译时遇到了使用@Deprecated修饰的类、方法、变量时会提示相应的警告信息。
@SuppressWarnings 可以达到抑制编译器编译时产生警告的目的，但是很不建议使用@SuppressWarnings注解，使用此注解，编码人员看不到编译时编译器提示的相应的警告，不能选择更好、更新的类、方法或者不能编写更规范的编码。同时后期更新JDK、jar包等源码时，使用@SuppressWarnings注解的代码可能受新的JDK、jar包代码的支持，出现错误，仍然需要修改。
可以看成@Deprecated注解和@SuppressWarnings注解是成对出现的。
通过@SuppressWarnings的源码可知，其注解目标为类、字段、函数、函数入参、构造函数和函数的局部变量。而家建议注解应声明在最接近警告发生的位置
/**
* @Description: 编码时我们总会发现如下变量未被使用的警告提示,
* 上述代码编译通过且可以运行，但每行前面的“感叹号”就严重阻碍了我们判断该行是否设置的断点了。
* 这时我们可以在方法前添加 @SuppressWarnings("unchecked") 去除这些“感叹号”。
*/
public String convertXmlToSendMethods(Document document){
//发布方式（1到多个）
List<Element> methodName = document.selectNodes("/alert/code/method/methodName");
List<Element> message = document.selectNodes("/alert/code/method/message");
List<Element> audienceGrp = document.selectNodes("/alert/code/method/audienceGrp");
List<Element> audenceprt = document.selectNodes("/alert/code/method/audenceprt");
//处理‘发布方式’复数
int methodNameSize = 0;
if (null!=methodName && methodName.size()>0) {
methodNameSize = methodName.size();
}
JSONArray jsonArraySendMethods = new JSONArray();
for (int i = 0; i < methodNameSize; i++) {
JSONObject json = new JSONObject();
json.put("methodName", methodName.get(i).getTextTrim());
json.put("message", message.get(i).getTextTrim());
json.put("audienceGrp", audienceGrp.get(i).getTextTrim());
json.put("audenceprt", audenceprt.get(i).getTextTrim());
jsonArraySendMethods.put(json);
}
return jsonArraySendMethods.toString();
}
@SuppressWarings注解
/**
* @Description:示例1——抑制单类型的警告：
*/
@SuppressWarnings("unchecked")
public void addItems(String item){
@SuppressWarnings("rawtypes")
List items = new ArrayList();
items.add(item);
}
/**
* @Description: 示例2——抑制多类型的警告：
*/
@SuppressWarnings(value={"unchecked", "rawtypes"})
public void addItems(String item){
List items = new ArrayList();
items.add(item);
}
/**
* @Description:示例3——抑制所有类型的警告：
*/
@SuppressWarnings("all")
public void addItems(String item){
List items = new ArrayList();
items.add(item);
}
抑制警告的关键字
关键字 | 用途 |
all | to suppress all warnings |
boxing | to suppress warnings relative to boxing/unboxing operations |
cast | to suppress warnings relative to cast operations |
dep-ann | to suppress warnings relative to deprecated annotation |
deprecation | to suppress warnings relative to deprecation |
fallthrough | to suppress warnings relative to missing breaks in switch statements |
finally | to suppress warnings relative to finally block that don’t return |
hiding | to suppress warnings relative to locals that hide variable |
incomplete-switch | to suppress warnings relative to missing entries in a switch statement (enum case) |
nls | to suppress warnings relative to non-nls string literals |
null | to suppress warnings relative to null analysis |
rawtypes | to suppress warnings relative to un-specific types when using generics on class params |
restriction | to suppress warnings relative to usage of discouraged or forbidden references |
serial | to suppress warnings relative to missing serialVersionUID field for a serializable class |
static-access | o suppress warnings relative to incorrect static access |
synthetic-access | to suppress warnings relative to unoptimized access from inner classes |
unchecked | to suppress warnings relative to unchecked operations |
unqualified-field-access | to suppress warnings relative to field access unqualified |
unused | to suppress warnings relative to unused code |
