更新時間:2022年11月25日13時35分 來源:傳智教育 瀏覽次數(shù):
ServletFileUpload類是Apache組件處理文件上傳的核心高級類,通過使用parseRequest(HttpServletRequest)方法可以將HTML中每個表單提交的數(shù)據(jù)封裝成個Fileltem對象,然后以List列表的形式返回。接下來,首先看一下ServletFileUpload類的構造方法如下所示:
ServletFileUpload()
構造一個未初始化的ServletFileUpload實例對象
ServletFileUpload(FileItemFactory fileItemFactory)
根據(jù)參數(shù)指定的FileItemFactory對象創(chuàng)建一個ServletFileUpload對象
由于在文件上傳過程中,F(xiàn)ileltemFactory類必須設置,因此,在使用第一個構造方法創(chuàng)建ServletFileUpload對象時,首先需要在解析請求之前調用setFileltemFactory()方法設置fileltemFactory屬性。
了解了ServletFileUpload對象的創(chuàng)建,接下來,學習一下ServletFileUpload類的方法,具體如下。
1. setSizeMax(long sizeMax)和getSizeMax()方法
setSizeMax()方法繼承自FileUploadBase類,用于設置請求消息實體內容(即所有上數(shù)據(jù))的最大尺寸限制,以防止客戶端惡意上傳超大文件來浪費服務器端的存儲空間。其中,參數(shù)sizeMax以字節(jié)為單位。
另外,對應的getSizeMax()方法用于讀取請求消息實體內容所允許的最大值。
2.setFileSizeMax(long fileSizeMax)方法
setFileSizeMax()方法繼承自FileUploadBase類,用于設置單個上傳文件的最大尺限制,以防止客戶端惡意上傳超大文件來浪費服務器端的存儲空間。其中,參數(shù)fileSizeMax是以字節(jié)為單位。
另外,對應的getFileSizeMax()方法用于獲取單個上傳文件所允許的最大值。
3. parseRequest(javax.servlet.http.HttpServletRequest req)
parseRequest()方法是ServletFileUpload類的重要方法,它是對HTTP請求消息體內容進行解析的入口。它解析出FORM表單中的每個字段的數(shù)據(jù),并將它們分別包裝成獨立的Fileltem對象,然后將這些Fileltem對象加入進一個 List類型的集合對象中返回。
4. getltemlterator(HttpServletRequest request)
getItemIterator()方法和parseRequest()方法基本相同。但是getItemIterator()方法返回的是一個迭代器,該迭代器中保存的不是Fileltem對象,而是FileltemStream對象果希望進一步提高性能,可以采用getItemIterator()方法,直接獲得每一個文件項的數(shù)據(jù)輸人流,做底層處理;如果性能不是問題,希望代碼簡單,則采用parseRequest()方法即可。
5. isMultipartContent(HttpServletRequest req)
isMultipartContent()方法用于判斷請求消息中的內容是否是multipart/form-data類型,如果是,則返回true,否則返回false。需要注意的是,isMultipartContent()方法是靜態(tài)方法,不用創(chuàng)建ServletFileUpload類的實例對象即可被調用。
6. getFileltemFactory()和setFileltemFactory(FileltemFactory factory)
這兩個方法繼承自FileUpload類,分別用于讀取和設置fileltemFactory屬性。
7. setHeaderEncoding(String encoding)方法和getHeaderEncoding()方法
這兩個方法繼承自FileUploadBase類,用于設置和讀取字符編碼。需要注意的是,如果沒有使用setHeaderEncoding()設置字符編碼,則getHeaderEncoding()方法返回null,上傳組件會采用HttDServletRequest設置的字符編碼。但是,如果HttpServletRequest的字符編碼和為null,這時,上傳組件將采用系統(tǒng)默認的字符編碼。獲取系統(tǒng)默認字符編碼的方式如下所示:
System.getProperty("file.encoding")