首頁 > 軟體

Springmvc檔案上傳實現流程解析

2020-09-23 15:03:53

SpringMVC 中對檔案上傳做了封裝，我們可以更加方便的實現檔案上傳。從 Spring3.1
開始，對於檔案上傳，提供了兩個處理器：

  • CommonsMultipartResolver
  • StandardServletMultipartResolver

第一個處理器相容性較好，可以相容 Servlet3.0 之前的版本，但是它依賴了commons-fileupload 這個第三方工具，所以如果使用這個，一定要新增 commons-fileupload 依賴。

第二個處理器相容性較差，它適用於 Servlet3.0之後的版本，它不依賴第三方工具，使用它，可以直接做檔案上傳。

CommonsMultipartResolver

新增依賴

<dependency>
  <groupId>commons-fileupload</groupId>
  <artifactId>commons-fileupload</artifactId>
  <version>1.4</version>
</dependency>

設定MultipartResolver

<bean class="org.springframework.web.multipart.commons.CommonsMultipartResolver" id="multipartResolver"/>

注意，這個 Bean 一定要有 id，並且 id 必須是 multipartResolver

建立jsp頁面

<form action="/upload" method="post" enctype="multipart/form-data">
  <input type="file" name="file">
  <input type="submit" value="上傳">
</form>

注意檔案上傳請求是 POST 請求，enctype 一定是 multipart/form-data

開發檔案上傳介面

@Controller
public class FileUploadController {
  SimpleDateFormat sdf = new SimpleDateFormat("/yyyy/MM/dd/");
    @RequestMapping("/upload")
  @ResponseBody
  public String upload(MultipartFile file, HttpServletRequest req) {
    String format = sdf.format(new Date());
    String realPath = req.getServletContext().getRealPath("/img") + format;
    File folder = new File(realPath);
    if (!folder.exists()) {
      folder.mkdirs();
    }
    String oldName = file.getOriginalFilename();
    String newName = UUID.randomUUID().toString() + oldName.substring(oldName.lastIndexOf("."));
    try {
      file.transferTo(new File(folder, newName));
      String url = req.getScheme() + "://" + req.getServerName() + ":" + req.getServerPort() + "/img" + format + newName;
      return url;
    } catch (IOException e) {
      e.printStackTrace();
    }
    return "failed";
  }
}

這個檔案上傳方法中，一共做了四件事：

  • 解決檔案儲存路徑，這裡是儲存在專案執行目錄下的 img 目錄下，然後利用日期繼續寧分類
  • 處理檔名問題，使用 UUID 做新的檔名，用來代替舊的檔名，可以有效防止檔名衝突
  • 儲存檔案
  • 生成檔案存取路徑

這裡還有一個小問題，在 SpringMVC 中，靜態資源預設都是被自動攔截的，無法存取，意味著上傳成功的圖片無法存取，因此，還需要我們在 SpringMVC 的組態檔中，再新增如下設定：

<mvc:resources mapping="/**" location="/"/>

完成之後，就可以存取 jsp 頁面，做檔案上傳了。

當然，預設的設定不一定滿足我們的需求，我們還可以自己手動組態檔上傳大小等：

<bean class="org.springframework.web.multipart.commons.CommonsMultipartResolver" id="multipartResolver">
  <!--預設的編碼-->
  <property name="defaultEncoding" value="UTF-8"/>
  <!--上傳的總檔案大小-->
  <property name="maxUploadSize" value="1048576"/>
  <!--上傳的單個檔案大小-->
  <property name="maxUploadSizePerFile" value="1048576"/>
  <!--記憶體中最大的資料量，超過這個資料量，資料就要開始往硬碟中寫了-->
  <property name="maxInMemorySize" value="4096"/>
  <!--臨時目錄，超過 maxInMemorySize 設定的大小後，資料開始往臨時目錄寫，等全部上傳完成後，再將資料合併到正式的檔案上傳目錄-->
  <property name="uploadTempDir" value="file:///E:tmp"/>
</bean>

StandardServletMultipartResolver

這種檔案上傳方式，不需要依賴第三方 jar（主要是不需要新增 commons-fileupload 這個依賴），但是也不支援 Servlet3.0 之前的版本。

