在開發Web應用程序時比較常見的功能之一,就是允許用戶利用multipart請求將本地文件上傳到服務器,而這正是Grails的堅固基石——SpringMVC其中的一個優勢。Spring通過對ServletAPI的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請求,就表明在控制器實例中存在一個實現MultipartHttpServletRequest接口的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}" ) )
}
}
直接使用MultipartHttpServletRequ
est實例可以用來管理文件