注解@Deprecated、@deprecated的使⽤、说明
今天偶然在项⽬中注意到⼀个注解:@Deprecated美丽中国纪录片
1. 说明:
@Deprecated 表⽰此⽅法已废弃、暂时可⽤,但以后此类或⽅法都不会再更新、后期可能会删除,建议后来⼈不要调⽤此⽅法。
2. ⽤法:
此注解可⽤于类上、⽅法上、属性上。
通常在给定此注解后,应该在⽅法注释中同样说明:废弃此⽅法后的代替⽅法是哪个、处理原逻辑代替⽅案是什么 、本⾝不打算代替,⽽是直接清除的,则最好给出会清除此⽅法的具体代码版本号 。
3. 相似注解: @deprecated :圣诞快乐英文怎么说
绝望的主妇
有此注解后,Javadoc ⼯具⽣成⽂档时会标注此类/接⼝、⽅法、字段已经被废⽌。
4. 调⽤有 @Deprecated 注解的⽅法的风险:
samsonite
2012山东高考英语
四月英语可能导致错误、可能在以后版本中代码不兼容、可能在以后版本中原⽅法已被删除、可能已有更优的⽅案取代它。
职高有什么专业坚持调⽤时,开发⼯具也会在调⽤处⽅法上加上横线,划掉⽅法:表⽰被调⽤⽅法已经过时。
5. Java 9 中注解增加了两个新元素:since 和 forRemoval。
上海礼仪since: 指定已注解的API元素已被弃⽤的版本。
forRemoval: 表⽰在将来的既定版本中会被删除,应该迁移 API。女翻译
如:
byd是什么意思
@Deprecated(since = "1.2", forRemoval = true)