什麼是文件上傳？文件上傳就是把用戶的信息保存起來。為什麼需要文件上傳？在用戶註冊的時候，可能需要用戶提交照片。那麼這張照片就應該要進行保存。上傳組件(工具) 為什麼我們要使用上傳工具？為啥我們需要上傳組件呢？當我們要獲取客戶端的數據，我們一般是通過getParameter()方法來獲取的。 ...

什麼是文件上傳？

文件上傳就是把用戶的信息保存起來。

為什麼需要文件上傳？

在用戶註冊的時候，可能需要用戶提交照片。那麼這張照片就應該要進行保存。

上傳組件(工具)

為什麼我們要使用上傳工具？

為啥我們需要上傳組件呢？當我們要獲取客戶端的數據，我們一般是通過getParameter()方法來獲取的。

上傳文件數據是經過MIME協議進行分割的，表單進行了二進位封裝。也就是說：getParameter()無法獲取得到上傳文件的數據。

我們首先來看看文件上傳http是怎麼把數據帶過去的

jsp頁面，表單一定要指定enctype:multipart/form-data


    <form action="${pageContext.request.contextPath }/servlet/UploadServlet1" enctype="multipart/form-data" method="post">
        上傳用戶：<input type="text" name="username"><br/>
        上傳文件1：<input type="file" name="file1"><br/>
        上傳文件2：<input type="file" name="file2"><br/>
        <input type="submit" value="提交">
    </form>

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控制項


<input type="text" name="password">

我上傳的文本文件內容就是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<FileItem> 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 Settings\ThinkPad\桌面\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！

代碼

頁面代碼：



<table border="1px">

    <tr>
        <td>上傳用戶：</td>
        <td><input type="text" name="username"></td>
    </tr>

    <tr>
        <td>添加上傳文件</td>
        <td><input type="button" value="添加上傳文件" onclick="addUploadFile()"> </td>
    </tr>

    <tr>

        <td>
            <div id="file">
            </div>
        </td>
    </tr>

</table>

javaScript代碼


    <script type="text/javascript">

        function addUploadFile() {

            //生成文件上傳控制項
            var input = document.createElement("input");
            input.type = 'file';
            input.name = 'fileName';


            //生成刪除按鈕
            var del = document.createElement("input");
            del.type = 'button';
            del.value = '刪除';

            //生成內部的div
            var innerDiv = document.createElement("div");

            //將兩個控制項綁定到內部div上
            innerDiv.appendChild(input);
            innerDiv.appendChild(del);

            //得到外部div控制項，並將內部div綁定到外部div上
            var outterDiv = document.getElementById("file");
            outterDiv.appendChild(innerDiv);

            //為刪除按鈕綁定事件
            del.onclick = function dele() {

                //調用外界div的remove方法把內部的div幹掉
                this.parentNode.parentNode.removeChild(this.parentNode);
            }

        }

    </script>

文件上傳細節

如果上傳文件的大小大於我們設定文件的大小，那麼文件在上傳的時候會使用臨時文件保存上傳數據。在上傳完畢後，我們應該刪除臨時文件
上傳文件的位置是不能在WEB伺服器管理之下的，否則可能造成安全問題【其他人有可能通過手段來修改上傳文件】
如果上傳文件名相同，那麼就會把原本的上傳文件覆蓋掉。我們要生成一個獨一無二的文件名。
如果用戶量很大，上傳文件非常多。那麼我們不應該在一個目錄保存所有的上傳文件，這樣很可能造成磁碟奔潰了。所以我們要把上傳的文件打散到不同的目錄下。

分析

刪除臨時文件問題是非常簡單的，只需要在所有的操作完畢之後，調用FileItem的delete()方法即可

讓上傳文件的位置不能在WEB伺服器管理之下，我們把上傳文件的位置放到WEB-INF/目錄下即可！

文件名相同的問題，我們可以使用UUID+用戶上傳的文件名來作為我們保存上傳文件名。這樣的文件名就是獨一無二的了。

