@Deprecated注解

1 简介

Deprecated 同 SuppressWarnings 一样,都是 J2SE 5.0 中定义在Java.lang包中的标准 Annotation 之一,其可以标注在类、字段和方法上,其作用为:不鼓励程序员使用被 @Deprecated 注释的程序元素,因为被 @Deprecated 注释的元素很危险(例如,现阶段 JDK 提供的带有 @Deprecated 注释的元素在以后的 JDK 版本中可能被删除)或存在更好的选择。在使用不被赞成的程序元素或在不被赞成的代码中执行重写时,编译器会发出警告。

2 使用方法

在不建议其他程序员使用的类、方法和字段上,添加@Deprecated注解标示即可。例如

?
1
2
3
4
@Deprecated
class TestClass {
// do something
}
3 扩展延伸

在 Java 中,还有一个和@Deprecated非常相似的注解即@deprecated,其用于在 Javadoc 工具生成文档的时候,表示此类注解的类、接口、方法和字段已经被废止。

例如:
有时重写时方法的传参和返回值也会发生变化,这样往往导致调用的代码也跟着出错,我们看下spring的代码是如何处理这样的事,先看下面两段代码,上面这段是之前的getHandler方法,现在需要改成第二段代码,方法的参数cache不要了,而且方法内部的实现肯定也变化了,spring框架的作者先是在之前的方法上加了@Deprecated标志,然后让旧的方法去调用新的方法,相当于旧方法起了个临时代理的作用,这样之前调旧gethandler方法的代码也不会出问题,而实现已经切换成了新的实现,并且后面写代码的人看到了旧方法的@Deprecated标志后,也会避免调用它,而直接选择去调用新的getHandler方法。

@Deprecated
protected HandlerExecutionChain getHandler(HttpServletRequest request, boolean cache) throws Exception {
return getHandler(request);
}
复制代码
protected HandlerExecutionChain getHandler(HttpServletRequest request) throws Exception {
for (HandlerMapping hm : this.handlerMappings) {
if (logger.isTraceEnabled()) {
logger.trace(
“Testing handler map [” + hm + “] in DispatcherServlet with name '” + getServletName() + “’”);
}
HandlerExecutionChain handler = hm.getHandler(request);
if (handler != null) {
return handler;
}
}
return null;
}

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值