1、概述
在最初的 http 協(xié)議中,沒(méi)有上傳文件方面的功能。 rfc1867 (
http://www.ietf.org/rfc/rfc1867.txt) 為 http 協(xié)議添加了這個(gè)功能??蛻舳说臑g覽器,如 Microsoft IE, Mozila, Opera 等,按照此規(guī)范將用戶指定的文件發(fā)送到服務(wù)器。服務(wù)器端的網(wǎng)頁(yè)程序,如 php, asp, jsp 等,可以按照此規(guī)范,解析出用戶發(fā)送來(lái)的文件。
Microsoft IE, Mozila, Opera 已經(jīng)支持此協(xié)議,在網(wǎng)頁(yè)中使用一個(gè)特殊的 form 就可以發(fā)送文件。
絕大部分 http server ,包括 tomcat ,已經(jīng)支持此協(xié)議,可接受發(fā)送來(lái)的文件。
各種網(wǎng)頁(yè)程序,如 php, asp, jsp 中,對(duì)于上傳文件已經(jīng)做了很好的封裝。
2、上傳文件的實(shí)例:用 servelet 實(shí)現(xiàn)(http server 為 tomcat 4.1.24)
1. 在一個(gè) html 網(wǎng)頁(yè)中,寫(xiě)一個(gè)如下的form :
<form enctype="multipart/form-data" action="http://192.168.29.65/UploadFile" method=post>
load multi files :<br>
<input name="userfile1" type="file"><br>
<input name="userfile2" type="file"><br>
<input name="userfile3" type="file"><br>
<input name="userfile4" type="file"><br>
text field :<input type="text" name="text" value="text"><br>
<input type="submit" value="提交"><input type=reset>
</form>
2. 服務(wù)端 servelet 的編寫(xiě)
現(xiàn)在第三方的 http upload file 工具庫(kù)很多。Jarkata 項(xiàng)目本身就提供了fileupload 包http://jakarta.apache.org/commons/fileupload/ 。文件上傳、表單項(xiàng)處理、效率問(wèn)題基本上都考慮到了。在 struts 中就使用了這個(gè)包,不過(guò)是用 struts 的方式另行封裝了一次。這里我們直接使用 fileupload 包。至于struts 中的用法,請(qǐng)參閱 struts 相關(guān)文檔。
這個(gè)處理文件上傳的 servelet 主要代碼如下:
public void doPost( HttpServletRequest request, HttpServletResponse response ) {
DiskFileUpload diskFileUpload = new DiskFileUpload();
// 允許文件最大長(zhǎng)度
diskFileUpload.setSizeMax( 100*1024*1024 );
// 設(shè)置內(nèi)存緩沖大小
diskFileUpload.setSizeThreshold( 4096 );
// 設(shè)置臨時(shí)目錄
diskFileUpload.setRepositoryPath( "c:/tmp" );
List fileItems = diskFileUpload.parseRequest( request );
Iterator iter = fileItems.iterator();
for( ; iter.hasNext(); ) {
FileItem fileItem = (FileItem) iter.next();
if( fileItem.isFormField() ) {
// 當(dāng)前是一個(gè)表單項(xiàng)
out.println( "form field : " + fileItem.getFieldName() + ", " + fileItem.getString() );
} else {
// 當(dāng)前是一個(gè)上傳的文件
String fileName = fileItem.getName();
fileItem.write( new File("c:/uploads/"+fileName) );
}
}
}
為簡(jiǎn)略起見(jiàn),異常處理,文件重命名等細(xì)節(jié)沒(méi)有寫(xiě)出。
3、 客戶端發(fā)送內(nèi)容構(gòu)造
a
bb
XXX
ccc
客戶端應(yīng)該向 192.168.29.65 發(fā)送如下內(nèi)容:
POST /upload_file/UploadFile HTTP/1.1
Accept: text/plain, */*
Accept-Language: zh-cn
Host: 192.168.29.65:80
Content-Type:multipart/form-data;boundary=---------------------------7d33a816d302b6
User-Agent: Mozilla/4.0 (compatible; OpenOffice.org)
Content-Length: 424
Connection: Keep-Alive
-----------------------------7d33a816d302b6
Content-Disposition: form-data; name="userfile1"; filename="E:\s"
Content-Type: application/octet-stream
a
bb
XXX
ccc
-----------------------------7d33a816d302b6
Content-Disposition: form-data; name="text1"
foo
-----------------------------7d33a816d302b6
Content-Disposition: form-data; name="password1"
bar
-----------------------------7d33a816d302b6--
此內(nèi)容必須一字不差,包括最后的回車(chē)。
注意:Content-Length: 424 這里的424是紅色內(nèi)容的總長(zhǎng)度(包括最后的回車(chē))
注意這一行:
Content-Type: multipart/form-data; boundary=---------------------------7d33a816d302b6
根據(jù) rfc1867, multipart/form-data是必須的.
---------------------------7d33a816d302b6 是分隔符,分隔多個(gè)文件、表單項(xiàng)。其中33a816d302b6 是即時(shí)生成的一個(gè)數(shù)字,用以確保整個(gè)分隔符不會(huì)在文件或表單項(xiàng)的內(nèi)容中出現(xiàn)。前面的 ---------------------------7d 是 IE 特有的標(biāo)志。 Mozila 為---------------------------71
用手工發(fā)送這個(gè)例子,在上述的 servlet 中檢驗(yàn)通過(guò)。
(上面有一個(gè)回車(chē))用戶可以選擇多個(gè)文件,填寫(xiě)表單其它項(xiàng),點(diǎn)擊“提交”按鈕后就開(kāi)始上傳給 http://192.168.29.65/upload_file/UploadFile 這是一個(gè) servelet 程序
注意 enctype="multipart/form-data", method=post, type="file" 。根據(jù) rfc1867, 這三個(gè)屬性是必須的。multipart/form-data 是新增的編碼類(lèi)型,以提高二進(jìn)制文件的傳輸效率。具體的解釋請(qǐng)參閱 rfc1867