通过拦截器Interceptor实现Spring MVC中Controller接口访问信息的记录

java web工程项目使用了Spring+Spring MVC+Hibernate的结构，在Controller中的方法都是用于处理前端的访问信息，Controller通过调用Service进行业务处理后给前端返回ModelAndView对象或者只返回Json格式数据。如果能够获得Http请求在后端程序中处理的相关信息，对于开发和调试时十分方便的。工程中使用了Spring MVC的Interceptor对所有Http请求及其响应进行拦截，从而获取到本次访问接口信息以及程序处理时长等信息，特意在此记录一下实现方式。

package com.api.web.interceptor;  2  3 import java.util.Arrays;  4 import java.util.Date;  5 import java.util.Map;  6 import java.util.Map.Entry;  7  8 import javax.servlet.http.HttpServletRequest;  9 import javax.servlet.http.HttpServletResponse; 10 11 import org.apache.log4j.Logger; 12 import org.springframework.web.method.HandlerMethod; 13 import org.springframework.web.servlet.HandlerInterceptor; 14 import org.springframework.web.servlet.ModelAndView; 15 16 import com.yijia.api.util.SimpleDateFormatCache; 17 18 /** 19  * 记录信息:</br> 访问时间</br>Controller路径</br>对应方法名</br>请求参数信息</br>请求相对路径</br>请求处理时长 20  * 21  * @author Administrator 22  * 23 */ 24 public class TimeCostInterceptor implements HandlerInterceptor { 25 26 // before the actual handler will be executed 27 public boolean preHandle(HttpServletRequest request, 28 HttpServletResponse response, Object handler) throws Exception { 29 long startTime = System.currentTimeMillis(); 30 request.setAttribute("startTime", startTime); 31 if (handler instanceof HandlerMethod) { 32 StringBuilder sb = new StringBuilder(1000); 33 34 sb.append("-----------------------").append(SimpleDateFormatCache.getYmdhms().format(new Date())) 35 .append("-------------------------------------\n"); 36 HandlerMethod h = (HandlerMethod) handler; 37 sb.append("Controller: ").append(h.getBean().getClass().getName()).append("\n"); 38 sb.append("Method    : ").append(h.getMethod().getName()).append("\n"); 39 sb.append("Params    : ").append(getParamString(request.getParameterMap())).append("\n"); 40 sb.append("URI       : ").append(request.getRequestURI()).append("\n"); 41  System.out.println(sb.toString()); 42  } 43 return true; 44  } 45 46 // after the handler is executed 47 public void postHandle(HttpServletRequest request, 48  HttpServletResponse response, Object handler, 49 ModelAndView modelAndView) throws Exception { 50 long startTime = (Long) request.getAttribute("startTime"); 51 long endTime = System.currentTimeMillis(); 52 long executeTime = endTime - startTime; 53 if(handler instanceof HandlerMethod){ 54 StringBuilder sb = new StringBuilder(1000); 55 sb.append("CostTime  : ").append(executeTime).append("ms").append("\n"); 56 sb.append("-------------------------------------------------------------------------------"); 57  System.out.println(sb.toString()); 58  } 59  } 60 61 private String getParamString(Map<String, String[]> map) { 62 StringBuilder sb = new StringBuilder(); 63 for(Entry<String,String[]> e:map.entrySet()){ 64 sb.append(e.getKey()).append("="); 65 String[] value = e.getValue(); 66 if(value != null && value.length == 1){ 67 sb.append(value[0]).append("\t"); 68 }else{ 69 sb.append(Arrays.toString(value)).append("\t"); 70  } 71  } 72 return sb.toString(); 73  } 74 75 public void afterCompletion(HttpServletRequest arg0, 76  HttpServletResponse arg1, Object arg2, Exception arg3) 77 throws Exception { 78 79  } 80 }

由于Interceptor是Spring MVC的功能组件，所以需要把此拦截器配置在springmvc的xml配置文件中（或者使用其他配置方式比如javaConfig）：

 <mvc:interceptors>
        <!-- 使用bean定义一个Interceptor，直接定义在mvc:interceptors根下面的Interceptor将拦截所有的请求 -->
        <mvc:interceptor>
            <mvc:mapping path="/**"/>            
            <!-- 需排除拦截的地址 -->  
            <mvc:exclude-mapping path="/" />
            <mvc:exclude-mapping path="/test" />
            <!-- 定义在mvc:interceptor下面的表示是对特定的请求才进行拦截的 -->
            <bean class="com.api.web.interceptor.TimeCostInterceptor"/>
        </mvc:interceptor>
    </mvc:interceptors>

定义并配置好好拦截器后，在程序Controller中的接口被访问的时候，相关访问信息就会输出到控制台上，也可以使用日志将访问信息记录到日志中。

记录效果如下所示：

 

总结：

拦截器通对用户请求进行拦截可以对用户的请求（HttpServletRequest）进行预处理，也可以对返回给用户的响应（HttpServletResponse）进行访问后处理，还可以在请求完成后针对请求的异常信息进行处理。能够在request对象和response对象中进行操作的问题都可以通过拦截器进行统一处理，常用的场景包括用户登录控制、权限检查，跨域请求访问权限控制等。