什么是ServletFileUpload類方法

ServletFileUpload類

ServletFileUpload類是Apache組件處理文件上傳的核心高級類，通過使用parseRequest(HttpServletRequest)方法可以將HTML中每個表單提交的數(shù)據(jù)封裝成個Fileltem對象，然后以List列表的形式返回。接下來，首先看一下ServletFileUpload類的構(gòu)造方法如下所示：

ServletFileUpload()

構(gòu)造一個未初始化的ServletFileUpload實例對象

ServletFileUpload(FileItemFactory fileItemFactory)

根據(jù)參數(shù)指定的FileItemFactory對象創(chuàng)建一個ServletFileUpload對象

由于在文件上傳過程中，F(xiàn)ileltemFactory類必須設(shè)置，因此，在使用第一個構(gòu)造方法創(chuàng)建ServletFileUpload對象時，首先需要在解析請求之前調(diào)用setFileltemFactory()方法設(shè)置fileltemFactory屬性。

了解了ServletFileUpload對象的創(chuàng)建，接下來，學(xué)習(xí)一下ServletFileUpload類的方法，具體如下。

1. setSizeMax(long sizeMax)和getSizeMax()方法

setSizeMax()方法繼承自FileUploadBase類，用于設(shè)置請求消息實體內(nèi)容(即所有上數(shù)據(jù))的最大尺寸限制，以防止客戶端惡意上傳超大文件來浪費服務(wù)器端的存儲空間。其中，參數(shù)sizeMax以字節(jié)為單位。

另外，對應(yīng)的getSizeMax()方法用于讀取請求消息實體內(nèi)容所允許的最大值。

2.setFileSizeMax(long fileSizeMax)方法

setFileSizeMax()方法繼承自FileUploadBase類，用于設(shè)置單個上傳文件的最大尺限制，以防止客戶端惡意上傳超大文件來浪費服務(wù)器端的存儲空間。其中，參數(shù)fileSizeMax是以字節(jié)為單位。

另外，對應(yīng)的getFileSizeMax()方法用于獲取單個上傳文件所允許的最大值。

3. parseRequest(javax.servlet.http.HttpServletRequest req)

parseRequest()方法是ServletFileUpload類的重要方法，它是對HTTP請求消息體內(nèi)容進行解析的入口。它解析出FORM表單中的每個字段的數(shù)據(jù)，并將它們分別包裝成獨立的Fileltem對象，然后將這些Fileltem對象加入進一個 List類型的集合對象中返回。

4. getltemlterator(HttpServletRequest request)

getItemIterator()方法和parseRequest()方法基本相同。但是getItemIterator()方法返回的是一個迭代器，該迭代器中保存的不是Fileltem對象，而是FileltemStream對象果希望進一步提高性能，可以采用getItemIterator()方法，直接獲得每一個文件項的數(shù)據(jù)輸人流，做底層處理;如果性能不是問題，希望代碼簡單，則采用parseRequest()方法即可。

5. isMultipartContent(HttpServletRequest req)

isMultipartContent()方法用于判斷請求消息中的內(nèi)容是否是multipart/form-data類型，如果是，則返回true，否則返回false。需要注意的是，isMultipartContent()方法是靜態(tài)方法，不用創(chuàng)建ServletFileUpload類的實例對象即可被調(diào)用。

6. getFileltemFactory()和setFileltemFactory(FileltemFactory factory)

這兩個方法繼承自FileUpload類，分別用于讀取和設(shè)置fileltemFactory屬性。

7. setHeaderEncoding(String encoding)方法和getHeaderEncoding()方法

這兩個方法繼承自FileUploadBase類，用于設(shè)置和讀取字符編碼。需要注意的是，如果沒有使用setHeaderEncoding()設(shè)置字符編碼，則getHeaderEncoding()方法返回null，上傳組件會采用HttDServletRequest設(shè)置的字符編碼。但是，如果HttpServletRequest的字符編碼和為null，這時，上傳組件將采用系統(tǒng)默認的字符編碼。獲取系統(tǒng)默認字符編碼的方式如下所示：

System.getProperty("file.encoding")