java 中@Deprecated 注解的实例详解

java 中@deprecated 注解的实例详解

1 简介

　　deprecated 同 suppresswarnings 一样，都是 j2se 5.0 中定义在java.lang包中的标准 annotation 之一，其可以标注在类、字段和方法上，其作用为：不鼓励程序员使用被 @deprecated 注释的程序元素，因为被 @deprecated 注释的元素很危险（例如，现阶段 jdk 提供的带有 @deprecated 注释的元素在以后的 jdk 版本中可能被删除）或存在更好的选择。在使用不被赞成的程序元素或在不被赞成的代码中执行重写时，编译器会发出警告。

2 使用方法

在不建议其他程序员使用的类、方法和字段上，添加@deprecated注解标示即可。例如

@deprecated
class testclass {
  // do something
}

3 扩展延伸

　　在 java 中，还有一个和@deprecated非常相似的注解即@deprecated，其用于在 javadoc 工具生成文档的时候，表示此类注解的类、接口、方法和字段已经被废止。

 以上就是java 中@deprecated 注解的实例详解，如有疑问请留言或者到本站社区交流讨论，感谢阅读，希望能帮助到大家，谢谢大家对本站的支持！