springmvc配置拦截器及测试详解

男娘i 2021-09-12 07:10 309阅读 0赞

拦截器  
1.拦截定义  
  
定义拦截器，实现HandlerInterceptor接口。接口中提供三个方法。

**\[java\]**  [view plain][]   [copy][view plain]

1.  **package** cn.edu.hpu.ssm.interceptor;  
2.    
3.  **import** javax.servlet.http.HttpServletRequest;  
4.  **import** javax.servlet.http.HttpServletResponse;  
5.    
6.  **import** org.springframework.web.servlet.HandlerInterceptor;  
7.  **import** org.springframework.web.servlet.ModelAndView;  
8.    
9.  //测试拦截器1  
10. **public** **class** HandlerInterceptor1 **implements** HandlerInterceptor\{  
11.   
12.   
13.     //执行Handler方法之前执行  
14.     //用于身份认证、身份授权  
15.     //比如身份认证，如果认证通过表示当前用户没有登陆，需要此方法拦截不再向下执行  
16.     @Override  
17.     **public** **boolean** preHandle(HttpServletRequest request, HttpServletResponse response,  
18.             Object handler) **throws** Exception \{  
19.           
20.           
21.         //return false表示拦截，不向下执行  
22.         //return true表示放行          
23.         **return** **false**;  
24.     \}  
25.       
26.     //进入Handler方法之后，返回modelAndView之前执行  
27.     //应用场景从modelAndView出发：将公用的模型数据(比如菜单导航)在这里  
28.     //传到视图，也可以在这里统一指定视图  
29.     @Override  
30.     **public** **void** postHandle(HttpServletRequest request, HttpServletResponse response,  
31.             Object handler, ModelAndView modelAndView) **throws** Exception \{  
32.            
33.           
34.     \}  
35.       
36.     //执行Handler完成执行此方法  
37.     //应用场景：统一异常处理，统一日志处理  
38.     @Override  
39.     **public** **void** afterCompletion(HttpServletRequest request, HttpServletResponse response,  
40.             Object handler, Exception ex)  
41.             **throws** Exception \{  
42.            
43.           
44.     \}  
45. \}

2.拦截器配置  
2.1针对HandlerMapping配置  
springmvc拦截器针对HandlerMapping进行拦截设置，如果在某个HandlerMapping中配置拦截，经过该 HandlerMapping映射成功的handler最终使用该拦截器。

**\[html\]**  [view plain][]   [copy][view plain]

1.  **<****bean**  
2.      class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"**>**  
3.      **<****property** name="interceptors"**>**  
4.          **<****list****>**  
5.              **<****ref** bean="handlerInterceptor1"**/>**  
6.              **<****ref** bean="handlerInterceptor2"**/>**  
7.          **</****list****>**  
8.      **</****property****>**  
9.  **</****bean****>**  
10.     **<****bean** id="handlerInterceptor1" class="springmvc.intercapter.HandlerInterceptor1"**/>**  
11.     **<****bean** id="handlerInterceptor2" class="springmvc.intercapter.HandlerInterceptor2"**/>**

一般不推荐使用。  
  
  
2.2类似全局的拦截器  
springmvc配置类似全局的拦截器，springmvc框架将配置的类似全局的拦截器注入到每个HandlerMapping中。

**\[html\]**  [view plain][]   [copy][view plain]

