springmvc的(五)（过滤器+全局异常处理+静态资源访问+文件上传下载+拦截器）

谁是黄黄

已于 2022-07-06 21:47:22 修改

阅读量593

点赞数

分类专栏： springMVC 文章标签： servlet java 前端

于 2022-07-04 21:10:06 首次发布

本文链接：https://blog.csdn.net/weixin_43189971/article/details/125608741

版权

springMVC 专栏收录该内容

7 篇文章 0 订阅

订阅专栏

一.静态资源访问

1.1概念：

在 SpringMVC 中，静态资源，默认都是被拦截的，例如 html、js、css、jpg、png、txt、pdf 等等，都是无法直接访问的。因为所有请求都被拦截了

1.2 处理方法一（常用）

所以，针对静态资源，我们要做额外处理，处理方式很简单，直接在 SpringMVC 的配置文件中，添加如下内容：

<mvc:resources mapping="/static/html/**" location="/static/html/"/>

mapping 表示映射规则，也是拦截规则
请求地址是 /static/html 这样的格式的话
对应的资源就去 /static/html/ 这个目录下查找

在映射路径的定义中，最后是两个 *，这是一种 Ant 风格的路径匹配符号，一共有三个通配符：

通配符	含义
**	匹配多层路径
*	匹配一层路径
?	匹配任意单个字符

1.3 处理方法二

1.4 处理方法三（不推荐）

二. 拦截器

2.1概念

SpringMVC 中的拦截器，相当于 Jsp/Servlet 中的过滤器，只不过拦截器的功能更为强大。

2.2 拦截器的配置

第一步，实现拦截器类

MyInterceptor1

@Component
public class MyInterceptor1 implements HandlerInterceptor {
    /**
     * 这个是请求预处理的方法，只有当这个方法返回值为 true 的时候，后面的方法才会执行
     * @param request
     * @param response
     * @param handler
     * @return
     * @throws Exception
     */
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("MyInterceptor1:preHandle");
        return true;
    }

    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("MyInterceptor1:postHandle");

    }

    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("MyInterceptor1:afterCompletion");

    }
}

第二步

拦截器定义好之后，需要在SpringMVC的配置文件中进行配置

<mvc:interceptors>
    <mvc:interceptor>
        <mvc:mapping path="/**"/>
        <ref bean="myInterceptor1"/>
    </mvc:interceptor>
    <mvc:interceptor>
        <mvc:mapping path="/**"/>
        <ref bean="myInterceptor2"/>
    </mvc:interceptor>
</mvc:interceptors>

springmvc的配置

 <mvc:interceptors>
        <mvc:interceptor>
            <!--拦截器的拦截路径-->
            <mvc:mapping path="/**"/>
            <!--拦截器的Bean-->
            <bean class="com.huang.comments.interceptor.MyInterceptor1"/>
        </mvc:interceptor>
    </mvc:interceptors>

三.文件上传

3.1 概念

SpringMVC中对文件上传做了封装，我们可以更加方便的实现文件上传，从3.1开始提供了两个处理器用于文件上传

CommonsMultipartResolver
理器兼容性较好，可以兼容 Servlet3.0 之前的版本，但是它依赖了 commons-fileupload 这个第三方工具，所以如果使用这个，一定要添加 commons-fileupload 依赖

StandardServletMultipartResolver
兼容性较差，它适用于Servlet3.0 之后的版本，它不依赖第三方工具，使用它，可以直接做文件上传

3.2 CommonsMultipartResolver

黄黄表示这是垃圾方法不要用

这个文件上传方法中，一共做了四件事：

解决文件保存路径，这里是保存在项目运行目录下的 img 目录下，然后利用日期继续宁分类
处理文件名问题，使用 UUID 做新的文件名，用来代替旧的文件名，可以有效防止文件名冲突
保存文件
生成文件访问路径

3.3 StandardServletMultipartResolver

这种文件上传方式，不需要依赖第三方 jar（主要是不需要添加 commons-fileupload 这个依赖），但是也不支持 Servlet3.0 之前的版本。

使用 StandardServletMultipartResolver ，那我们首先在 SpringMVC 的配置文件中，配置这个 Bean

第一步

<bean class="org.springframework.web.multipart.support.StandardServletMultipartResolver" id="multipartResolver">
</bean>

注意，这里 Bean 的名字依然叫 multipartResolver

第二步

配置完成后，注意，这个 Bean 无法直接配置上传文件大小等限制。需要在 web.xml 中进行配置（这里，即使不需要限制文件上传大小，也需要在 web.xml 中配置 multipart-config）：

