java 中@Deprecated 注解的实例详解
投稿:lqh
这篇文章主要介绍了java 中@Deprecated 注解的实例详解的相关资料,这里对@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 注解的实例详解,如有疑问请留言或者到本站社区交流讨论,感谢阅读,希望能帮助到大家,谢谢大家对本站的支持!