注意:
CommonsMultipartResolver是基於Apache的Commons FileUpload來實現文件上傳功能的。所以在項目中需要相應的jar文件。
並且Jar包在1.2版本以上。
SpringMVC文件上傳器BeanId必須爲multipartResolver。
原理:
MultipartResolver 用於處理文件上傳,當收到請求時 DispatcherServlet 的 checkMultipart() 方法會調用 MultipartResolver 的 isMultipart() 方法判斷請求中是否包含文件。如果請求數據中包含文件,則調用 MultipartResolver 的 resolveMultipart() 方法對請求的數據進行解析,然後將文件數據解析成 MultipartFile 並封裝在 MultipartHttpServletRequest (繼承了 HttpServletRequest) 對象中,最後傳遞給 Controller,在 MultipartResolver 接口中有如下方法:
boolean isMultipart(HttpServletRequest request); // 是否是 multipart
MultipartHttpServletRequest resolveMultipart(HttpServletRequest request); // 解析請求
void cleanupMultipart(MultipartHttpServletRequest request);
MultipartFile 封裝了請求數據中的文件,此時這個文件存儲在內存中或臨時的磁盤文件中,需要將其轉存到一個合適的位置,因爲請求結束後臨時存儲將被清空。在 MultipartFile 接口中有如下方法:
String getName(); // 獲取參數的名稱
String getOriginalFilename(); // 獲取文件的原名稱
String getContentType(); // 文件內容的類型
boolean isEmpty(); // 文件是否爲空
long getSize(); // 文件大小
byte[] getBytes(); // 將文件內容以字節數組的形式返回
InputStream getInputStream(); // 將文件內容以輸入流的形式返回
void transferTo(File dest); // 將文件內容傳輸到指定文件中
MultipartResolver 是一個接口,它的實現類如下圖所示,分爲 CommonsMultipartResolver 類和 StandardServletMultipartResolver 類。
其中 CommonsMultipartResolver 使用 commons Fileupload 來處理 multipart 請求,所以在使用時,必須要引入相應的 jar 包;而 StandardServletMultipartResolver 是基於 Servlet 3.0來處理 multipart 請求的,所以不需要引用其他 jar 包,但是必須使用支持 Servlet 3.0的容器纔可以,以tomcat爲例,從 Tomcat 7.0.x的版本開始就支持 Servlet 3.0了。
<!-- 定義文件上傳解析器 -->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<!-- 設定默認編碼 -->
<property name="defaultEncoding" value="UTF-8"></property>
<!-- 設定文件上傳的最大值爲5MB,5*1024*1024 -->
<property name="maxUploadSize" value="5242880"></property>
<!-- 設定文件上傳時寫入內存的最大值,如果小於這個參數不會生成臨時文件,默認爲10240 -->
<property name="maxInMemorySize" value="40960"></property>
<!-- 上傳文件的臨時路徑 -->
<property name="uploadTempDir" value="fileUpload/temp"></property>
<!-- 延遲文件解析 -->
<property name="resolveLazily" value="true"/>
</bean>
要在 form 標籤中加入 enctype="multipart/form-data" 表示該表單要提交文件。
<form action="${pageContext.request.contextPath}/test/file-upload.do" method="post" enctype="multipart/form-data">
<input type="file" name="file">
<input type="submit" value="提交">
</form>
處理文件
@RequestMapping("/file-upload")
public ModelAndView upload(@RequestParam(value = "file", required = false) MultipartFile file,
HttpServletRequest request, HttpSession session) {
// 文件不爲空
if(!file.isEmpty()) {
// 文件存放路徑
String path = request.getServletContext().getRealPath("/");
// 文件名稱
String name = String.valueOf(new Date().getTime()+"_"+file.getOriginalFilename());
File destFile = new File(path,name);
// 轉存文件
try {
file.transferTo(destFile);
} catch (IllegalStateException | IOException e) {
e.printStackTrace();
}
// 訪問的url
String url = request.getScheme() + "://" + request.getServerName() + ":" + request.getServerPort()
+ request.getContextPath() + "/" + name;
}
ModelAndView mv = new ModelAndView();
mv.setViewName("other/home");
return mv;
}