【SSM】使用拦截器实现对用户登录的控制

待我称王封你为后i 2023-06-29 02:56 14阅读 0赞

## 背景 ##

> 某次因为需要调试系统的原因，到车间进行系统调试。一同事在操作系统时发现，在浏览器收藏的标签里保存的是某一个功能页的网址。导致进入浏览器默认打开这个网址，虽然进入页面，但是由于没有登录，主体内容报错。这就是本次分享的原因：假使我们使用了拦截器，即使知道页面的地址，在没有登录的情况下，预期情况是页面被拦截，重新跳转到登录页面。

## 介绍 ##

> 在对拦截器实现对用户登录的控制前，我们需要了解其原理、拦截器具体是做什么的。谈这个之前，分享一点Java三大器的对比，毕竟谈到拦截器，难免会提及过滤器、监听器。下面简单介绍下：

<table> 
 <tbody> 
  <tr> 
   <td style="width:100px;"></td> 
   <td style="width:159px;"><strong>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;拦截器</strong></td> 
   <td style="width:196px;"><strong>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;过滤器</strong></td> 
   <td style="width:252px;"><strong>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 监听器</strong></td> 
  </tr> 
  <tr> 
   <td style="width:100px;"><strong>&nbsp; &nbsp; 定义或用途</strong></td> 
   <td style="width:159px;">顾名思义拦截用的，拦截用户的请求</td> 
   <td style="width:196px;">过滤字符编码、做一些业务逻辑判断、敏感词汇的过滤，等</td> 
   <td style="width:252px;">监听对应事件的发生。主要有<code>ServletContext</code>、<code>httpSession</code>、<code>ServletRequest</code>对象的创建和销毁，属性的增加、删除，HTTPSession中对象的绑定和解绑。</td> 
  </tr> 
  <tr> 
   <td style="width:100px;"><strong>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;原理</strong></td> 
   <td style="width:159px;">Java反射机制，就是在面向切面（AOP）编程中应用的，就是在你的service或者一个方法前调用一个方法，或者在方法后调用一个方法。</td> 
   <td style="width:196px;">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 函数回调</td> 
   <td style="width:252px;">事件,基于事件驱动的，用于对操作事件进行监听、处理，是观察者设计模式的应用</td> 
  </tr> 
  <tr> 
   <td style="width:100px;"><strong>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;级别</strong></td> 
   <td style="width:159px;">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 非系统级</td> 
   <td style="width:196px;">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 系统级</td> 
   <td style="width:252px;">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;系统级</td> 
  </tr> 
  <tr> 
   <td style="width:100px;"><strong>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;依赖</strong></td> 
   <td style="width:159px;">依赖于web框架，在SpringMVC中就是依赖于SpringMVC框架</td> 
   <td style="width:196px;">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;依赖于servlet容器</td> 
   <td style="width:252px;"></td> 
  </tr> 
 </tbody> 
</table>

> 上表中我们已经提到拦截器的原理，及具体是做什么。 那么SpringMVC中的拦截器（Interceptor）怎么说呢，它类似于servlet中的过滤器（Filter）,它主要用于拦截用户请求并作相应的处理。例如通过拦截器可以进行权限验证、记录请求信息的日志、判断用户是否登录等。要使用SpringMVC中的拦截器，就需要对拦截器类进行定义和配置。通常拦截器类可以通过两种方式 来定义。
> 
> 1、通过实现HandlerInterceptor接口，或继承HandlerInterceptor接口的实现类来定义.
> 
> 2、通过实现WebRequestInterceptor接口，或继承WebRequestInterceptor接口的实现类来定义。

## HandleInterceptor接口 ##

package org.springframework.web.servlet;
    
    import javax.servlet.http.HttpServletRequest;
    import javax.servlet.http.HttpServletResponse;
    
    public interface HandlerInterceptor {
        boolean preHandle(HttpServletRequest var1, HttpServletResponse var2, Object var3) throws Exception;
    
        void postHandle(HttpServletRequest var1, HttpServletResponse var2, Object var3, ModelAndView var4) throws Exception;
    
        void afterCompletion(HttpServletRequest var1, HttpServletResponse var2, Object var3, Exception var4) throws Exception;
    }

HandlerInterceptor 接口中定义了三个方法，我们就是通过这三个方法来对用户的请求进行拦截处理的。

