四史学习
体力透支注解@Deprecated、@deprecated的使⽤、说明和妈妈
今天偶然在项⽬中注意到⼀个注解:@Deprecated
1. 说明:
手相分析
拉肚子可以喝牛奶吗@Deprecated 表⽰此⽅法已废弃、暂时可⽤,但以后此类或⽅法都不会再更新、后期可能会删除,建议后来⼈不要调⽤此⽅法。
2. ⽤法:
此注解可⽤于类上、⽅法上、属性上。
通常在给定此注解后,应该在⽅法注释中同样说明:废弃此⽅法后的代替⽅法是哪个、处理原逻辑代替⽅案是什么 、本⾝不打算代替,⽽是直接清除的,则最好给出会清除此⽅法的具体代码版本号 。
3. 相似注解: @deprecated :
有此注解后,Javadoc ⼯具⽣成⽂档时会标注此类/接⼝、⽅法、字段已经被废⽌。
4. 调⽤有 @Deprecated 注解的⽅法的风险:
白菜炒猪血可能导致错误、可能在以后版本中代码不兼容、可能在以后版本中原⽅法已被删除、可能已有更优的⽅案取代它。康复训练>美狄斯
坚持调⽤时,开发⼯具也会在调⽤处⽅法上加上横线,划掉⽅法:表⽰被调⽤⽅法已经过时。
5. Java 9 中注解增加了两个新元素:since 和 forRemoval。
since: 指定已注解的API元素已被弃⽤的版本。
forRemoval: 表⽰在将来的既定版本中会被删除,应该迁移 API。
如:
@Deprecated(since = "1.2", forRemoval = true)