什麼是檔案上傳?
檔案上傳就是把使用者的資訊儲存起來。
為什麼需要檔案上傳?
在使用者注冊的時候,可能需要使用者送出照片。那麼這張照片就應該要進行儲存。
上傳元件(工具)
為什麼我們要使用上傳工具?
為啥我們需要上傳元件呢?當我們要擷取用戶端的資料,我們一般是通過getParameter()方法來擷取的。
上傳檔案資料是經過MIME協定進行分割的,表單進行了二進制封裝。也就是說:getParameter()無法擷取得到上傳檔案的資料。
我們首先來看看檔案上傳http是怎麼把資料帶過去的
- jsp頁面,表單一定要指定enctype:multipart/form-data
上傳使用者:
上傳檔案1:
上傳檔案2:
- http抓包

這裡寫圖檔描述
- 嘗試在Servlet上使用getParameter()擷取資料
String ss = request.getParameter("username");System.out.println(ss);
- 直接使用getParameter是擷取不到資料的。
這裡寫圖檔描述
那麼我們要怎麼辦呢????request對象提供了ServletInputStream流給我們讀取資料
- 我們試着讀取下檔案
ServletInputStream inputStream = request.getInputStream();byte[] bytes = new byte[1024];int len = 0;while ((len = inputStream.read(bytes)) > 0) { System.out.println(new String(bytes, 0, len));}
- 在jsp頁面多增添一個input控件
- 我上傳的文本檔案内容就是111111,讀取效果如下:
這裡寫圖檔描述
現在我們能夠讀取上傳檔案的資料了,但是現在問題又來了:怎麼把檔案上傳個資料和普通傳送給伺服器的資料分割開來呢???上面在圖上我們已經看到了,他們是混合在一起的。
按我們平常的做法是很難分割開來的,是以我們需要上傳元件
上傳元件有兩種
- FileUpload【操作比較複雜】
- SamrtUpload【操作比較簡單】
FileUpload
要使用FileUpload元件,就需要導入兩個jar包
- commons-io
- Commons-fileupload
開發步驟
- 建立解析器工廠對象【DiskFileItemFactory】
- 通過解析器工廠建立解析器【ServletFileUpload】
- 調用解析器方法解析request對象,得到所有上傳的内容【list】
- 周遊list,判斷每個對象是否是上傳檔案
- 如果是普通表單字段,得到字段名和字段值
- 如果是上傳檔案,調用InputSteam方法得到輸入流,讀取上傳的資料
快速入門
try{ //1.得到解析器工廠 DiskFileItemFactory factory = new DiskFileItemFactory(); //2.得到解析器 ServletFileUpload upload = new ServletFileUpload(factory); //3.判斷上傳表單的類型 if(!upload.isMultipartContent(request)){ //上傳表單為普通表單,則按照傳統方式擷取資料即可 return; } //為上傳表單,則調用解析器解析上傳資料 List list = upload.parseRequest(request); //FileItem //周遊list,得到用于封裝第一個上傳輸入項資料fileItem對象 for(FileItem item : list){ if(item.isFormField()){ //得到的是普通輸入項 String name = item.getFieldName(); //得到輸入項的名稱 String value = item.getString(); System.out.println(name + "=" + value); }else{ //得到上傳輸入項 String filename = item.getName(); //得到上傳檔案名 C:Documents and SettingsThinkPad桌面1.txt filename = filename.substring(filename.lastIndexOf("")+1); InputStream in = item.getInputStream(); //得到上傳資料 int len = 0; byte buffer[]= new byte[1024]; String savepath = this.getServletContext().getRealPath("/upload"); FileOutputStream out = new FileOutputStream(savepath + "" + filename); //向upload目錄中寫入檔案 while((len=in.read(buffer))>0){ out.write(buffer, 0, len); } in.close(); out.close(); } }}catch (Exception e) { e.printStackTrace();}
測試
- 普通的字段和上傳的檔案都能讀取得到了!
這裡寫圖檔描述
SmartUpload
要使用SmartUpload元件,就需要導入smartupload.jar開發包
快速入門
//執行個體化元件SmartUpload smartUpload = new SmartUpload();//初始化上傳操作smartUpload.initialize(this.getServletConfig(), request, response);try { //上傳準備 smartUpload.upload(); //對于普通資料,單純到request對象是無法擷取得到送出參數的。也是需要依賴smartUpload String password = smartUpload.getRequest().getParameter("password"); System.out.println(password); //上傳到uploadFile檔案夾中 smartUpload.save("uploadFile");} catch (SmartUploadException e) { e.printStackTrace();}
測試
同樣地,我們可以上傳檔案到uploadFile檔案夾中。代碼量也的确減少很多!
也能夠擷取普通字段的參數
這裡寫圖檔描述
上傳檔案名的中文亂碼和上傳資料的中文亂碼
- 我把檔案名改成中文,就亂碼了:
這裡寫圖檔描述
- 表單送出過來的中文資料也亂碼了。
這裡寫圖檔描述
上面已經說了,上傳檔案的資料的表單進行了二進制封裝,是以使用request對資料編碼編碼,對于表單送出過來的資料是不奏效的!
FileUpload解決亂碼
使用FileUpload解決亂碼問題是十分簡單的
- 解決中文檔案名亂碼,得到解析器以後,就直接設定解析器的編碼為UTF-8就行了!
//設定upload的編碼 fileUpload.setHeaderEncoding("UTF-8");
- 解決表單資料亂碼,在擷取表單值的時候,按照UTF-8編碼來擷取
String value = fileItem.getString("UTF-8");
效果:
這裡寫圖檔描述
SmartUpload解決亂碼
這個元件解決亂碼問題有點麻煩,在網上找了各種辦法也沒找到簡單的……
是以,如果資料不涉及到中文就使用SmartUpload元件,涉及到中文資料就使用FileUpload元件吧!
多個檔案上傳,動态添加上傳控件
假設我現在有多個檔案要上傳,而且要上傳的個數是不确定的。那麼我們要怎麼辦呢???
我們不可能列出很多很多個上傳檔案的控件在頁面上,這樣不美觀。如果使用者用不到那麼多個控件,也浪費呀。
是以,我們想要動态地增添上傳檔案的控件,如果使用者還想要上傳檔案,隻需要動态地生成控件出來即可!
分析
要想在頁面上動态地生成控件,無非就是使用JavaScript代碼。
那麼我們要怎麼做呢??
這樣子吧:當使用者想要上傳檔案的時候,就點選按鈕,按鈕綁定事件,生成檔案上傳的控件。
為了做得更加完善,每當生成了檔案上傳的控件,也提供一個删除按鈕,删除該控件!
我們應該使用div裝載着我們要生成的控件和删除按鈕,而使用者點選删除的時候,應該是要把删除按鈕和檔案上傳控件都一起隐藏起來的。是以,最好就是使用嵌套div!
代碼
- 頁面代碼:
上傳使用者: |
添加上傳檔案 |
- javaScript代碼
檔案上傳細節
- 如果上傳檔案的大小大于我們設定檔案的大小,那麼檔案在上傳的時候會使用臨時檔案儲存上傳資料。在上傳完畢後,我們應該删除臨時檔案
- 上傳檔案的位置是不能在WEB伺服器管理之下的,否則可能造成安全問題【其他人有可能通過手段來修改上傳檔案】
- 如果上傳檔案名相同,那麼就會把原本的上傳檔案覆寫掉。我們要生成一個獨一無二的檔案名。
- 如果使用者量很大,上傳檔案非常多。那麼我們不應該在一個目錄儲存所有的上傳檔案,這樣很可能造成磁盤奔潰了。是以我們要把上傳的檔案打散到不同的目錄下。
分析
删除臨時檔案問題是非常簡單的,隻需要在所有的操作完畢之後,調用FileItem的delete()方法即可
讓上傳檔案的位置不能在WEB伺服器管理之下,我們把上傳檔案的位置放到WEB-INF/目錄下即可!
檔案名相同的問題,我們可以使用UUID+使用者上傳的檔案名來作為我們儲存上傳檔案名。這樣的檔案名就是獨一無二的了。
要将上傳的檔案進行打散,那麼我們需要使用HashCode算法來進行打散。
- 低四位生成一級目錄
- 5-8位生成二級目錄
代碼
下面我們寫一個比較完善的上傳檔案代碼
- 使用hashCode算法來打散儲存的目錄
private String makeDirPath(String fileName, String path) { //通過檔案名來算出一級目錄和二級目錄 int hashCode = fileName.hashCode(); int dir1 = hashCode & 0xf; int dir2 = (hashCode & 0xf0) >> 4; String dir = path + "" + dir1 + "" + dir2; //如果該目錄不存在,就建立目錄 File file = new File(dir); if (!file.exists()) { file.mkdirs(); } //傳回全路徑 return dir;}
- 生成獨一無二的檔案名
private String makeFileName(String fileName) { //使用下劃線把UUID和檔案名分割開來,後面可能會解析檔案名的。 return UUID.randomUUID().toString() + "_"+ fileName;}
- 上傳的代碼
//建立工廠DiskFileItemFactory factory = new DiskFileItemFactory();//通過工廠建立解析器ServletFileUpload fileUpload = new ServletFileUpload(factory);//設定upload的編碼fileUpload.setHeaderEncoding("UTF-8");//判斷上傳表單的類型if(!fileUpload.isMultipartContent(request)){ //上傳表單為普通表單,則按照傳統方式擷取資料即可 return;}try { //解析request對象,得到List【裝載着上傳的全部内容】 List list = fileUpload.parseRequest(request); //周遊List,判斷裝載的内容是普通字段還是上傳檔案 for (FileItem fileItem : list) { //如果是普通輸入項 if (fileItem.isFormField()) { //得到輸入項的名稱和值 String name = fileItem.getFieldName(); String value = fileItem.getString("UTF-8"); System.out.println(name + " = " + value); } else { //如果是上傳檔案 //得到上傳名稱【包括路徑名】 String fileName = fileItem.getName(); //截取檔案名 fileName = fileName.substring(fileName.lastIndexOf("") + 1); //生成獨一無二的檔案名 fileName = makeFileName(fileName); InputStream inputStream = fileItem.getInputStream(); //得到項目的路徑,把上傳檔案寫到項目中 String path = this.getServletContext().getRealPath("/WEB-INF/uploadFile"); //得到分散後的目錄路徑 String realPath = makeDirPath(fileName, path); FileOutputStream outputStream = new FileOutputStream(realPath + "" + fileName); byte[] bytes = new byte[1024]; int len = 0; while ((len = inputStream.read(bytes)) > 0) { outputStream.write(bytes, 0, len); } inputStream.close(); outputStream.close(); //删除臨時檔案的資料 fileItem.delete(); } }} catch (FileUploadException e) { e.printStackTrace();}
效果:
- 成功把目錄打散,檔案名也是獨一無二的了。
這裡寫圖檔描述
列出上傳目錄下的檔案,提供下載下傳
在講解respose對象的時候已經講解過檔案下載下傳了。這次我們就直接寫一個小案例來鞏固檔案下載下傳把。
- 上傳目錄下的檔案有3個
這裡寫圖檔描述
分析
首先,要把目錄下的檔案都列出來。由于後面要根據檔案名對檔案進行下載下傳,是以我們用一個Map集合來儲存所有的檔案
下載下傳檔案部分也很簡單,根據檔案名和上傳檔案位置找到對應的檔案,對其進行讀寫,然後修改消息頭實作下載下傳就好了。
- 得到裝載上傳檔案的路徑,通過遞歸把所有的檔案都查找出來(判斷是否是檔案就是遞歸出口),裝載到Map集合中
- 将Map集合傳到前台做展示
- 使用者點選下載下傳的時候,再根據原名來擷取絕對路徑
- 如果該資源是存在的,就允許使用者下載下傳
代碼
- 将存放在WEB-INF/目錄下的檔案全部放在Map集合中
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { //得到上傳檔案的目錄 String filePath = this.getServletContext().getRealPath("/WEB-INF/uploadFile"); Map map = new HashMap(); //使用遞歸來得到所有的檔案,并添加到Map集合中 getAllFiles(new File(filePath), map); request.setAttribute("map