springMVC之放行静态资源、文件上传、拦截器

最新推荐文章于 2025-02-25 21:40:48 发布

原创最新推荐文章于 2025-02-25 21:40:48 发布 · 1.4k 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#springmvc #放行静态资源 #拦截器

spring mvc 专栏收录该内容

4 篇文章

订阅专栏

本文详细解析SpringMVC中静态资源处理及文件上传的两种方式，包括配置方法、示例代码及常见问题解决方案，适用于初学者及开发者快速上手。

文章目录

放行静态资源
文件上传
拦截器

放行静态资源

为什么静态资源无法访问

默认Tomcat是可以处理静态资源的(通过DefaultServlet处理在%tomcat_home%/conf/web.xml中)，但是我们配置了SpringMVC后，往往会将DispatcherServlet的拦截路径设置成"/"，会将Tomcat中默认的DefaultServlet覆盖掉，所以静态资源也会进入DispatcherServlet中处理，而默认DispatcherServlet中是没有处理静态资源相关的逻辑，所以访问静态资源就会报404

怎么解决

第一种方法

配置< mvc:default-servlet-handler />

将静态资源交还给容器来处理(比如说Tomcat就是让DefaultServlet来处理)

优点：配置简单
缺点：只能访问web根目录下公开的静态文件， WEB-INF、类路径下都无法访问

第二种方法

在dispatcher-servlet.xml配置文件中配置下面的一行配置即可

<!-- 放行静态资源, mapping匹配你请求的URI； location指定静态资源的位置(建议前后面都加/) -->
<mvc:resources mapping="/static/**" location="/static/" />

放行静态资源, mapping匹配你请求的URI； location指定静态资源相对位置，会将mapping中通配部分的内容拼到location指定的相对位置后面

示例

在这里插入图片描述
dispatcher-servlet.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc.xsd">
        
    <!-- 放行静态资源, mapping匹配你请求的URI；location指定静态资源的位置(建议前后面都加/) -->
    <mvc:resources mapping="/static/**" location="/static/" />
</beans>

浏览器访问地址

http://localhost:8080/springmvc/static/index.html

文件上传

SpringMVC提供了一个MultipartResolver接口用于支持文件上传。 MultipartResolver有两个实现类分别基于apache file-upload包和Serlvet3.0 API方式的文件上传。他们是：

CommonsMultipartResolver (2.5)
StandardServletMultipartResolver (3.0)

2.5方式文件上传配置如下：

通过apache common file-upload包的Servlet 2.5的方式上传文件

在pom.xml中添加common-fileupload依赖

<dependency>
	<groupId>commons-fileupload</groupId>
	<artifactId>commons-fileupload</artifactId>
	<version>1.3.3</version>
</dependency>

在bean中配置CommonsMultipartResolver，最好以multipartResolver命名

<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver" />

支持"maxUploadSize", “maxInMemorySize” and "defaultEncoding"三个参数

注意： apache file-upload相关的依赖需要自己另外添加进来

示例

index.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>servlet 2.5方式文件上传</title>
</head>
<body>
    <form enctype="multipart/form-data" action="upload2" method="post">
        <input type="file" name="myFile" />
        <input type="submit" value="提交" />
    </form>
</body>
</html>

UploadController .java

@Controller
public class UploadController {
    @ResponseBody
    @RequestMapping("/upload2")
    public String upload2(@RequestParam("myFile") MultipartFile file){
        try {
            file.transferTo(new File("D:/" + file.getOriginalFilename()));
            return "上传成功";
        } catch (IOException e) {
            e.printStackTrace();
            return "上传失败";
        }
    }
}

3.0方式文件上传配置如下：

通过Servlet 3.0的方式上传文件

在web.xml 标签中配置：启用DispatcherServlet的文件上传功能

<servlet>
	<servlet-name>dispatcher</servlet-name>
	<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
	<!-- 指定SpringMVC 配置文件位置，DispatcherServlet初始化时会初始化Spring上下文（WebApplicationContext） -->
	<!-- 默认配置文件寻找位置：/WEB-INF/{servlet-name}-servlet.xml，如果名字符合默认寻找规则，可以不指定配置文件路径 -->
	<init-param>
		<param-name>contextConfigLocation</param-name>
		<param-value>WEB-INF/dispatcher-servlet.xml</param-value>
	</init-param>
	<!-- 配置容器启动时初始化DispatcherServlet -->
	<load-on-startup>1</load-on-startup>
	<!-- 启用DispatcherServlet的文件上传功能 -->
	<multipart-config />
</servlet>
<servlet-mapping>
	<servlet-name>dispatcher</servlet-name>
	<url-pattern>/</url-pattern>
</servlet-mapping>

在bean中配置StandardServletMultipartResolver，最好以multipartResolver命名

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

在Controller中处理文件上传：

@Controller
public class FileUploadController {
    @PostMapping("/form")
    public String handleFormUpload(@RequestParam("name") String name,@RequestParam("file")MultipartFile file) {
        if (!file.isEmpty()) {
            byte[] bytes = file.getBytes();
            // 将字节存储在某处
            return "redirect:uploadSuccess";
        }
        return "redirect:uploadFailure";
    }
}

示例

index.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>servlet 2.5方式文件上传</title>
</head>
<body>
    <form enctype="multipart/form-data" action="upload3" method="post">
        <input type="file" name="myFile" />
        <input type="submit" value="提交" />
    </form>
</body>
</html>

UploadController .java

@Controller
public class UploadController {
    @ResponseBody
    @RequestMapping("/upload3")
    public String upload3(@RequestParam("myFile") MultipartFile file){
        try {
            file.transferTo(new File("D:/" + file.getOriginalFilename()));
            return "上传成功";
        } catch (IOException e) {
            e.printStackTrace();
            return "上传失败";
        }
    }
}

注意：上传文件响应中文内容会乱码
解决方法点击此处

拦截器

配置方法

在src\main\webapp\WEB-INF\dispatcher-servlet.xml配置文件中添加下面的配置

<!-- 配置拦截器 -->
<mvc:interceptors>
    <!-- 通过<bean>的形式添加interceptor，默认拦截所有请求 -->
    <bean class="com.lanou3g.springmvc.interceptor.TestInterceptor"/>
    <!-- 通过<mvc:interceptor>配置，可以进一步拦截哪些路径和不拦截哪些路径 -->
    <!--<mvc:interceptor>
        <mvc:mapping path="/*"/>
        <mvc:exclude-mapping path="upload2"/>
        <bean class="com.lanou3g.springmvc.interceptor.LoginInterceptor"/>
    </mvc:interceptor>-->
</mvc:interceptors>

拦截时机

（执行handler之前）preHandle
（执行handler之后）postHandle
（请求完成，返回到客户端之前）afterCompletion

示例

TestInterceptor.java

public class TestInterceptor implements HandlerInterceptor {

    /**
     *  在调用实际的handler执行之前被DispatcherServlet(大总管)调用
     * @param request
     * @param response
     * @param handler
     * @return
     * @throws Exception
     */
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("TestInterceptor-preHandle");
        return true;
    }

    /**
     * 在调用实际的handler执行之后被DispatcherServlet(大总管)调用
     * @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("TestInterceptor-postHandle");
    }

    /**
     * 请求完成以后被DispatcherServlet(大总管)调用
     * @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("TestInterceptor-afterCompletion");
    }
}