> (1) **preHandle(HttpServletRequest var1, HttpServletResponse var2, Object var3) ** 方法，顾名思义，该方法将在请求处理之前进行调用。SpringMVC 中的Interceptor 是链式的调用的，在一个应用中或者说是在一个请求中可以同时存在多个Interceptor 。每个Interceptor 的调用会依据它的声明顺序依次执行，而且最先执行的都是Interceptor 中的preHandle 方法，所以可以在这个方法中进行一些前置初始化操作或者是对当前请求的一个预处理，也可以在这个方法中进行一些判断来决定请求是否要继续进行下去。该方法的返回值是布尔值Boolean类型的，当它返回为false 时，表示请求结束，后续的Interceptor 和Controller 都不会再执行；当返回值为true 时就会继续调用下一个Interceptor 的preHandle 方法，如果已经是最后一个Interceptor 的时候就会是调用当前请求的Controller 方法。
> 
> (2) **postHandle(HttpServletRequest var1, HttpServletResponse var2, Object var3, ModelAndView var4)**方法，postHandle 方法，顾名思义就是在当前请求进行处理之后，也就是Controller 方法调用之后执行，但是它会在DispatcherServlet 进行视图返回渲染之前被调用，所以我们可以在这个方法中对Controller 处理之后的ModelAndView 对象进行操作。postHandle 方法被调用的方向跟preHandle 是相反的，也就是说先声明的Interceptor 的postHandle 方法反而会后执行，这和Struts2 里面的Interceptor 的执行过程有点类似。Struts2 里面的Interceptor 的执行过程也是链式的，只是在Struts2 里面需要手动调用ActionInvocation 的invoke 方法来触发对下一个Interceptor 或者是Action 的调用，然后每一个Interceptor 中在invoke 方法调用之前的内容都是按照声明顺序执行的，而invoke 方法之后的内容就是反向的。
> 
> (3) **afterCompletion(HttpServletRequest var1, HttpServletResponse var2, Object var3, Exception var4)**方法，该方法也是需要当前对应的Interceptor 的preHandle 方法的返回值为true 时才会执行。顾名思义，该方法将在整个请求结束之后，也就是在DispatcherServlet 渲染了对应的视图之后执行。这个方法的主要作用是用于进行资源清理工作的。

## 执行流程 ##

> 1、拦截请求的url；
> 
> 2、从cookie中获取token；
> 
> 3、如果没有token，则直接拦截，打回登录页面；
> 
> 4、获取到token，调用系统的服务查询用户信息，返回session（用户信息）；
> 
> 5、对获取到的session进行处理。如果session已经过期，直接打回系统登录页面；如果session有效，则直接放行，达到用户的请求页面

## 实现 ##

### 实现 HandlerInterceptor接口 ###

package com.inchlifc.intercepter;
    
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.web.servlet.HandlerInterceptor;
    import org.springframework.web.servlet.ModelAndView;
    
    import javax.servlet.http.HttpServletRequest;
    import javax.servlet.http.HttpServletResponse;
    import javax.servlet.http.HttpSession;
    
    public class LoginInterceptor implements HandlerInterceptor {
    
        @Autowired
        HttpSession session ;
    
        @Override
        public void afterCompletion(HttpServletRequest arg0, HttpServletResponse arg1, Object arg2, Exception arg3)
                throws Exception {
            // 执行完毕，返回前拦截
        }
    
        @Override
        public void postHandle(HttpServletRequest arg0, HttpServletResponse arg1, Object arg2, ModelAndView arg3)
                throws Exception {
            // 在处理过程中，执行拦截
        }
    
        @Override
        public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object arg2) throws Exception {
            // 在拦截点执行前拦截，如果返回true则不执行拦截点后的操作（拦截成功）
            // 返回false则不执行拦截
            String currentUserName = (String) session.getAttribute("userName");
            //String uri = request.getRequestURI(); // 获取登录的uri，这个是不进行拦截的
            //if(session.getAttribute("LOGIN_USER")!=null || uri.indexOf("system/login")!=-1) {// 说明登录成功 或者 执行登录功能
            if(currentUserName!=null) {
                // 登录成功不拦截
                return true;
            }else {
                // 拦截后进入登录页面
                //执行这里表示用户身份需要验证，跳转到登录界面
                request.getRequestDispatcher("/WEB-INF/jsp/login.jsp").forward(request, response);
                return false;
            }
        }
    }

### spring-mvc.xml配置 ###

<mvc:interceptors>
        <mvc:interceptor>
            <mvc:mapping path="/**"/>
            <mvc:exclude-mapping path="/admin/login"></mvc:exclude-mapping>
            <bean class="com.inchlifc.intercepter.LoginInterceptor"></bean>
        </mvc:interceptor>
    </mvc:interceptors>

### 页面 ###