Spring MVC学习笔记(二)-拦截器,异常处理器,文件上传

拦截器的使用

监听器,过滤器与拦截器的对比

监听器:实现javax.servlet.ServletContextListener接口的服务端组件,随web应用启动而启动,只会初始化一次,随着web应用的停止而销毁

做一些初始化的动作.容器启动时的初始化工作
监听web中的特定事件,比如HttpSession,ServletRequest的创建和销毁,变量的创建和销毁,在某些动作前后增加处理,例如统计在线人数,利用HttpSessionListener等

过滤器(Filter):

对Request请求起到过滤作用,在Servlet之前生效
例如使用编码过滤器,强制将所有参数以UTF-8编码

拦截器(Interceptor):

SpringMVC自有的拦截器,只会拦截访问的控制器方法,不会拦截静态资源
servlet,filter,listener是配置在web.xml中的,interceptor是配置在MVC配置文件中的
拦截器会在业务逻辑执行前拦截一次,在业务逻辑执行完毕未跳转页面之前拦截一次,在跳转页面之后拦截一次

![image-20200517225651704](D:\文档资料\拉勾训练营\笔记\第一阶段\spring MVC\images\image-20200517225651704.png)

拦截器的处理流程

![image-20200517225750496](D:\文档资料\拉勾训练营\笔记\第一阶段\spring MVC\images\image-20200517225750496.png)

程序先执⾏preHandle()⽅法，如果该⽅法的返回值为true，则程序会继续向下执⾏处理器中的⽅法，否则将不再向下执⾏。
在业务处理器（即控制器Controller类）处理完请求后，会执⾏postHandle()⽅法，然后会通过DispatcherServlet向客户端返回响应。
在DispatcherServlet处理完请求后，才会执⾏afterCompletion()⽅法。

多个拦截器的执行顺序

多个拦截器（假设有两个拦截器Interceptor1和Interceptor2，并且在配置⽂件中， Interceptor1拦截器配置在前），在程序中的执⾏流程如下图所示：

![image-20200517225844750](D:\文档资料\拉勾训练营\笔记\第一阶段\spring MVC\images\image-20200517225844750.png)

从图可以看出，当有多个拦截器同时⼯作时，它们的preHandle()⽅法会按照配置⽂件中拦截器的配置
顺序执⾏，⽽它们的postHandle()⽅法和afterCompletion()⽅法则会按照配置顺序的反序执⾏

声明拦截器代码

首先需要实现HandlerInterceptor接口,并在springMVC的配置文件中配置具体的拦截器配置

实现接口类代码:

public class MyInterceptor01 implements HandlerInterceptor {


    /**
     * 会在handler方法业务逻辑执行之前执行
     * 往往在这里完成权限校验工作
     * @param request
     * @param response
     * @param handler
     * @return  返回值boolean代表是否放行，true代表放行，false代表中止
     * @throws Exception
     */
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("MyIntercepter01 preHandle......");
        return true;
    }


    /**
     * 会在handler方法业务逻辑执行之后尚未跳转页面时执行
     * @param request
     * @param response
     * @param handler
     * @param modelAndView  封装了视图和数据，此时尚未跳转页面，你可以在这里针对返回的数据和视图信息进行修改
     * @throws Exception
     */
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("MyIntercepter01 postHandle......");
    }

    /**
     * 页面已经跳转渲染完毕之后执行
     * @param request
     * @param response
     * @param handler
     * @param ex  可以在这里捕获异常
     * @throws Exception
     */
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("MyIntercepter01 afterCompletion......");
    }
}

配置文件:

<mvc:interceptors>
        <!--拦截所有handler-->
        <!--<bean class="com.lagou.edu.interceptor.MyIntercepter01"/>-->     
        <mvc:interceptor>
            <!--配置当前拦截器的url拦截规则，**代表当前目录下及其子目录下的所有url-->
            <mvc:mapping path="/**"/>
            <!--exclude-mapping可以在mapping的基础上排除一些url拦截-->
            <!--<mvc:exclude-mapping path="/demo/**"/>-->
            <bean class="com.lagou.edu.interceptor.MyIntercepter01"/>
        </mvc:interceptor>
        <mvc:interceptor>
            <mvc:mapping path="/**"/>
            <bean class="com.lagou.edu.interceptor.MyIntercepter02"/>
        </mvc:interceptor>
        <mvc:interceptor>
            <mvc:mapping path="/**"/>
            <bean class="com.lagou.edu.interceptor.MyInterceptor03"/>
        </mvc:interceptor>
    </mvc:interceptors>

如何在控制器中统一的处理异常-异常处理器

统一的处理方式

使用ControllerAdvice注解,对Controller进行统一的增强,@ExceptionHandler(ArithmeticException.class) 针对不同的异常进行不同的处理方式

// 可以让我们优雅的捕获所有Controller对象handler方法抛出的异常
@ControllerAdvice
public class GlobalExceptionResolver {


    @ExceptionHandler(ArithmeticException.class)
    public ModelAndView handleException(ArithmeticException exception, HttpServletResponse response) {
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.addObject("msg",exception.getMessage());
        modelAndView.setViewName("error");
        return modelAndView;
    }
}

针对某个Controller的处理方式

在Controller中写一个新的方法,并增加@ExceptionHandler对异常进行捕获,这里异常处理会更优先于全局的异常处理器

// SpringMVC的异常处理机制（异常处理器）
// 注意：写在这里只会对当前controller类生效
@ExceptionHandler(ArithmeticException.class)
public void handleException(ArithmeticException exception,HttpServletResponse response) {
    // 异常处理逻辑
    try {
        response.getWriter().write(exception.getMessage());
    } catch (IOException e) {
        e.printStackTrace();
    }
}

上传文件

配置文件解析器:

<!--配置⽂件上传解析器，id是固定的multipartResolver-->
<bean id="multipartResolver"
class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<!--设置上传⼤⼩，单位字节-->
<property name="maxUploadSize" value="1000000000"/>
</bean>

前端:

<%--
1 method="post"
2 enctype="multipart/form-data"
3 type="file"
--%>
<form method="post" enctype="multipart/form-data" action="/demo/upload">
<input type="file" name="uploadFile"/>
<input type="submit" value="上传"/>
</form>

后端接收:

/**
     * 文件上传
     * @return
     */
    @RequestMapping(value = "/upload")
    public ModelAndView upload(MultipartFile uploadFile,HttpSession session) throws IOException {

        // 处理上传文件
        // 重命名，原名123.jpg ，获取后缀
        String originalFilename = uploadFile.getOriginalFilename();// 原始名称
        // 扩展名  jpg
        String ext = originalFilename.substring(originalFilename.lastIndexOf(".") + 1, originalFilename.length());
        String newName = UUID.randomUUID().toString() + "." + ext;

        // 存储,要存储到指定的文件夹，/uploads/yyyy-MM-dd，考虑文件过多的情况按照日期，生成一个子文件夹
        String realPath = session.getServletContext().getRealPath("/uploads");
        String datePath = new SimpleDateFormat("yyyy-MM-dd").format(new Date());
        File folder = new File(realPath + "/" + datePath);

        if(!folder.exists()) {
            folder.mkdirs();
        }
        // 存储文件到目录
        uploadFile.transferTo(new File(folder,newName));
        // TODO 文件磁盘路径要更新到数据库字段
        Date date = new Date();
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.addObject("date",date);
        modelAndView.setViewName("success");
        return modelAndView;
    }