在最近的项目中,发现了一个一个注解@Deprecated,总结了下:
1.@Deprecated注解说明:
如果方法上有@Deprecated注解,表示此方法已经被废弃、但是目前还是可用的,只是以后此类或方法都不会再更新、后期有可能会删除,建议后来开发者尽量不要调用此方法
2.@Deprecated注解用法:
该注解可以用在类上、方法上、属性上
开发人员通常在使用此注解后,应该在相应的注释中去说明:废弃此方法后的代替方法是哪个、处理原逻辑代替方案是什么 ;
坚持调用时,开发工具也会在调用处方法上加上横线,划掉方法:表示被调用方法已经过时。
Java 9 中注解增加了两个新元素:since 和 forRemoval。
since: 指定已注解的API元素已被弃用的版本。
forRemoval: 表示在将来的既定版本中会被删除,应该迁移 API。
如:
@Deprecated(since = "1.2", forRemoval = true)
相似注解: @deprecated :
有此注解后,Javadoc 工具生成文档时会标注此类/接口、方法、字段已经被废止。