专栏首页java 微风注解 @Deprecated、@deprecated 的使用、说明
原创

注解 @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)

原创声明,本文系作者授权云+社区发表,未经许可,不得转载。

如有侵权,请联系 yunjia_community@tencent.com 删除。

我来说两句

0 条评论
登录 后参与评论

相关文章

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

    版权声明:这可是本菇凉辛辛苦苦原创的,转载请一定带上我家地址,不要忘记了哈 . https://b...

    微风-- 轻许--
  • @JsonFormat Date类型时间 格式化 注解 使用

    @JsonFormat注解是一个时间格式化注解,比如我们存储在mysql中的数据是date类型的,当我们读取出来封装在实体类中的时候,就会变成英文时间格式,而不...

    微风-- 轻许--
  • 得当前时间的工具类

    原文链接:https://zhidao.baidu.com/question/878271990996467412.h...

    微风-- 轻许--
  • 注解 @Deprecated、@deprecated 的使用、说明

    版权声明:这可是本菇凉辛辛苦苦原创的,转载请一定带上我家地址,不要忘记了哈 . https://b...

    微风-- 轻许--
  • 塔说 | 20年后,人类社会最有可能实现的8个转变

    导读:到2030年,人类社会发展进入到新的科技时代,生活方式和节奏等方方面面或许会被改变 1.1000美元购买到人脑处理速度的计算机 ? 在2030年,你只要...

    灯塔大数据
  • iOS开发之使用Runtime给Model类赋值

      本篇博客算是给网络缓存打个基础吧,本篇博客先给出简单也是最容易使用的把字典转成实体类的方法,然后在给出如何使用Runtime来给Model实体类赋值。本篇博...

    lizelu
  • 机器学习算法之朴素贝叶斯算法

    假设有随机变量A和B,此时P(A=a,B=b)用于表示A=a且B=b同时发生的概率。这类包含多个条件且所有条件同时成立的概率叫做联合概率。与之对应,P(A=a)...

    BBuf
  • python用列表实现多重赋值

    py3study
  • JavaScript 数据结构(2-1):栈与队列-栈篇

    栈和队列是web开发中最常用的两种数据结构。绝大多数用户,甚至包括web开发人员,都不知道这个惊人的事实。如果你是一个程序员,那么请听我讲两个启发性的例子:使用...

    疯狂的技术宅
  • 五个套路看懂微信小程序开发(上)

    你或许听说过,快速入门就是要学最小必要知识。而我最近在看微信小程序的官方教程时发现,这个教程虽然简单,但对于微信小程序开发来说,80%的套路都能从这里学习到,你...

    极乐君

扫码关注云+社区

领取腾讯云代金券