之前有写过一篇struts2实现的文件上传,这一篇博文主要来总结下springmvc实现文件上传的步骤。首先来看一下单个文件的上传,然后再来总结下多个文件上传。
1. 环境准备
springmvc上传文件的功能需要两个jar包的支持http://download.csdn.net/detail/eson_15/9556808,如下
2. 单个文件的上传
2.1 前台页面
简单的写一下前台页面,注意一点的是form表单中别忘了写enctype="multipart/form-data"
属性:
<tr> <td>商品图片</td> <td><c:if test="${itemsCustom.pic !=null}"> <img src="/file/${itemsCustom.pic}" width=100 height=100 /><br /> </c:if> <input type="file" name="items_pic"/> </td> </tr>
2.2 对多部件类型multipart解析
意思就是说针对上面的enctype="multipart/form-data"
类型,springmvc需要对multipart类型的数据进行解析,在springmvc.xml中配置multipart类型解析器即可。
<!-- 文件上传,需要配置MultipartResolver处理器 --> <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"> <!-- 设置船上文件的最大尺寸为5MB --> <property name="maxUploadSize" value="5242880"/> <property name="defaultEncoding" value="utf-8"/> </bean>
2.3 创建文件保存的虚拟目录
在上传文件之前,首先要创建一个虚拟目录来保存文件,这个虚拟目录会对应磁盘上的一个实际的目录,在实际中肯定会有一个服务器专门存储资源的,在这里我们就用本地来保存文件,然后映射一个虚拟目录,用来在程序中指定获取文件的路径(其实上面前台页面中,那个src=”/file/${itemsCustom.pic}”中的/file就是虚拟目录)。
创建的方法有两种:一是在Myeclipse中双击tomcat服务器,然后弹出下面的框框:
设置好后,保存即可,这样上传的文件都会保存到Document base指定的目录中,相当于虚拟映射到path指定的目录中,程序中获取这个文件,要从path指定的虚拟目录中获取,即我上面的/file。
第二种方法就是在tomcat的配置文件中配置一下,其实刚刚在Myeclipse中的操作已经自动写到这个配置文件中了,配置文件位置在tomcat目录/conf/server.xml中,看一下里面会多了一行:
这就是刚刚我配置的,它自动写到这个文件中了,所以我们也可以直接自己在文件中写,就不需要在Myeclipse中配置了。
2.4 编写后台Controller方法
接下来就是重点了,前台传过来的文件,我们在controller中需要进行处理,然后保存到磁盘中,同时也就映射到了我们配置的虚拟路径中了,那么如何接收呢?看下面的代码:
@RequestMapping("/editItemsSubmit") public String editItemsSubmit(Model model, HttpServletRequest request, Integer id, @Validated(value = { ValidGroup1.class }) ItemsCustom itemsCustom, BindingResult bindingResult, @RequestParam MultipartFile[] items_pic) throws Exception { // 获取校验错误信息 if (bindingResult.hasErrors()) { // 输出错误信息 List<ObjectError> allErrors = bindingResult.getAllErrors(); for (ObjectError objectError : allErrors) { // System.out.println(objectError.getDefaultMessage()); // 原来是上面这句,但是由于properties文件默认无法输入中文,所以我把properties文件改成了utf-8编码, // 但是这样的话读取出来就是乱码了,所以我先用iso打乱,再用utf-8生成,即可解决乱码问题 System.out.println(new String(objectError.getDefaultMessage() .getBytes("ISO-8859-1"), "UTF-8")); } // 将错误信息传到页面 model.addAttribute("allErrors", allErrors); } /* // 处理上传的单个图片 // 原始名称 String originalFileName = items_pic.getOriginalFilename(); // 上传图片 if (items_pic != null && originalFileName != null && originalFileName.length() > 0) { // 存储图片的物理路径 String pic_path = "E:\github\develop\upload\temp\"; // 新的图片名称 String newFileName = UUID.randomUUID() + originalFileName.substring(originalFileName .lastIndexOf(".")); // 新图片 File newFile = new File(pic_path + newFileName); // 将内存中的数据写入磁盘 items_pic.transferTo(newFile); // 将新图片名称写到itemsCustom中 itemsCustom.setPic(newFileName); } else { //如果用户没有选择图片就上传了,还用原来的图片 ItemsCustom temp = itemsService.findItemsById(itemsCustom.getId()); itemsCustom.setPic(temp.getPic()); } // 调用service更新商品信息,页面需要将商品信息传到此方法 itemsService.updateItems(id, itemsCustom); */ // return "redirect:queryItems.action"; // return "forward:queryItems.action"; return "/WEB-INF/jsp/success.jsp"; }
首先来看一下形参,主要有ItemsCustom和MultipartFile类型的items_pic,我这里上传一张图片是ItemsCustom类的一个属性,所以有了这个形参,是为了写到该类中,另外前面的@Validated注解是我写springmvc校验的时候用的,跟这里文件上传无关。springmvc文件上传的类是MultipartFile,名items_pic必须和前台的name属性一致才行。
上传文件的逻辑是,首先判断有没有上传文件,如果上传了,那么对文件重新命名然后写到磁盘中。如果没有上传文件,那么我应该还是用原来的文件(图片),因为我写的这个例子是更新商品信息,对文件上传那里没有做非空验证,所以在这里写了else。
这样文件就上传完了,这是单个文件的上传。但是有点问题 会报错,后来注释掉使用 多文件上传。
3. 多个文件的上传
多个文件上传和单个文件上传原理一样的,不过在细节上会有点不同,待我一个个总结。首先在前台页面上要注意的一点是name属性必须一样,即:
@RequestMapping("/editItemsSubmit") public String editItemsSubmit(Model model, HttpServletRequest request, Integer id, @Validated(value = { ValidGroup1.class }) ItemsCustom itemsCustom, BindingResult bindingResult, @RequestParam MultipartFile[] items_pic) throws Exception { // 获取校验错误信息 if (bindingResult.hasErrors()) { // 输出错误信息 List<ObjectError> allErrors = bindingResult.getAllErrors(); for (ObjectError objectError : allErrors) { // System.out.println(objectError.getDefaultMessage()); // 原来是上面这句,但是由于properties文件默认无法输入中文,所以我把properties文件改成了utf-8编码, // 但是这样的话读取出来就是乱码了,所以我先用iso打乱,再用utf-8生成,即可解决乱码问题 System.out.println(new String(objectError.getDefaultMessage() .getBytes("ISO-8859-1"), "UTF-8")); } // 将错误信息传到页面 model.addAttribute("allErrors", allErrors); } //多个文件上传 //多个图片,不存数据库了,在此打印一下即可 for(MultipartFile myfile:items_pic){ if(myfile.isEmpty()){ System.out.println("文件未上传"); }else{ System.out.println("文件长度: "+myfile.getSize()); System.out.println("文件类型: "+myfile.getContentType()); System.out.println("文件名称: "+myfile.getName()); System.out.println("文件原名: "+myfile.getOriginalFilename()); System.out.println("========================"); String originalFileName=myfile.getOriginalFilename(); String pic_path="E:\github\develop\upload\temp\"; String newFileName=UUID.randomUUID()+originalFileName.substring(originalFileName.lastIndexOf(".")); File newFile = new File(pic_path + newFileName); myfile.transferTo(newFile); } } /* // 处理上传的单个图片 // 原始名称 String originalFileName = items_pic.getOriginalFilename(); // 上传图片 if (items_pic != null && originalFileName != null && originalFileName.length() > 0) { // 存储图片的物理路径 String pic_path = "E:\github\develop\upload\temp\"; // 新的图片名称 String newFileName = UUID.randomUUID() + originalFileName.substring(originalFileName .lastIndexOf(".")); // 新图片 File newFile = new File(pic_path + newFileName); // 将内存中的数据写入磁盘 items_pic.transferTo(newFile); // 将新图片名称写到itemsCustom中 itemsCustom.setPic(newFileName); } else { //如果用户没有选择图片就上传了,还用原来的图片 ItemsCustom temp = itemsService.findItemsById(itemsCustom.getId()); itemsCustom.setPic(temp.getPic()); } // 调用service更新商品信息,页面需要将商品信息传到此方法 itemsService.updateItems(id, itemsCustom); */ // return "redirect:queryItems.action"; // return "forward:queryItems.action"; return "/WEB-INF/jsp/success.jsp"; }
如上,形参变成数组类型了,且前面要加上@RequestParam注解才行。然后获取的话,就是遍历这个数组,循环内部与上面的单个文件上传就一模一样了。看一下打印结果:
http://localhost:8080/SpringMVC_Study/editItems.action?id=3
可以看到,两个文件都顺利接收到,至此,多文件上传成功。关于springmvc的文件上传功能就总结到这吧。
本篇遇到了些问题 一直提示 编码 UTF-8 的不可映射字符 加上如下代码也不起作用
<build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>2.1</version> <configuration> <skip>true</skip> <source>1.6</source> <target>1.6</target> <!-- <source>${java.compiler}</source> <target>${java.compiler}</target> --> <encoding>UTF-8</encoding> </configuration> </plugin> </plugins> </build> <properties> <project.build.sourceEncoding>utf-8</project.build.sourceEncoding> </properties>
最后发现是 Java Compiler 版本已经Installed JRE版本问题