這一篇博文主要來總結下SpringMVC中實現檔案上傳的步驟。但這裡我只講單個檔案的上傳。

環境準備

SpringMVC上傳檔案的功能需要兩個jar包的支援，如下：

工程中肯定要匯入以上兩個jar包，主要是CommonsMultipartResolver解析器依賴commons-fileupload和commons-io這兩個jar包。

單個檔案的上傳

前臺頁面

我們要改造editItem.jsp頁面，主要是在form表單中新增商品圖片一欄，效果我截圖如下：

注意一點的是form表單中別忘了寫enctype="multipart/form-data"屬性。

對多部件型別multipart解析

意思就是說針對上面的enctype=”multipart/form-data”型別，SpringMVC需要對multipart型別的資料進行解析，在springmvc.xml中配置multipart型別解析器即可。如下：

<!-- 配置多媒體檔案解析器 -->
<!-- 檔案上傳 -->
<bean id="multipartResolver"
    class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <!-- 設定上傳檔案的最大尺寸為5MB -->
 

    <property name="maxUploadSize">
        <value>5242880</value>
    </property>
</bean>

建立檔案儲存的虛擬目錄

在上傳檔案之前，首先要建立一個虛擬目錄來儲存檔案，這個虛擬目錄會對應磁碟上的一個實際的目錄，在實際開發中肯定會有一個伺服器專門儲存資源的，在這裡我們就用本地磁碟來儲存檔案，然後對映一個虛擬目錄，用來在程式中指定獲取檔案的路徑（其實上面前臺頁面editItem.jsp中，那個src=”/pic/${item.pic}”中的/pic就是虛擬目錄）。
建立的方法有兩種：一是在Eclipse中雙擊tomcat伺服器，就會彈出下面的框框：

選擇Modules，然後點選【Add External Web Module…】，在彈出的對話方塊中進行如下操作，都在圖裡面了。

設定好後，儲存即可，這樣上傳的檔案都會儲存到Document base指定的目錄中，相當於虛擬對映到Path指定的目錄中，程式中獲取這個檔案，要從Path指定的虛擬目錄中獲取，即我上面的/pic。我可舉一個例子，將一個圖片(例如，0d318effd664668f555d43966b3294a6_b.jpg)拷貝到Document base指定的目錄中，即F:\temp\images目錄中，然後啟動tomcat伺服器，在瀏覽器位址列中輸入url訪問地址——http://localhost:8080/pic/0d318effd664668f555d43966b3294a6_b.jpg即可訪問到該圖片。
第二種方法就是在tomcat的配置檔案中配置一下，其實剛剛在Eclipse中的操作已經自動寫到這個配置檔案中了，配置檔案位置在tomcat目錄/conf/server.xml中，看一下里面會多了一行：

這就是剛剛我配置的，它自動寫到這個檔案中了，所以我們也可以直接自己在該配置檔案中寫，就不需要在Eclipse中配置了。

編寫後臺Controller方法

接下來就是重點了，前臺傳過來的檔案，我們在ItemController類中需要進行處理，然後儲存到磁碟中，同時也就對映到了我們配置的虛擬路徑中了，那麼如何接收呢？看下面的程式碼：

@RequestMapping(value="/updateitem",method={RequestMethod.POST,RequestMethod.GET})
public String updateItems(Items items, MultipartFile picture) throws Exception {
    // 把圖片儲存到圖片目錄下
    // 儲存圖片，這個圖片有的時候檔名可能會重複，你儲存多了會把原來的圖片給覆蓋掉，這就不太合適了。
    // 所以為每個檔案生成一個新的檔名
    String picName = UUID.randomUUID().toString();
    // 擷取檔案的副檔名(如.jpg)
    String oriName = picture.getOriginalFilename();
    String extName = oriName.substring(oriName.lastIndexOf("."));
    // 儲存檔案
    picture.transferTo(new File("F:\\temp\\images\\" + picName + extName));

    // 把檔名儲存到資料庫
    items.setPic(picName + extName);
    itemService.updateItem(items);
    return "forward:/item/itemEdit.action";
}

注意：考慮實際情況，儲存圖片時一般不只你一個人儲存圖片，那麼這個圖片有的時候檔名可能會重複，你儲存多了會把原來的圖片給覆蓋掉，這就不太合適了，所以需要使用UUID演算法為每個檔案生成一個新的檔名。
首先來看一下形參，主要有Items和MultipartFile型別的picture，我這裡上傳一張圖片是ItemsCustom類的一個屬性，所以有了這個形參，是為了寫到該類中，SpringMVC檔案上傳的類是MultipartFile，引數名稱picture必須和前臺editItem.jsp頁面的name屬性一致才行。上傳圖片之後的效果類似於：

並且圖片的檔名也儲存到了資料庫表中，如下：

最後總結一下，我上傳檔案的邏輯可能判斷不嚴謹，如果說要更加嚴謹一點的話， 上傳檔案的邏輯就應是：首先判斷有沒有上傳檔案，如果上傳了，那麼對檔案重新命名然後寫到磁碟中。如果沒有上傳檔案，那麼我應該還是用原來的檔案（圖片）。讀者如果有興趣可以參考下面程式碼：

@RequestMapping(value="/updateitem",method={RequestMethod.POST,RequestMethod.GET})
public String updateItems(Items items, MultipartFile picture) throws Exception {

    // 處理上傳的單個圖片    
    String originalFileName = picture.getOriginalFilename();// 原始名稱
    // 上傳圖片
    if (picture != null && originalFileName != null && originalFileName.length() > 0) {
        // 儲存圖片的物理路徑，實際中是要寫到配置檔案中的，不能在這寫死
        String pic_path = "F:\\temp\\images\\";
        // 新的圖片名稱
        String newFileName = UUID.randomUUID()
                + originalFileName.substring(originalFileName
                        .lastIndexOf("."));     
        File newFile = new File(pic_path + newFileName);//新圖片   
        picture.transferTo(newFile);// 將記憶體中的資料寫入磁碟
        items.setPic(newFileName);// 將新圖片名稱寫到itemsCustom中
    } else {
        //如果使用者沒有選擇圖片就上傳了，還用原來的圖片
        Items temp = itemsService.findItemsById(items.getId());
        items.setPic(temp.getPic());
    }

    // 呼叫service更新商品資訊，頁面需要將商品資訊傳到此方法
    itemService.updateItem(items);
    return "forward:/item/itemEdit.action";
}

到這裡，單個檔案的上傳我就已總結完了。