@Deprecated 学习笔记

开发环境

• eclipse 4.7.3a
• jdk 9

主题

• 关于@Deprecated 注解
• @Deprecated 的改动
• 忽略@Deprecated警告

关于@Deprecated 注解

在JDK中，API因各种原因而被弃用，例如：

1. 有风险的API（比如Thread.stop方法会导致线程死锁）
2. API被重命名了（比如AWT Component.show/hide 被替换成 setVisible）
3. 有新的、更好的API替代
4. 过时的API在将来会被废弃掉

@Deprecated 的改动

// 支持标记版本号
@Deprecated(since="")

是不推荐使用API时的版本。

@Deprecated(forRemoval=)

forRemoval=true 

表示API将在以后的版本中删除。

forRemoval=false

建议代码不再使用此API, 但是，目前没有意图删除API, 这是默认值。

在注释中使用@deprecated

/**
  * 
  * @deprecated 测试版本不在正式版本中出现
  * 
   */

忽略@Deprecated警告

@SuppressWarnings 注解在编译代码时禁止显示警告。 将@SuppressWarnings注释放在使用不推荐使用的API的类，方法，字段或局部变量的声明中。

@SuppressWarnings("deprecation")
Object[] values = jlist.getSelectedValues();

Github工程地址