1.    
2.  **<****mvc:interceptors****>**  
3.        
4.      **<****mvc:interceptor****>**  
5.            
6.          **<****mvc:mapping** path="/\*\*"**/>**  
7.          **<****bean** class="cn.edu.hpu.ssm.interceptor.HandlerInterceptor1"**/>**  
8.      **</****mvc:interceptor****>**  
9.      **<****mvc:interceptor****>**  
10.         **<****mvc:mapping** path="/\*\*"**/>**  
11.         **<****bean** class="cn.edu.hpu.ssm.interceptor.HandlerInterceptor2"**/>**  
12.     **</****mvc:interceptor****>**  
13. **</****mvc:interceptors****>**

3.拦截测试  
3.1测试需求  
测试多个拦截器各各方法执行时机。  
  
3.2编写两个拦截  
HandlerInterceptor1.java:

**\[java\]**  [view plain][]   [copy][view plain]

1.  **package** cn.edu.hpu.ssm.interceptor;  
2.    
3.  **import** javax.servlet.http.HttpServletRequest;  
4.  **import** javax.servlet.http.HttpServletResponse;  
5.    
6.  **import** org.springframework.web.servlet.HandlerInterceptor;  
7.  **import** org.springframework.web.servlet.ModelAndView;  
8.    
9.  //测试拦截器1  
10. **public** **class** HandlerInterceptor1 **implements** HandlerInterceptor\{  
11.   
12.   
13.     //执行Handler方法之前执行  
14.     //用于身份认证、身份授权  
15.     //比如身份认证，如果认证通过表示当前用户没有登陆，需要此方法拦截不再向下执行  
16.     @Override  
17.     **public** **boolean** preHandle(HttpServletRequest request, HttpServletResponse response,  
18.             Object handler) **throws** Exception \{  
19.           
20.         System.out.println("HandlerInterceptor1......preHandle");  
21.           
22.         //return false表示拦截，不向下执行  
23.         //return true表示放行          
24.         **return** **false**;  
25.     \}  
26.       
27.     //进入Handler方法之后，返回modelAndView之前执行  
28.     //应用场景从modelAndView出发：将公用的模型数据(比如菜单导航)在这里  
29.     //传到视图，也可以在这里统一指定视图  
30.     @Override  
31.     **public** **void** postHandle(HttpServletRequest request, HttpServletResponse response,  
32.             Object handler, ModelAndView modelAndView) **throws** Exception \{  
33.           
34.         System.out.println("HandlerInterceptor1......postHandle");  
35.           
36.     \}  
37.       
38.     //执行Handler完成执行此方法  
39.     //应用场景：统一异常处理，统一日志处理  
40.     @Override  
41.     **public** **void** afterCompletion(HttpServletRequest request, HttpServletResponse response,  
42.             Object handler, Exception ex)  
43.             **throws** Exception \{  
44.           
45.         System.out.println("HandlerInterceptor1......afterHandle");  
46.           
47.     \}  
48. \}

HandlerInterceptor2.java:

**\[java\]**  [view plain][]   [copy][view plain]

1.  **package** cn.edu.hpu.ssm.interceptor;  
2.    
3.    
4.  **import** javax.servlet.http.HttpServletRequest;  
5.  **import** javax.servlet.http.HttpServletResponse;  
6.    
7.    
8.  **import** org.springframework.web.servlet.HandlerInterceptor;  
9.  **import** org.springframework.web.servlet.ModelAndView;  
10.   
11.   
12. //测试拦截器2  
13. **public** **class** HandlerInterceptor2 **implements** HandlerInterceptor\{  
14.   
15.   
16.     //执行Handler方法之前执行  
17.     //用于身份认证、身份授权  
18.     //比如身份认证，如果认证通过表示当前用户没有登陆，需要此方法拦截不再向下执行  
19.     @Override  
20.     **public** **boolean** preHandle(HttpServletRequest request, HttpServletResponse response,  
21.             Object handler) **throws** Exception \{  
22.           
23.         System.out.println("HandlerInterceptor2......preHandle");  
24.           
25.         //return false表示拦截，不向下执行  
26.         //return true表示放行          
27.         **return** **false**;  
28.     \}  
29.       
30.     //进入Handler方法之后，返回modelAndView之前执行  
31.     //应用场景从modelAndView出发：将公用的模型数据(比如菜单导航)在这里  
32.     //传到视图，也可以在这里统一指定视图  
33.     @Override  
34.     **public** **void** postHandle(HttpServletRequest request, HttpServletResponse response,  
35.             Object handler, ModelAndView modelAndView) **throws** Exception \{  
36.           
37.         System.out.println("HandlerInterceptor2......postHandle");  
38.           
39.     \}  
40.       
41.     //执行Handler完成执行此方法  
42.     //应用场景：统一异常处理，统一日志处理  
43.     @Override  
44.     **public** **void** afterCompletion(HttpServletRequest request, HttpServletResponse response,  
45.             Object handler, Exception ex)  
46.             **throws** Exception \{  
47.           
48.         System.out.println("HandlerInterceptor2......afterHandle");  
49.           
50.     \}  
51. \}

3.3两个拦截器都放行  
将preHandle方法的返回值设为true，然后随便访问一个controller，控制台打印一下结果:

**\[plain\]**  [view plain][]   [copy][view plain]

1.  HandlerInterceptor1...preHandle  
2.  HandlerInterceptor2...preHandle  
3.    
4.  HandlerInterceptor2...postHandle  
5.  HandlerInterceptor1...postHandle  
6.    
7.  HandlerInterceptor2...afterCompletion  
8.  HandlerInterceptor1...afterCompletion

总结：  
preHandle方法按顺序执行，  
postHandle和afterCompletion按拦截器配置的逆向顺序执行。  
  
3.4拦截器1放行，拦截器2不放行

**\[plain\]**  [view plain][]   [copy][view plain]

1.  HandlerInterceptor1...preHandle  
2.  HandlerInterceptor2...preHandle  
3.  HandlerInterceptor1...afterCompletion

总结：  
拦截器1放行，拦截器2 preHandle才会执行。  
拦截器2 preHandle不放行，拦截器2 postHandle和afterCompletion不会执行。  
只要有一个拦截器不放行，postHandle不会执行。  
  
3.5拦截器1不放行，拦截器2不放行

**\[plain\]**  [view plain][]   [copy][view plain]

1.  HandlerInterceptor1...preHandle

拦截器1 preHandle不放行，postHandle和afterCompletion不会执行。  
拦截器1 preHandle不放行，拦截器2不执行。  
  
4.根据测试结果，对拦截器应用。  
  
比如：统一日志处理拦截器，需要该拦截器preHandle一定要放行，且将它放在拦截器链接中第一个位置。  
  
比如：登陆认证拦截器，放在拦截器链接中第一个位置。权限校验拦截器，放在登陆认证拦截器之后。（因为登陆通过后才校验权限）  
  
5拦截器应用（实现登陆认证）  
  
5.1需求  
  
(1)用户请求url  
(2)拦截器进行拦截校验  
 如果请求的url是公开地址（无需登陆即可访问的url），让放行  
 如果用户session 不存在跳转到登陆页面  
 如果用户session存在放行，继续操作。  
  
5.2登陆controller方法

**\[java\]**  [view plain][]   [copy][view plain]

1.  **package** cn.edu.hpu.ssm.controller;  
2.    
3.  **import** javax.servlet.http.HttpSession;  
4.    
5.  **import** org.springframework.stereotype.Controller;  
6.  **import** org.springframework.web.bind.annotation.RequestMapping;  
7.    
8.  @Controller  
9.  **public** **class** LoginController \{  
10.       
11.     //登录  
12.     @RequestMapping("/login")  
13.     **public** String login(HttpSession session,String username,String password)**throws** Exception\{  
14.         //调用serivce进行用户身份验证  
15.         //...  
16.           
17.         //在session中保存用户身份信息  
18.         session.setAttribute("username", username);  
19.         //重定向到商品列表界面  
20.         **return** "redirect:/items/queryItems.action";  
21.     \}  
22.       
23.     //退出  
24.     @RequestMapping("/logout")  
25.     **public** String logout(HttpSession session)**throws** Exception\{  
26.           
27.         //清除session  
28.         session.invalidate();  
29.           
30.         //重定向到商品列表界面  
31.         **return** "redirect:items/queryItems.action";  
32.     \}  
33. \}

登录页面:

**\[html\]**  [view plain][]   [copy][view plain]

1.  **<**%@ page language="java" import="java.util.\*" pageEncoding="utf-8"%**>**  
2.  **<**%  
3.  String path = request.getContextPath();  
4.  String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/";  
5.  %**>**  
6.    
7.    
8.  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"**>**  
9.  **<****html****>**  
10.   **<****head****>**  
11.     **<****base** href="<%=basePath%>"**>**  
12.       
13.     **<****title****>**系统登录**</****title****>**  
14.   
15.   
16.   **</****head****>**  
17.     
18.   **<****body****>**  
19.    **<****form** action="$\{pageContext.request.contextPath \}/login.action" method="post"**>**  
20.     用户账号:**<****input** type="text" name="username"**/>****<****br****/>**  
21.     用户密码:**<****input** type="password" name="password"**/>****<****br****/>**  
22.     **<****input** type="submit" value="登录"**/>**  
23.    **</****form****>**  
24.   **</****body****>**  
25. **</****html****>**

在商品列表那里加入:

**\[html\]**  [view plain][]   [copy][view plain]

1.  当前用户:$\{username \}|  
2.  **<****c:if** test="$\{username!=null \}"**>**  
3.  **<****a** href="$\{pageContext.request.contextPath \}/logout.action"**>**退出**</****a****>**  
4.  **</****c:if****>**

5.3登陆认证拦截实现  
  
5.3.1代码实现

**\[java\]**  [view plain][]   [copy][view plain]

1.  **package** cn.edu.hpu.ssm.interceptor;  
2.    
3.  **import** javax.servlet.http.HttpServletRequest;  
4.  **import** javax.servlet.http.HttpServletResponse;  
5.  **import** javax.servlet.http.HttpSession;  
6.    
7.  **import** org.springframework.web.servlet.HandlerInterceptor;  
8.  **import** org.springframework.web.servlet.ModelAndView;  
9.    
10. //登录认证的拦截器  
11. **public** **class** LoginInterceptor **implements** HandlerInterceptor\{  
12.   
13.     //执行Handler方法之前执行  
14.     //用于身份认证、身份授权  
15.     //比如身份认证，如果认证通过表示当前用户没有登陆，需要此方法拦截不再向下执行  
16.     @Override  
17.     **public** **boolean** preHandle(HttpServletRequest request, HttpServletResponse response,  
18.             Object handler) **throws** Exception \{  
19.           
20.         //获取请求的url  
21.         String url=request.getRequestURI();  
22.         //判断url是否是公开地址(实际使用时将公开地址配置到配置文件中)  
23.         **if**(url.indexOf("login.action")>=0)\{  
24.             //如果要进行登录提交，放行  
25.             **return** **true**;  
26.         \}  
27.           
28.         //判断session  
29.         HttpSession session=request.getSession();  
30.         //从session中取出用户份信息  
31.         String username=(String)session.getAttribute("username");  
32.           
33.         **if**(username!=**null**)\{  
34.             //身份存在，放行  
35.             **return** **true**;  
36.         \}  
37.           
38.         //执行这里表示用户身份需要验证，跳转到登录界面  
39.         request.getRequestDispatcher("/WEB-INF/jsp/login.jsp").forward(request, response);  
40.           
41.         //return false表示拦截，不向下执行  
42.         //return true表示放行          
43.         **return** **false**;  
44.     \}  
45.       
46.     //进入Handler方法之后，返回modelAndView之前执行  
47.     //应用场景从modelAndView出发：将公用的模型数据(比如菜单导航)在这里  
48.     //传到视图，也可以在这里统一指定视图  
49.     @Override  
50.     **public** **void** postHandle(HttpServletRequest request, HttpServletResponse response,  
51.             Object handler, ModelAndView modelAndView) **throws** Exception \{  
52.           
53.         System.out.println("HandlerInterceptor1......postHandle");  
54.           
55.     \}  
56.       
57.     //执行Handler完成执行此方法  
58.     //应用场景：统一异常处理，统一日志处理  
59.     @Override  
60.     **public** **void** afterCompletion(HttpServletRequest request, HttpServletResponse response,  
61.             Object handler, Exception ex)  
62.             **throws** Exception \{  
63.           
64.         System.out.println("HandlerInterceptor1......afterHandle");  
65.           
66.     \}  
67. \}

5.3.2拦截器配置  
springmvc.xml中配置:

**\[html\]**  [view plain][]   [copy][view plain]

1.    
2.  **<****mvc:interceptors****>**  
3.        
4.        
5.      **<****mvc:interceptor****>**  
6.          **<****mvc:mapping** path="/\*\*"**/>**  
7.          **<****bean** class="cn.edu.hpu.ssm.interceptor.LoginInterceptor"**/>**  
8.      **</****mvc:interceptor****>**  
9.  **</****mvc:interceptors****>**

测试:  
输入商品列表的网址，结果发现被拦截在登录界面(原因:拦截器没有检测到登录用户的session，所以判定用户没有登录，没有权限查看商品列表)  
![Center][]

我们输入账号(王五)密码(随便)，发现登录进去，并且看到了用户名

![Center 1][]

点击退出再次退回登录界面，再次输入商品列表的网址，结果发现依旧被拦截在登录界面，原因是session已经被清除。

**转载请注明出处：[http://blog.csdn.net/acmman/article/details/47680517][http_blog.csdn.net_acmman_article_details_47680517]**

[view plain]: http://blog.csdn.net/acmman/article/details/47680517#
[Center]: /images/20210522/c185af0913bf476bb359495daa541e8b.png
[Center 1]: /images/20210522/0f7361d1d9cd4e2a95495b4ac28b21a9.png
[http_blog.csdn.net_acmman_article_details_47680517]: http://blog.csdn.net/acmman/article/details/47680517