注解 @Deprecated的使用说明

说明：

@Deprecated 表示此方法或类已过时，坚持调用时，开发工具也会在调用处方法上加上横线划掉（表示被调用方法已经过时），但并不代表不能调用，只是说不推荐使用，因为还有更好的方法可以调用，并且以后此方法或类不会再更新、后期可能会删除。

用法：

此注解可用于类上、方法上、属性上。
通常在给定此注解后，应该在方法注释中同样说明：废弃此方法后的代替方法是哪个、处理原逻辑代替方案是什么 、本身不打算代替，而是直接清除的，则最好给出会清除此方法的具体代码版本号 。

Alibaba Java开发手册中的OOP规约：外部正在调用或者二方库依赖的接口，不允许修改方法签名，避免对接口调用方产生影响。接口过时必须加@Deprecated 注解，并清晰地说明采用的新接口或者新服务是什么。