在实际开发过程中,尤其是web项目开发,文件上传和下载的需求的功能非常场景,比如说用户头像、商品图片、邮件附件等等。其实文件上传下载的本质都是通过流的形式进行读写操作,而在开发中不同的框架都会对文件上传和下载有或多或少的封装,这里就以Spring MVC环境中文件的上传为例,讲解Spirng MVC环境下的文件上传功能实现。
一、客户端编程
由于多数文件上传都是通过表单形式提交给后台服务器的,因此,要实现文件上传功能,就需要提供一个文件上传的表单。同时该表单必须满足以下3个条件:
- form表单的method属性设置为post;
- form表单的enctype属性设置为multipart/form-data;
- 提供<input type=”file” name=”fileName” />的文件上传输入框。
在HTML5之前,如果想要上传多个文件,必须使用多个<input>元素。但是在HTML5中,在<input>元素配置multiple属性即可进行多个文件的上传。在HTML5中编写以下任意一行代码,便可生成一个按钮供选择多个文件:
- <input type=”file” name=”fileName” multiple />
- <input type=”file” name=”images” multiple=”multiple” />
- <input type=”file” name=”images” multiple=”” />
具体代码示例如下:
<form action="uploadUrl" method="post" enctype="multipart/form-data"> <input type="file" name="images" multiple="multiple" /> <input type="submit" value="文件上传" /> </form>
二、springmvc-config.xml配置文件配置
当客户端form表单的enctype属性为multipart/form-data时,浏览器就会采用二进制流的方式来处理表单数据,而对于文件上传的处理则涉及在服务器端解析原始的HTTP请求。Spring MVC为文件上传提供了直接的支持,这种支持是用即插即用的MultipartResolver实现的。
在Sring MVC中使用MultipartResolver也非常简单,只需要在Spring MVC配置文件springmvc-config.xml中定义MultipartResolver接口实现类即可,示例如下:
<!-- 配置文件上传类型解析器 multipartResolver--> <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"> <!-- 设置上传文件最大尺寸,单位为B --> <property name="maxUploadSize" value="5242880" /> </bean>
注意:
由于MultipartResolver实现类CommonsMultipartResolver内部是引用multipartResolver字符串获取该实现类对象并完成文件上传操作的,所以在配置CommonsMultipartResolver时必须指定该bean的id为multipartResolver。另外由于MultipartResolver实现类CommonsMultipartResolver是Spring MVC内部通过Apache Commons FileUpload技术实现的。因此Spirng MVC的文件上传还需要依赖Apache Commons FileUpload的组件,即需要导入支持文件上传和下载的JAR包,具体如下:
- commons-fileupload.jar
- commons-io.jar
三、后台文件下载实现(MultipartFile接口介绍)
当完成上述客户端代码的编写及文件上传组件的配置后,在Spring MVC中处理已经上传的文件就十分容易了,上传到Spring MVC程序中的文件会被封装到一个MultipartFile对象中,然后开发者通过该对象的方法就可以进行后续相关处理了。
编写后台文件上传控制器类及方法,具体示例如下:
/** * 向文件上传页面跳转 */ @RequestMapping("/toFileUpload") public String toFileUpload( ){ return "fileUpload"; } /** * 接收文件上传请求 */ @RequestMapping("/fileUpload") public String fileUpload(List<MultipartFile> images){ //对上传图像进行解析操作 if(images !=null && images.size()>0){ for (MultipartFile image : images) { //获取上传文件的原始名称 String originalFilename = image.getOriginalFilename(); //设置上传文件的保存地址目录 String dirPath="D://fileUpload//"; File file =new File(dirPath); //如果保存文件的地址不存在,就先创建目录 if(!file.exists()){ file.mkdirs(); } //使用UUID重新命名上传的文件名称(看公司需求,也可以用日期时间) String newFilename= UUID.randomUUID()+originalFilename.substring(originalFilename.lastIndexOf(".")); try { //使用MultipartFile接口的方法完成文件上传到指定位置 image.transferTo(new File(dirPath+newFilename)); //文件上传成功后,需要将文件存放路径存入数据库中 //TODO,省略 } catch (Exception e) { e.printStackTrace(); //当文件上传出现异常,则重定向到文件上传页面 return "redirect:toFileUpload"; } } } //文件上传成功后,跳转到成功页面 return "success"; }
四、效果演示(读者可以自己编写项目和jsp页面)
部署并启动web服务器,在浏览器地址啦输入地址:http://localhost:8080/webname/toFileUpload后(读者根据自己的项目和路径进行访问),浏览器的显示效果如下图所示。
上面我选择了上传2个文件,然后点击提交后,即可完成上传。读者操作后可自行到指定上传位置进行验证。
至此,Sring MVC环境下文件上传功能代码即已实现。
原创文章,作者:奋斗,如若转载,请注明出处:https://blog.ytso.com/15656.html