注解 @Deprecated、@deprecated 的使用、说明

今天偶然在项目中注意到一个注解：@Deprecated

说明：

@Deprecated 表示此方法已废弃、暂时可用，但以后此类或方法都不会再更新、后期可能会删除，建议后来人不要调用此方法。

用法：

此注解可用于类上、方法上、属性上。

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

相似注解： @deprecated ：

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

调用有 @Deprecated 注解的方法的风险：

可能导致错误、可能在以后版本中代码不兼容、可能在以后版本中原方法已被删除、可能已有更优的方案取代它。

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

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

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

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

注解 @Deprecated、@deprecated 的使用、说明相关推荐

java注解：@Deprecated(不建议使用的，废弃的)；@SuppressWarnings(忽略警告，达到抑制编译器产生警告的目的)
java注解:@Deprecated(不建议使用的,废弃的), @SuppressWarnings(忽略警告,达到抑制编译器产生警告的目的) @Deprecated可以修饰类.方法.变量,在java源 ...
Java基础系统注解 @Override @Deprecated @SuppressWarnings 使用的方法及原因
Java 系统注解为什么用?: 好处:使用系统定义的注解,可以在编译时对程序进行检查. 注解用在包.类.字段.方法.局部变量.方法参数等的前面,对这些元素进行说明和注释. @Override @Ov ...
Java SE 注解 @Override @Deprecated @SuppressWarnings
注解的理解 1) 注解 (Annotation) 也被称为元数据 (Metadata) ,用于修饰解释包.类.方法.属性.构造器.局部变量等数据信息. 2) 和注释一样,注解不影响程序逻辑,但注解可 ...
Java中的注解以及应用 @Deprecated @SupressWarning @Override
Annotation注解在Java中有着很广泛的 ,他是做为一种标识为javac所识别 ,.每一个注解都对应这一个 Java类在java.lang包中有三个注解分别是 Deprecate ...
Java中的注解以及应用 @Deprecated @SupressWarning @Override
Annotation注解在 Java 中有着很广泛的,他是做为一种标识为javac所识别,.每一个注解都对应这一个Java类在java.lang包中有三个注解分别是 Deprecated ...
@Deprecated 注解（@Documented 、@Retention、@Target）
前些天发现了一个巨牛的人工智能学习网站,通俗易懂,风趣幽默,忍不住分享一下给大家.点击跳转到教程. // 在看 Unsafe 类源码时看到一个注解:@Deprecated,似曾相识... @Depre ...
@Deprecated（注解）
随着项目的迭代和更新,项目中的类.方法或者字段不建议大家继续使用时,我们通常会使用@Deprecated注解. @Deprecated表示此内容已废弃.暂时可用,但以后此内容都不会再更新或之后版本可能 ...
C++关键字deprecated
指示声明有此属性的名字或实体被弃用,即允许但因故不鼓励使用. 语法 [[deprecated]] [[deprecated( 字符字面量 )]] 解释指示允许使用声明有此属性的名称或实体,但因故不鼓 ...
Java注解---通俗易懂
本文转载于Java注解-最通俗易懂的注解 Annotation 中文译过来就是注解.标释的意思,在 Java 中注解是一个很重要的知识点,但经常还是有点让新手不容易理解. 我个人认为,比较糟糕的技术文 ...

注解 @Deprecated、@deprecated 的使用、说明

今天偶然在项目中注意到一个注解：@Deprecated

注解 @Deprecated、@deprecated 的使用、说明相关推荐

最新文章

热门文章