@Deprecated 注解详情

一、@Deprecated 说明

• 若类、方法、属性加上该注解之后，表示不再建议使用，调用时会出现删除线，但并不代表不能用，只是不推荐使用，因为有更好的替代

二、使用场景

• 使用它存在风险，可能导致错误
• 可能在未来版本中不兼容
• 可能在未来版本中删除
• 一个更好和更高效的方案已经取代它

三、@Deprecated 用法

• 此注解可以用在类、方法、属性上。在给定此注解后，应该在注释中说明：废弃此方法后的代替方法是哪个、处理原逻辑代替方案是什么 本身不打算代替，而是直接清除的，则最好给出会清除此方法的具体代码版本号

四、Java 9 中注解增加了两个新元素：since 和 forRemoval

/**
 * since: 元素指定已注解的 API 元素已被弃用的版本
 * forRemoval: 元素表示注解的 API 元素在将来的版本中被删除，应该迁移 API
 */
@Deprecated(since = 1.0, forRemoval = true)