我们通过使用multipart请求数据接收和处理二进制信息(如文件)。DispatcherServlet并没有实现任何解析multipart请求数据的功能,它将该任务委托给了Spring中的multipart解析器,
通过MultipartResolver接口的实现,来解析multipart请求中的内容。
Spring3.1开始,Spring内置了两个MultipartResolver实现供我们选择:
1.CommonMultipartResolver
2.StandardServletMultipartResolver(推荐使用,由于使用Servlet所提供的功能支持,并不需要依赖任何其他的项目)
下面是具体实现过程:
一、配置multipart解析器
在Spring应用上下文中,我们现将StandardServletMultipartResolver声明为bean:
<!-- Multipart解析器配置 --> <bean id="multipartResolver" class="org.springframework.web.multipart.support.StandardServletMultipartResolver"/>
除此而外,我们还需要为StandardServletMultipartResolver设置相关参数。需要注意的是,StandardServletMultipartResolver无法直接通过property标签来设置(StandardServletMultipartResolver
没有构造参数,也没有要设置的属性),要设置相关参数,最简单的方法就是在web.xml配置中添加MultipartConfigElement:
<!-- multipart解析器参数配置 --> <multipart-config> <!--<location>/tmp/upload</location>--> <max-file-size>2097152</max-file-size> <max-request-size>4194304</max-request-size> </multipart-config>
location配置了文件上传过程中所写入的临时路径(个人感觉和MultipartFile.transferTo()方法所造成的结果类似)
max-file-size规定了上传文件的大小(不超过2MB)
max-request-size规定了整个请求的大小(不超过4MB)
二、创建文件上传请求表单
配置好Multipart解析器后,我们需要一个简单的文件上传表单作为我们的前端视图:
<div> upload file: <form action="http://localhost:8080/trymaven/upload" method="post" enctype="multipart/form-data"> file: <input type="file" name="fileName"/> <input type="submit" value="submit"/> </form> </div>
需要注意的是,我们在form标签中设置enctype属性的值为multipart/form-data,它将会告诉浏览器以multipart数据的形式提交表单,而不是以表单数据的形式进行提交。
除此而外,我们需要将input标签中的type属性值设置为file,时期接收一个二进制数据。
三、处理multipart请求
这里我们创建了一个新的Controller类用于响应处理mulitpart请求:
package example.controller; import org.springframework.beans.factory.annotation.Value; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.RequestPart; import org.springframework.web.multipart.MultipartFile; import java.io.File; import java.io.IOException; @Controller public class UploadFileController { @Value("#{settings['filePath']}") private String filePath; @RequestMapping(value = "upload", method = RequestMethod.POST) public String uploadFile(@RequestPart("fileName") MultipartFile file) throws IOException { String path = filePath + new String(file.getOriginalFilename().getBytes(), "utf-8"); file.transferTo(new File(path)); return "uploadInfo"; } }
这里我们使用@RequestPart()注解指定MultipartFile类型的参数file接收请求中对应的part数据(这里也可以是byte,但是原始byte比较简单但是功能有限),
MultipartFile.transferTo(File)用于将上传的文件临时写入路径。
值得注意的是,这里我们将路径信息通过配置文件暴露在外面,用户可以通过修改配置文件修改临时路径
配置文件内容:
filePath=D:/任务/
设置配置文件路径:
<util:properties id="settings" location="classpath:file.properties" />
通过@Value()注解将配置文件中的key对应值注入变量
@Value("#{settings['filePath']}") private String filePath;
settings为定义的id,['filePath']为配置文件中的key(若配置文件中路径有中文,要修改配置文件编码为utf-8,不然在运行项目时会出现路径映射问题)
经过测试后发现文件路径配置写在applicationContext.xml和dispatcher-servlet.xml中都可以。
四、运行项目
运行项目后,上传文件以及结果如下:
到指定临时目录下找到写入的文件: