代码重构的技巧——合理使用@Deprecated

时间:2023-08-15 16:50:50

  最近由于工作环境不太理想,很长时间没心情写技术博文,今天在调试springMVC的DispatcherSevlet类的代码时,看到一处代码且联想到项目中程序员的一些做法,觉得有必要写一下。

我们在做项目时,前期写的类中的一些代码可能由于需求变化的原因需要重写,有时重写时方法的传参和返回值也会发生变化,这样往往导致调用的代码也跟着出错,我们看下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;
}