使用 StandardServletMultipartResolver ，那我們首先在 SpringMVC 的組態檔中，設定這個 Bean：

<bean class="org.springframework.web.multipart.support.StandardServletMultipartResolver" id="multipartResolver"></bean>

注意，這裡 Bean 的名字依然叫 multipartResolver

設定完成後，注意，這個 Bean 無法直接設定上傳檔案大小等限制。需要在 web.xml 中進行設定（這裡，即使不需要限制檔案上傳大小，也需要在 web.xml 中設定 multipart-config）：

<servlet>
  <servlet-name>springmvc</servlet-name>
  <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  <init-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>classpath:spring-servlet.xml</param-value>
  </init-param>
  <multipart-config>
    <!--檔案儲存的臨時目錄，這個目錄系統不會主動建立-->
    <location>E:temp</location>
    <!--上傳的單個檔案大小-->
    <max-file-size>1048576</max-file-size>
    <!--上傳的總檔案大小-->
    <max-request-size>1048576</max-request-size>
    <!--這個就是記憶體中儲存的檔案最大大小-->
    <file-size-threshold>4096</file-size-threshold>
  </multipart-config>
</servlet>
<servlet-mapping>
  <servlet-name>springmvc</servlet-name>
  <url-pattern>/</url-pattern>
</servlet-mapping>

設定完成後，就可以測試檔案上傳了，測試方式和上面一樣。

多檔案上傳

多檔案上傳分為兩種，一種是 key 相同的檔案，另一種是 key 不同的檔案。

1 key 相同的檔案

這種上傳，前端頁面一般如下：

<form action="/upload2" method="post" enctype="multipart/form-data">
  <input type="file" name="files" multiple>
  <input type="submit" value="上傳">
</form>

主要是 input 節點中多了 multiple 屬性。後端用一個陣列來接收檔案即可：

@RequestMapping("/upload2")
@ResponseBody
public void upload2(MultipartFile[] files, HttpServletRequest req) {
  String format = sdf.format(new Date());
  String realPath = req.getServletContext().getRealPath("/img") + format;
  File folder = new File(realPath);
  if (!folder.exists()) {
    folder.mkdirs();
  }
  try {
    for (MultipartFile file : files) {
      String oldName = file.getOriginalFilename();
      String newName = UUID.randomUUID().toString() + oldName.substring(oldName.lastIndexOf("."));
      file.transferTo(new File(folder, newName));
      String url = req.getScheme() + "://" + req.getServerName() + ":" + req.getServerPort() + "/img" + format + newName;
      System.out.println(url);
    }
  } catch (IOException e) {
    e.printStackTrace();
  }
}

2 key 不同的檔案

key 不同的，一般前端定義如下：

<form action="/upload3" method="post" enctype="multipart/form-data">
  <input type="file" name="file1">
  <input type="file" name="file2">
  <input type="submit" value="上傳">
</form>

這種，在後端用不同的變數來接收就行了：

@RequestMapping("/upload3")
@ResponseBody
public void upload3(MultipartFile file1, MultipartFile file2, HttpServletRequest req) {
  String format = sdf.format(new Date());
  String realPath = req.getServletContext().getRealPath("/img") + format;
  File folder = new File(realPath);
  if (!folder.exists()) {
    folder.mkdirs();
  }
  try {
    String oldName = file1.getOriginalFilename();
    String newName = UUID.randomUUID().toString() + oldName.substring(oldName.lastIndexOf("."));
    file1.transferTo(new File(folder, newName));
    String url1 = req.getScheme() + "://" + req.getServerName() + ":" + req.getServerPort() + "/img" + format + newName;
    System.out.println(url1);
    String oldName2 = file2.getOriginalFilename();
    String newName2 = UUID.randomUUID().toString() + oldName2.substring(oldName2.lastIndexOf("."));
    file2.transferTo(new File(folder, newName2));
    String url2 = req.getScheme() + "://" + req.getServerName() + ":" + req.getServerPort() + "/img" + format + newName2;
    System.out.println(url2);
  } catch (IOException e) {
    e.printStackTrace();
  }
}

以上就是本文的全部內容，希望對大家的學習有所幫助，也希望大家多多支援it145.com。


相關文章

IT145.com E-mail:sddin#qq.com