使用multipart請求處理檔案上傳

在開發Web應用程式時比較常見的功能之一，就是允許使用者利用multipart請求將本地檔案上傳到伺服器，而這正是Grails的堅固基石——Spring MVC其中的一個優勢。Spring通過對Servlet API的HttpServletRequest介面進行擴充，使其能夠很好地處理檔案上傳。擴充後的介面名為org.springframework.web.multipart.MultipartHttpServletRequest，其內容如清單7-31所示。

清單7-31  org.springframework.web.multipart.MultipartHttpServletRequest介面

interface MultipartHttpServletRequest extends HttpServletRequest {

public MultipartFile getFile(String name);

public Map getFileMap();

public Iterator getFileNames();

}

如清單所示，MultipartHttpServletRequest介面簡單地擴充了預設的HttpServletRequest介面，並提供一些用來處理請求檔案的方法。

7.10.1  使用multipart請求

實際上只要發現一個multipart請求，就表明在控制器執行個體中存在一個實現Multipart HttpServletRequest介面的request對象。我們可以通過清單7-31所示的方法來訪問multipart請求中的上傳檔案，不過在處理上傳檔案之前，先來看一下上傳表單的內容，如清單7-32所示。

清單7-32  上傳表單樣本

<form action="upload" enctype="multipart/form-data">

<input type="file" name="myFile" />

<input type="submit" value="Upload! " />

</form>

粗體顯示的是需要注意的部分，實際上一個上傳表單只需要滿足如下兩點。

l  enctype屬性的屬性值設為multipart/form-data。

l  input的type屬性的屬性值設為file。

在前面的樣本中，<input>標籤中屬性type的值為file，且name屬性的值為myFile，之所以需要name屬性值，是因為在使用介面MultipartHttpServletRequest的getFile方法時需要使用name屬性的值。例如在清單7-33中，代碼中的upload操作會從請求中讀取上傳檔案。

清單7-33  讀取上傳檔案

def upload = {

def file = request.getFile('myFile')

// 處理該檔案

}

注意getFile方法不會返回一個java.io.File的執行個體，而是返回org.springframework.web. multipart.MultipartFile的一個執行個體，關於org.springframework.web.multipart.MultipartFile的詳細資料，請參考清單7-34。如果在請求中沒有找到檔案則getFile方法返回null。

清單7-34  org.springframework.web.multipart.MultipartFile介面

interface MultipartFile {

public byte[] getBytes();

public String getContentType();

public java.io.InputStream getInputStream();

public String getName();

public String getOriginalFilename();

public long getSize();

public boolean isEmpty();

public void transferTo(java.io.File dest);

}

在MultipartFile介面中定義了如下很多有用的方法。

l  使用getSize()方法獲得檔案長度，以此決定允許上傳的檔案大小。

l  使用isEmpty()方法判斷上傳檔案是否為空白檔案，以此決定是否拒絕空檔案。

l  使用getInputStream()方法將檔案讀取為java.io.InputStream流對象。

l  使用getContentType()方法獲得檔案類型，以此決定允許上傳的檔案類型。

l  使用transferTo（dest）方法將上傳檔案寫到伺服器上指定的檔案。

例如，如果上傳的檔案不為空白並且大小不小於1024位元組，那麼可以按照清單7-35中的代碼來實現。

清單7-35  檔案上傳樣本

def upload = {

def file = request.getFile('myFile')

if(file && !file.empty && file.size < 1024) {

file.transferTo( new java.io.File( "/local/server/path/${file.name}" ) )

}

}

直接使用MultipartHttpServletRequest執行個體可以用來管理檔案上傳，但實際應用常常需要讀取檔案內容。