Apache FileUpload 文件上傳組件API解讀-2

2019-11-11 05:04:16

字體：大中小

供稿：網(wǎng)友

1.RFC1867協(xié)議

最初的 http 協(xié)議中，沒(méi)有上傳文件方面的功能。RFC1867（"Form-based File Upload in HTML".）

為 http 協(xié)議添加了這個(gè)功能。客戶端的瀏覽器，如 Microsoft IE, Mozila, Opera 等，按照此規(guī)范將用戶指定的文件發(fā)送到服務(wù)器。服務(wù)器端的網(wǎng)頁(yè)程序，如 php, asp, jsp 等，可以按照此規(guī)范，解析出用戶發(fā)送來(lái)的文件。

2.1客戶端

簡(jiǎn)單來(lái)說(shuō)，RFC1867規(guī)范要求http協(xié)議增加了file類型的input標(biāo)簽，用于瀏覽需要上傳的文件。同時(shí)要求FORM表單的enctype屬性設(shè)置為“multipart/form-data”，method屬性設(shè)置為“post”即可，下面是我們文件上傳頁(yè)面的表單代碼：

<form action="<%=request.getContextPath()%>/servlet/SimpleUpload" enctype="multipart/form-data" method="post">

文本1：<input type="text" name="text1" value="文本1"><br>

文件2：<input type="text" name="text2" value="文本2"><br>

文件1：<input type="file" name="file1"><br>

文件2：<input type="file" name="file2"><br>

文件2：<input type="file" name="file3"><br>

</form>

2.2 服務(wù)器端

一個(gè)文件上傳請(qǐng)求的消息實(shí)體由一系列根據(jù) RFC1867（"Form-based File Upload in HTML".）編碼的項(xiàng)目（文本參數(shù)和文件參數(shù)）組成。自己編程來(lái)解析獲取這些數(shù)據(jù)是非常麻煩的，還需要了解RFC1867規(guī)范對(duì)請(qǐng)求數(shù)據(jù)編碼的相關(guān)知識(shí)。FileUpload 可以幫助我們解析這樣的請(qǐng)求，將每一個(gè)項(xiàng)目封裝成一個(gè)實(shí)現(xiàn)了FileItem接口的對(duì)象，并以列表的形式返回。所以，我們只需要了解FileUpload的API如何使用即可，不用管它們的底層實(shí)現(xiàn)。讓我們來(lái)看一個(gè)簡(jiǎn)單文件上傳處理代碼：

DiskFileItemFactory factory = new DiskFileItemFactory();

ServletFileUpload uploader = new ServletFileUpload(factory);

List<FileItem> list = uploader.parseRequest(request);

if (item.isFormField()){

// 處理普通表單域

String field = item.getFieldName();//表單域名

String value = item.getString("GBK");

} else {

//將臨時(shí)文件保存到指定目錄

String fileName = item.getName();//文件名稱

String filepath = "您希望保存的目錄/" + fileName;

item.write(new File(filepath));//執(zhí)行保存

}

怎么樣？簡(jiǎn)單吧！下面我們來(lái)繼續(xù)了解一些必須了解的API。

FileItem接口

org.apache.commons.fileupload.disk.DiskFileItem實(shí)現(xiàn)了FileItem接口，用來(lái)封裝單個(gè)表單字段元素的數(shù)據(jù)。通過(guò)調(diào)用FileItem 定義的方法可以獲得相關(guān)表單字段元素的數(shù)據(jù)。我們不需要關(guān)心DiskFileItem的具體實(shí)現(xiàn)，在程序中可以采用FileItem接口類型來(lái)對(duì)DiskFileItem對(duì)象進(jìn)行引用和訪問(wèn)。FileItem類還實(shí)現(xiàn)了Serializable接口，以支持序列化操作。

下圖是一個(gè)文件上傳表單：

...............

上圖表單提交的http數(shù)據(jù)包的內(nèi)容：

POST /demo/servlet/SimpleUpload HTTP/1.1

Accept: image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/x-shockwave-Flash, application/msWord, application/vnd.ms-Excel, application/vnd.ms-Powerpoint, */*

Referer: http://127.0.0.1:8080/demo/simpleUpload.jsp

Accept-Language: zh-cn

Content-Type: multipart/form-data; boundary=---------------------------7da1772c5504c6

UA-CPU: x86

Accept-Encoding: gzip, deflate

User-Agent: Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; .NET CLR 2.0.50727)

Host: 127.0.0.1:8080

Content-Length: 184423

Connection: Keep-Alive

Cache-Control: no-cache

Cookie: JsessionID=BD8E58E5BAD9B559C0262077FB5E0B4E