@Deprecated 表示此方法已废弃、暂时可用,但以后此类或方法都不会再更新、后期可能会删除,建议后来人不要调用此方法。
此注解可用于类上、方法上、属性上。
通常在给定此注解后,应该在方法注释中同样说明:废弃此方法后的代替方法是哪个、处理原逻辑代替方案是什么 、本身不打算代替,而是直接清除的,则最好给出会清除此方法的具体代码版本号 。
有此注解后,Javadoc 工具生成文档时会标注此类/接口、方法、字段已经被废止。
可能导致错误、可能在以后版本中代码不兼容、可能在以后版本中原方法已被删除、可能已有更优的方案取代它。
坚持调用时,开发工具也会在调用处方法上加上横线,划掉方法:表示被调用方法已经过时。
since: 指定已注解的API元素已被弃用的版本。
forRemoval: 表示在将来的既定版本中会被删除,应该迁移 API。
如:
@Deprecated(since = "1.2", forRemoval = true)