java 9 改进的 @deprecated 注解
注解 @deprecated 可以标记 java api 状态,可以是以下几种:
- 使用它存在风险,可能导致错误
- 可能在未来版本中不兼容
- 可能在未来版本中删除
- 一个更好和更高效的方案已经取代它。
java 9 中注解增加了两个新元素:since 和 forremoval。
- since: 元素指定已注解的api元素已被弃用的版本。
- forremoval: 元素表示注解的 api 元素在将来的版本中被删除,应该迁移 api。
以下实例为 java 9 中关于 boolean 类的说明文档,文档中 @deprecated 注解使用了 since 属性:boolean class。
以下实例为在 java 9 中关于系统类的说明文档,文档中 @deprecated 注解使用了 forremoval 属性:system class。
【说明】:本文章由站长整理发布,文章内容不代表本站观点,如文中有侵权行为,请与本站客服联系(QQ:254677821)!