上一篇：SpringMVC框架的返回值及响应数据
下一篇：SpringMVC框架的异常处理及拦截器
文章目录
1、环境搭建
1.1、文件上传的必要前提
① form 表单的 enctype 取值必须为：multipart/form-data（默认值是application/x-www-form-urlencoded）。enctype 指的是表单请求正文的类型。
② method 属性取值必须是 post。
③提供一个文件选择域<input type=”file” />。
1.2、借助第三方组件实现文件上传
使用 Commons-fileupload 组件实现文件上传，需要导入该组件相应的支撑 jar 包：Commons-fileupload 和 commons-io。commons-io 不属于文件上传组件的开发 jar 文件，但Commons-fileupload 组件从 1.1 版本开始，它工作时需要 commons-io 包的支持。坐标如下：
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>5.0.2.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>5.0.2.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.0.2.RELEASE</version>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>servlet-api</artifactId>
<version>2.5</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>javax.servlet.jsp</groupId>
<artifactId>jsp-api</artifactId>
<version>2.0</version>
<scope>provided</scope>
</dependency>
<!-- 文件上传 -->
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.3.1</version>
</dependency>
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>2.4</version>
</dependency>
</dependencies>
1.3、配置web.xml
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd" >
<web-app>
<display-name>Archetype Created Web Application</display-name>
<!-- 配置过滤器，解决中文乱码的问题 -->
<filter>
<filter-name>characterEncodingFilter</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>
</filter>
<filter-mapping>
<filter-name>characterEncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<!-- SpringMVC的核心控制器 -->
<servlet>
<servlet-name>DispatcherServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!-- 配置Servlet的初始化参数，读取springmvc的配置文件，创建spring容器 -->
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springmvc.xml</param-value>
</init-param>
<!-- 配置servlet启动时加载对象 -->
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>DispatcherServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
1.4、配置springmvc.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:context="http://www.springframework.org/schema/context"
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
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd">
<!-- 配置spring创建容器时要扫描的包 -->
<context:component-scan base-package="com.atlantis"/>
<!-- 配置视图解析器 -->
<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/pages/"/>
<property name="suffix" value=".jsp"/>
</bean>
<!-- 设置静态资源不被拦截 -->
<mvc:resources location="/css/" mapping="/css/**"/> <!-- 样式 -->
<mvc:resources location="/images/" mapping="/images/**"/> <!-- 图片 -->
<mvc:resources location="/js/" mapping="/js/**"/> <!-- javascript -->
<!-- 配置spring开启注解mvc的支持-->
<mvc:annotation-driven />
</beans>
1.5、编写文件上传的JSP页面
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>文件上传</title>
</head>
<body>
<h3>文件上传</h3>
<form action="file/fileupload" method="post" enctype="multipart/form-data">
选择文件：<input type="file" name="upload"/><br/>
<input type="submit" value="上传文件"/>
</form>
</body>
</html>
2、传统方式文件上传
/**
* 传统方式文件上传
*/
@RequestMapping(value = "/fileupload")
public String fileupload(HttpServletRequest request) throws Exception {
// 先获取到要上传的文件目录
String path = request.getSession().getServletContext().getRealPath("/uploads/");
// 创建File对象，一会向该文件夹下上传文件
File file = new File(path);
// 判断路径是否存在，如果不存在则创建
if (!file.exists()) {
file.mkdirs();
}
// 创建磁盘文件项工厂
DiskFileItemFactory factory = new DiskFileItemFactory();
ServletFileUpload fileUpload = new ServletFileUpload(factory);
// 解析request对象
List<FileItem> list = fileUpload.parseRequest(request);
// 遍历
for (FileItem fileItem : list) {
// 判断文件项是普通字段，还是上传的文件
if (!fileItem.isFormField()) {
// 上传文件项
// 获取到上传文件的名称
String filename = fileItem.getName();
// 上传文件
fileItem.write(new File(file, filename));
// 删除临时文件
fileItem.delete();
}
}
return "success";
}
解决上传文件名可能重复的问题：
3、SpringMVC文件上传
SpringMVC 框架提供了 MultipartFile 对象，该对象表示上传的文件，要求变量名称必须和表单 file 标签的 name 属性名称相同。
SpringMVC 框架文件上传的原理分析：
演示如下：
<!-- 配置文件解析器对象，要求id名称必须是multipartResolver -->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<!-- 上传文件大小限制，单位为字节 -->
<property name="maxUploadSize" value="10485760"/>
</bean>
/**
* SpringMVC方式文件上传
*/
@RequestMapping(value = "/fileupload")
public String fileupload(HttpServletRequest request, MultipartFile upload) throws Exception {
// 先获取到要上传的文件目录
String path = request.getSession().getServletContext().getRealPath("/uploads");
// 解决同一文件夹中文件过多问题
String datePath = new SimpleDateFormat("yyyy-MM-dd").format(new Date());
// 创建File对象，一会向该路径下上传文件
File file = new File(path + "/" + datePath);
// 判断路径是否存在，如果不存在则创建
if (!file.exists()) {
file.mkdirs();
}
// 获取到上传文件的名称
String filename = upload.getOriginalFilename();
// 把文件加上随机数，防止文件重复
String uuid = UUID.randomUUID().toString().replaceAll("-", "").toUpperCase();
filename = uuid + "_" + filename;
// 使用MulitpartFile接口中方法，把上传的文件写到指定位置
upload.transferTo(new File(file, filename));
return "success";
}
4、SpringMVC跨服务器方式文件上传
4.1、分服务器的目的
在实际开发中，我们会有很多处理不同功能的服务器。例如：
应用服务器：负责部署应用。
数据库服务器：运行数据库。
缓存和消息服务器：负责处理大并发访问的缓存和消息。
文件服务器：负责存储用户上传文件的服务器。
注意：此处说的不是服务器集群。
分服务器处理的目的是让服务器各司其职，从而提高项目的运行效率。
4.2、环境搭建测试文件上传
（1）搭建图片服务器
创建图片服务器工程，这里以Maven为例：
启动应用服务器和图片服务器：
（2）实现SpringMVC跨服务器方式文件上传
引入开发需要的 jar 包坐标：
<!-- 服务器之间相互通信 -->
<dependency>
<groupId>com.sun.jersey</groupId>
<artifactId>jersey-core</artifactId>
<version>1.18.1</version>
</dependency>
<dependency>
<groupId>com.sun.jersey</groupId>
<artifactId>jersey-client</artifactId>
<version>1.18.1</version>
</dependency>
</dependencies>
编写应用服务器中的文件上传JSP页面：
<form action="file/fileupload" method="post" enctype="multipart/form-data">
选择文件：<input type="file" name="upload"/><br/>
<input type="submit" value="上传文件"/>
</form>
编写应用服务器中的控制器方法：
/**
* SpringMVC跨服务器方式文件上传
*/
@RequestMapping(value = "/fileupload")
public String fileupload(HttpServletRequest request, MultipartFile upload) throws Exception {
// 定义图片服务器的请求路径
String path = "http://localhost:8080/uploads/";
// 获取到上传文件的名称
String filename = upload.getOriginalFilename();
// 把文件加上随机数，防止文件重复
String uuid = UUID.randomUUID().toString().replaceAll("-", "").toUpperCase();
filename = uuid + "_" + filename;
// 向图片服务器上传文件
// 创建sun公司提供的jersey包中的Client对象
Client client = Client.create();
// 连接图片服务器，即指定上传文件的地址，该地址是 web 路径
WebResource webResource = client.resource(path + filename);
// 上传文件
webResource.put(upload.getBytes());
return "success";
}
出现以上错误的原因是因为将图片上传单独部署了一个服务器，导致图片不能写入。需要在 Tomcat 目录下的 conf 文件夹下的 web.xml 中加入：
<init-param>
<param-name>readonly</param-name>
<param-value>false</param-value>
</init-param>