<servlet>
    <servlet-name>springmvc</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:spring-servlet.xml</param-value>
    </init-param>
    <multipart-config>
        <!--文件保存的临时目录，这个目录系统不会主动创建，E:\\tmp这里是你本地存放文件的位置，你一定要有文件，而且要保证路径正确负责会页面报错空指针异常-->
        <location>E:\\temp</location>
        <!--上传的单个文件大小-->
        <max-file-size>1048576</max-file-size>
        <!--上传的总文件大小-->
        <max-request-size>1048576</max-request-size>
        <!--这个就是内存中保存的文件最大大小-->
        <file-size-threshold>4096</file-size-threshold>
    </multipart-config>
</servlet>
<servlet-mapping>
    <servlet-name>springmvc</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

第四步：


    SimpleDateFormat sdf = new SimpleDateFormat("/yyyy/MM/dd/");


    @PostMapping("/upload")
    @ResponseBody
    public String uploadFile(MultipartFile file, String username, HttpServletRequest req) {
        System.out.println("username = " + username);
        //1. 先确定文件保存路径
        //获取项目运行路径
        String realPath = req.getServletContext().getRealPath("/img");
        String format = sdf.format(new Date());
        //文件保存的文件夹
        String s = realPath + format;
        File folder = new File(s);
        if (!folder.exists()) {
            //文件夹不存在就创建出来
            folder.mkdirs();
        }
        //2. 确定保存的文件名
        //获取原始的文件名
        String originalFilename = file.getOriginalFilename();
        //获取上传文件的后缀
        String suffix = originalFilename.substring(originalFilename.lastIndexOf("."));
        String newName = UUID.randomUUID().toString() + suffix;
        // 3. 保存文件
        try {
            file.transferTo(new File(folder, newName));
            //4. 返回文件上传路径
            return req.getScheme()//获取请求协议  http
                    + "://"
                    + req.getServerName()//获取项目域名 localhost
                    + ":"
                    + req.getServerPort()//获取项目端口 8080
                    + req.getContextPath()//获取项目名称 mvc05
                    + "/img"
                    + format
                    + newName;
        } catch (IOException e) {
            e.printStackTrace();
        }
        return "error";
    }

第五步：
postman测试一下发现是不是能找到，能找到就是上传成功了，但是！！！
在这里插入图片描述
如果返还的路径再进行get查询，差找不到图片报错404的话就会发现错误了，那是为什么错误了呢？

你他喵没在springMVC相关配置中配置静态资源访问，当然找不到图片了

  <!--静态资源访问-->
    <mvc:resources mapping="/**" location="/"/>

3.4 过滤器放置乱码

看第五小节

3.5 文件下载：

@GetMapping("/download/{filename}")
    public ResponseEntity<byte[]> download3(@PathVariable String filename) throws Exception {
        //构建一个输出流，这个输出流将数据写出到 byte 数组中
        ByteArrayOutputStream baos = new ByteArrayOutputStream();
        //这个路径是服务器路径，就是你存放图片的路径
        try (FileInputStream fis = new FileInputStream("C:\\Users\\18296\\Desktop\\xz\\" + filename)) {
            byte[] buf = new byte[1024];
            int len = 0;
            while ((len = fis.read(buf)) != -1) {
                baos.write(buf, 0, len);
            }
        }
        //1. 响应给前端的 byte 数组
        byte[] body = baos.toByteArray();
        //2. 响应头
        //3. http 响应状态码
        //加上这样一个响应头，就从文件访问变为文件下载了
        HttpHeaders header = new HttpHeaders();
        header.setContentDispositionFormData("filename", new String(filename.getBytes("UTF-8"),"ISO-8859-1"));
        return new ResponseEntity<byte[]>(body, header, HttpStatus.CREATED);
    }

注意：
1.不加响应头就是文件下载了
2.我们这里是默认一个文件夹为服务器存放文件的地址，再打开浏览器模仿用户登录去下载文件

演示如何下载文件

在这里插入图片描述

这样就是在下载文件了哈

3.6 文件下载推演过程