要將上傳的文件進行打散，那麼我們需要使用HashCode演算法來進行打散。

代碼

下麵我們寫一個比較完善的上傳文件代碼

使用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<FileItem> 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對象的時候已經講解過文件下載了。這次我們就直接寫一個小案例來鞏固文件下載把。

這裡寫圖片描述

分析

首先，要把目錄下的文件都列出來。由於後面要根據文件名對文件進行下載，所以我們用一個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", map);
        request.getRequestDispatcher("/listFile.jsp").forward(request, response);



    }

    private void getAllFiles(File filePath, Map map) {

        //如果不是文件，那麼它就是文件夾
        if (!filePath.isFile()) {

            //列出文件夾下所有的文件（可能是文件，可能是文件夾）
            File[] files = filePath.listFiles();
            for (File file : files) {

                //得到的文件（或者是文件夾）再對其進行判斷
                getAllFiles(file, map);
            }
        } else {
            //進入到else語句了，肯定是文件了

            //得到文件名
            String fileName = filePath.getName().substring(filePath.getName().lastIndexOf("_") + 1);

            //我們將文件全名作為key，文件名作為value保存在map集合中
            map.put(filePath.getName(), fileName);

        }

    }

在JSP頁面中顯示可以下載的文件




<c:forEach items="${map}" var="me">

    <c:url var="url" value="/DownFileServlet">
        <c:param name="fileName" value="${me.key}"></c:param>
    </c:url>
    ${me.value}<a href="${url}">下載！</a><br>

</c:forEach>

實現下載的Servlet

    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

        //得到文件的全名
        String fileName = request.getParameter("fileName");

        //如果是中文數據，需要轉碼。
        fileName = new String(fileName.getBytes("ISO8859-1"), "utf-8");

        //得到保存文件的位置
        String path = this.getServletContext().getRealPath("/WEB-INF/uploadFile");

        //文件是通過文件名進行hashCode打散保存的，通過文件名拿到文件絕對路徑
        String fileRealPath = makeFilePath(fileName, path);
        System.out.println(fileRealPath);

        //判斷文件是否存在
        File file = new File(fileRealPath);
        if (!file.exists()) {
            request.setAttribute("message", "您要下載的資源不存在了！");
            request.getRequestDispatcher("/message.jsp").forward(request, response);
            return ;
        }

        //存在

        //讀取該文件並把數據寫給瀏覽器
        FileInputStream inputStream = new FileInputStream(fileRealPath);
        byte[] bytes = new byte[1024];
        int len = 0;
        while ((len = inputStream.read(bytes)) > 0) {
            response.getOutputStream().write(bytes, 0, len);
        }

        inputStream.close();


        //設置消息頭，告訴瀏覽器，這是下載的文件
        String name = fileName.substring(fileName.lastIndexOf("_") + 1);
        response.setHeader("content-disposition","attachment;filename=" + URLEncoder.encode(name, "UTF-8"));

    }

    private String makeFilePath(String fileName, String path) {

        int hashCode = fileName.hashCode();

        int dir1 = hashCode & 0xf;
        int dir2 = (hashCode & 0xf0) >> 4;

        String dir = path + "\\" + dir1 + "\\" + dir2 +"\\"+ fileName;
        return dir;
    }

效果

這裡寫圖片描述

如果文章有錯的地方歡迎指正，大家互相交流。習慣在微信看技術文章的同學，可以關註微信公眾號:Java3y

Java文件上傳細講

什麼是文件上傳？

為什麼需要文件上傳？

上傳組件(工具)

為什麼我們要使用上傳工具？

上傳組件有兩種

FileUpload

開發步驟

快速入門

測試

SmartUpload

快速入門

測試

上傳文件名的中文亂碼和上傳數據的中文亂碼

FileUpload解決亂碼

效果：

SmartUpload解決亂碼

多個文件上傳，動態添加上傳控制項

分析

代碼

文件上傳細節

分析

代碼

效果：

列出上傳目錄下的文件，提供下載

分析

代碼

效果