java标记过期方法

2019-11-09 19:16:35

ava注解:@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


  • 2017-01-16 15:09:40

    Javascript模块化编程(一):模块的写法

    随着网站逐渐变成"互联网应用程序",嵌入网页的Javascript代码越来越庞大,越来越复杂。网页越来越像桌面程序,需要一个团队分工协作、进度管理、单元测试等等......开发者不得不使用软件工程的方法,管理网页的业务逻辑。

  • 2017-01-16 15:16:24

    Javascript模块化编程(二):AMD规范

    AMD是"Asynchronous Module Definition"的缩写,意思就是"异步模块定义"。它采用异步方式加载模块,模块的加载不影响它后面语句的运行。所有依赖这个模块的语句,都定义在一个回调函数中,等到加载完成之后,这个回调函数才会运行。

  • 2017-01-16 15:19:24

    RequireJS 入门指南

    如今最常用的JavaScript库之一是RequireJS。最近我参与的每个项目,都用到了RequireJS,或者是我向它们推荐了增加RequireJS。在这篇文章中,我将描述RequireJS是什么,以及它的一些基础场景。

  • 2017-01-16 15:22:30

    CommonJS规范

    CommonJS模块规范。 根据这个规范,每个文件就是一个模块,有自己的作用域。在一个文件里面定义的变量、函数、类,都是私有的,对其他文件不可见。

  • 2017-01-17 15:42:03

    vue-cli 发布(译)

    当我们真正开发一个应用的时候,我们不可避免的会用到一大堆的工具,模块化、预处理器、热模块加载、代码校验和测试。这些工具对于一个需要长期维护的大型应用是必须的,但是项目初始化将会是让人痛苦的事情。这就是为什么我们做了 vue-cli 。