@GetMapping("/download2/{filename}")
    public void download2(@PathVariable String filename, HttpServletResponse resp) throws IOException {
        //获取文件的输入流
        FileInputStream fis = new FileInputStream("C:\\Users\\baize\\Pictures\\weixin\\" + filename);
        byte[] buf = new byte[1024];
        int len = 0;
        while ((len = fis.read(buf)) != -1) {
            resp.getOutputStream().write(buf, 0, len);
        }
        fis.close();
    }

    // try-with-resources
    @GetMapping("/download/{filename}")
    public void download(@PathVariable String filename, HttpServletResponse resp) throws IOException {
        //加上这样一个响应头，就从文件访问变为文件下载了
        resp.setHeader("content-disposition", "attachment;filename=" + new String(filename.getBytes("UTF-8"), "ISO-8859-1"));
        //获取文件的输入流
        try (FileInputStream fis = new FileInputStream("C:\\Users\\baize\\Pictures\\weixin\\" + filename)) {
            byte[] buf = new byte[1024];
            int len = 0;
            while ((len = fis.read(buf)) != -1) {
                resp.getOutputStream().write(buf, 0, len);
            }
        }
    }

    @GetMapping("/download3/{filename}")
    public ResponseEntity<byte[]> download3(@PathVariable String filename) throws Exception {
        //构建一个输出流，这个输出流将数据写出到 byte 数组中
        ByteArrayOutputStream baos = new ByteArrayOutputStream();
        try (FileInputStream fis = new FileInputStream("C:\\Users\\baize\\Pictures\\weixin\\" + filename)) {
            byte[] buf = new byte[1024];
            int len = 0;
            while ((len = fis.read(buf)) != -1) {
                baos.write(buf, 0, len);
            }
        }
        //1. 响应给前端的 byte 数组
        byte[] body = baos.toByteArray();
        //2. 响应头
        //3. http 响应状态码
        HttpHeaders header = new HttpHeaders();
        header.setContentDispositionFormData("filename", new String(filename.getBytes("UTF-8"),"ISO-8859-1"));
        return new ResponseEntity<byte[]>(body, header, HttpStatus.CREATED);
    }

四.全局异常处理的三个方案

4.1 全局异常的概念：

可能会抛出多个异常，我们不可以直接将异常的堆栈信息展示给用户，有两个原因：

用户体验不好
非常不安全

所以，针对异常，我们可以去自定义异常处理，SpringMVC 中，针对全局异常也提供了相应的解决方案，主要是通过 @ControllerAdvice 和 @ExceptionHandler 两个注解来处理的。

此处以文件上传大小超出限制为例子，自定义异常，只需要提供一个异常处理类即可：

@ControllerAdvice//表示这是一个增强版的 Controller，主要用来做全局数据处理
public class MyException {
    @ExceptionHandler(Exception.class)
    public ModelAndView fileuploadException(Exception e) {
        ModelAndView error = new ModelAndView("error");
        error.addObject("error", e.getMessage());
        return error;
    }
}

注意：

1.@ControllerAdvice 表示这是一个增强版的 Controller，主要用来做全局数据处理
2.@ExceptionHandler 表示这是一个异常处理方法，这个注解的参数，表示需要拦截的异常，参数为 Exception 表示拦截所有异常，这里也可以具体到某一个异常，如果具体到某一个异常，那么发生了其他异常则不会被拦截到。
3.异常方法的定义，和 Controller 中方法的定义一样，可以返回 ModelAndview，也可以返回 String 或者 void

例如如下代码，指挥拦截文件上传异常，其他异常和它没关系，不会进入到自定义异常处理的方法中来

@ControllerAdvice//表示这是一个增强版的 Controller，主要用来做全局数据处理
public class MyException {
    @ExceptionHandler(MaxUploadSizeExceededException.class)
    public ModelAndView fileuploadException(MaxUploadSizeExceededException e) {
        ModelAndView error = new ModelAndView("error");
        error.addObject("error", e.getMessage());
        return error;
    }
}

4.2 常见的全局异常小例子

第一步，定义全局异常处理类

public class MyGlobalException implements HandlerExceptionResolver {
    @Override
    public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
        ModelAndView mv = new ModelAndView("error");
        mv.addObject("msg",ex.getMessage());
        return mv;
    }
}



第三步，加入视图解析器
> springmvc的配置文件中加入视图解析器
```java
 <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/jsp/"/>
        <property name="suffix" value=".jsp"/>
    </bean>

五. 过滤器，过滤掉编码格式的问题

配置在web中

	
    <filter>
        <filter-name>encodingFilter</filter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
        <init-param>
            <param-name>encoding</param-name>
            <param-value>UTF-8</param-value>
        </init-param>
        <init-param>
            <param-name>forceRequestEncoding</param-name>
            <param-value>true</param-value>
        </init-param>
        <init-param>
            <param-name>forceResponseEncoding</param-name>
            <param-value>true</param-value>
        </init-param>
    </filter>
    
    <filter-mapping>
        <filter-name>encodingFilter</filter-name>
         <url-pattern>/*</url-pattern>
    </filter-mapping>