首先,文件上传需要两个jar包,所以我们现在pox.xml中添加两个依赖:
<!--文件上传的jar包--> <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>
使用 Commons-fileupload 组件实现文件上传,需要导入该组件相应的支撑 jar 包:Commons-fileupload 和commons-io。commons-io 不属于文件上传组件的开发 jar 文件,但Commons-fileupload 组件从 1.1 版本开始,它工作时需要 commons-io 包的支持。
之后,我们依次编写三种方式对应的三个提交表单:
<h3>传统文件上传</h3><br/> <%--使用传统方式上传文件时,要将springmvc.xml中的文件解析器注释掉,不然上传会出现问题--%> <form action="user/fileupload1" method="post" enctype="multipart/form-data"> 选择文件:<input type="file" name="upload" /><br/> <input type="submit" value="上传" /> </form> <h3>springmvc方式文件上传</h3><br/> <%--使用springmvc方式上传文件时,要在springmvc.xml中添加文件解析器,里面可以设定上传内容大小--%> <form method="post" action="user/fileupload2" enctype="multipart/form-data"> 选择文件:<input type="file" name="upload"/><br/> <input type="submit" value="上传"/> </form> <h3>springmvc跨服务器方式文件上传</h3><br/> <%--使用springmvc方式上传文件时,要在springmvc.xml中添加文件解析器,里面可以设定上传内容大小--%> <form method="post" action="user/fileupload3" enctype="multipart/form-data"> 选择文件:<input type="file" name="upload"/><br/> <input type="submit" value="上传"/>
文件上传的必要前提:
form 表单的 enctype 取值必须是:multipart/form-data (默认值是:application/x-www-form-urlencoded)
enctype:是表单请求正文的类型
method 属性取值必须是 Post
还必须提供一个文件选择域<input type=”file” />
文件上传的原理分析:
当 form 表单的 enctype 取值不是默认值后,request.getParameter()将失效。
enctype=”application/x-www-form-urlencoded”时,form 表单的正文内容是: key=value&key=value&key=value
当 form 表单的 enctype 取值为 Mutilpart/form-data 时,请求正文内容就变成: 每一部分都是 MIME 类型描述的正文,如下:
-----------------------------7de1a433602ac 分界符
Content-Disposition: form-data; name="userName" 协议头
aaa 协议的正文
-----------------------------7de1a433602ac
Content-Disposition: form-data; name="file";
filename="C:UserszhyDesktopfileupload_demofile.txt"
Content-Type: text/plain 协议的类型(MIME 类型)
bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb
-----------------------------7de1a433602ac--
方式一:传统方式上传文件
@Controller @RequestMapping("/user") public class UserController { /** * 传统文件上传 */ @RequestMapping("/fileupload1") public String fileUpload1(HttpServletRequest request) throws Exception{ System.out.println("传统文件上传。。。"); //使用fileupload组件完成文件上传 //获取上传位置,下面获得的是upload在服务器端项目中的真实路径 String path = request.getSession().getServletContext().getRealPath("/uploads/"); //判断该路径是否存在 File file = new File(path); if (!file.exists()){ //创建该文件夹 file.mkdirs(); } //解析request对象,获取上传文件项 DiskFileItemFactory factory = new DiskFileItemFactory(); ServletFileUpload upload = new ServletFileUpload(factory); //解析request List<FileItem> items = upload.parseRequest(request); //遍历 for (FileItem item:items){ //进行判断当前item对象是否是上传文件项 if (item.isFormField()){ //说明普通表单项 }else{ //说明上传文件项 //获取上传文件的名称 String filename = item.getName(); //把文件的名称设置为唯一值,uuid String uuid = UUID.randomUUID().toString().replace("-",""); filename = uuid+"_"+filename; //完成文件上传 item.write(new File(path,filename)); //删除临时文件 item.delete(); } } return "success"; }
该方式支持任何类型的文件上传(另外,上传文件的大小貌似挺大的,我没有去深究哪里可以设置上传文件的大小)
文件上传后,服务器项目路径下会创建一个uploads文件夹,里面存储上传的文件:
方式二:springmvc传统文件上传
传统方式的文件上传,指的是我们上传的文件和访问的应用存在于同一台服务器上。 并且上传完成之后,浏览器可能跳转。
编写控制器:
@Controller @RequestMapping("/user") public class UserController { /** * springmvc传统方式文件上传 */ @RequestMapping("/fileupload2") public String fileupload2(HttpServletRequest request, MultipartFile upload) throws Exception{ System.out.println("springmvc文件上传。。。"); //使用fileupload组件完成文件上传 //获取上传位置 String path = request.getSession().getServletContext().getRealPath("/uploads/"); //判断该路径是否存在 File file = new File(path); if (!file.exists()){ //创建该文件夹 file.mkdirs(); } //说明文件上传项 //获取上传文件名称 String filename = upload.getOriginalFilename(); //把文件的名称设置为唯一值,uuid String uuid = UUID.randomUUID().toString().replace("-",""); filename = uuid+"_"+filename; //完成文件上传 upload.transferTo(new File(path,filename)); return "success"; } }
注意:SpringMVC框架提供了MultipartFile对象,该对象表示上传的文件,要求变量名称必须和表单file标签的 name属性名称相同。
与方式一不同的是,springmvc文件上传方式需要在springmvc.xm文件中提供一个文件解析器:
<!-- 配置文件解析器对象,要求id名称必须是multipartResolver --> <!--使用传统文件上传时,不需要该文件解析器--> <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"> <property name="maxUploadSize" value="10485760"/> </bean>
<property name="maxUploadSize" value="10485760"/>设置了上传文件的大小上限!
注意:文件上传的解析器 id是固定的,不能起别的名称,否则无法实现请求参数的绑定。
方式三:springmvc跨服务器文件上传
分服务器的目的:
在实际开发中,我们会有很多处理不同功能的服务器。例如:
应用服务器:负责部署我们的应用
数据库服务器:运行我们的数据库
缓存和消息服务器:负责处理大并发访问的缓存和消息
文件服务器:负责存储用户上传文件的服务器。
(注意:此处说的不是服务器集群)
分服务器处理的目的是让服务器各司其职,从而提高我们项目的运行效率。
准备两个 tomcat 服务器,并创建一个用于存放文件的 web 工程模块
其中新建的tomcat用于部署该模块,如图:(注意端口改成了9090和1090)
因为是跨服务器文件上传,所以我们还需要在pom.xml中添加两个jar包依赖:
<!--springmvc跨服务器文件上传所需要的包依赖--> <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>
编写控制器:
@Controller @RequestMapping("/user") public class UserController { /** * springmvc跨服务器文件上传 */ @RequestMapping("/fileupload3") public String fileupload3(MultipartFile upload) throws Exception{ System.out.println("跨服务器文件上传。。。"); //定义上传服务器路径 String path = "http://localhost:9090/uploads/"; //说明上传文件项 //获取上传文件的名称 String filename = upload.getOriginalFilename(); //把文件的名称设置为唯一值,uuid String uuid = UUID.randomUUID().toString().replace("-",""); filename = uuid+"_"+filename; //创建客户端的对象 Client client = Client.create(); //和图片服务器进行连接 WebResource webResource = client.resource(path+filename); //上传文件 webResource.put(upload.getBytes()); return "success"; } }
和方式二一样,需要在springmvc.xml中配置文件解析器!
最后,启动两个tomcat服务器,进行文件上传发现会报错:
当我们使用jersy把图片或其他类型文件上传到我们的服务器中【tomcat】,我们可能会遇见以下三个错误:
returned a response status of 400
returned a response status of 403
returned a response status of 409
1. 错误400解决方法
排除url和参数错误,这里只说在你确认代码无误的情况下报错的情况: 不管上传的是什么类型的文件,文件名改成英文名。
2. 错误403解决方法
tomcat服务器默认是不可写操作,只允许读,所以在Tomcat web.xml文件中的servlet标签内加入readonly:false
3 错误409解决方法
409路径错误,即当前访问的路径下没有相关文件。 解决办法:在文件存储服务器中的target/项目名的路径下,新建一个和你上传服务器路径一致的文件,我这里是uploads文件。
(补充:当文件名中出现空格时,如:1205 1206.xlsx,依旧会上传失败,所以我们需要在控制器里修改一下文件名,将“ ”空格去除,代码如下:
filename = filename.toString().replace(" ","");)