当前位置: 首页 > 工具软件 > deprecated > 使用案例 >

@Deprecated、@deprecated注解说明

江飞白
2023-12-01

在最近的项目中,发现了一个一个注解@Deprecated,总结了下:

1.@Deprecated注解说明:

如果方法上有@Deprecated注解,表示此方法已经被废弃、但是目前还是可用的,只是以后此类或方法都不会再更新、后期有可能会删除,建议后来开发者尽量不要调用此方法

2.@Deprecated注解用法:

该注解可以用在类上、方法上、属性上

开发人员通常在使用此注解后,应该在相应的注释中去说明:废弃此方法后的代替方法是哪个、处理原逻辑代替方案是什么 ;

坚持调用时,开发工具也会在调用处方法上加上横线,划掉方法:表示被调用方法已经过时。

Java 9 中注解增加了两个新元素:since 和 forRemoval。

since: 指定已注解的API元素已被弃用的版本。
forRemoval: 表示在将来的既定版本中会被删除,应该迁移 API。
如:

@Deprecated(since = "1.2", forRemoval = true)

相似注解: @deprecated :

有此注解后,Javadoc 工具生成文档时会标注此类/接口、方法、字段已经被废止。

 类似资料: