@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;
}