Servlet-文件上傳的代碼實現

文件上傳

對於文件上傳,都不陌生,但是一寫代碼,博主感覺也很迷,因爲文件上傳的原理過程確實太複雜了,我們一般使用第三方提供的方法來實現。

鑑於原生的文件上傳真的太難了,所以Apache提供了處理文件上傳的jar包(按照以往的習慣,還是提供了Maven倉庫的地址,需要者可以自己去下載)。

博主這裏就直接使用Maven依賴了:

<dependency>
  <groupId>commons-io</groupId>
  <artifactId>commons-io</artifactId>
  <version>2.6</version>
</dependency>

<dependency>
  <groupId>commons-fileupload</groupId>
  <artifactId>commons-fileupload</artifactId>
  <version>1.4</version>
</dependency>

首先,文件上傳一定得需要表單頁面吧,原生頁面,別嫌棄low哈

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>文件上傳</title>
</head>
<body>
<form action="${pageContext.request.contextPath}/upload.do" method="post" enctype="multipart/form-data">
    用戶名:<input type="text" name="username"/><br>
    文件:<input type="file" name="fileName"/><br>
    <input type="submit" value="提交">
</form>
</body>
</html>

上傳文件的表單一定要注意,表單提交方式一定要是post方式,而且一定要設置enctype="multipart/form-data",否則會失敗。

提供處理上傳文件的Servlet:

package cn.ara.servlet;

import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.FileUploadException;
import org.apache.commons.fileupload.ProgressListener;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;
import java.util.UUID;

public class FileServlet extends HttpServlet {
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

        //判斷上傳的表單是普通表單還是文件表單
        if (!ServletFileUpload.isMultipartContent(request)) {
            return;//是一個普通的表單
        }

        try {

            //創建上傳文件的保存路徑,直接放在WEB-INF路徑下,安全,用戶無法直接訪問
            String uploadPath = this.getServletContext().getRealPath("/WEB-INF/upload");
            File uploadFile = new File(uploadPath);
            if (!uploadFile.exists()) {
                uploadFile.mkdir();//不存在該文件夾就創建
                //打印絕對路徑
                System.out.println(uploadFile.getAbsolutePath());
            }

            //緩存 臨時文件
            //臨時路徑 如果文件超出預定的大小 就將它放到一個臨時的文件中 一段時間後自動刪除
            String tempPath = this.getServletContext().getRealPath("/WEB-INF/temp");
            File tempFile = new File(tempPath);
            if (!tempFile.exists()) {
                tempFile.mkdir();//不存在該文件夾就創建
                //打印絕對路徑
                System.out.println(tempFile.getAbsolutePath());
            }

            //處理上傳的文件,一般都需要通過流來獲取,可以使用request. getInputStream(),原生態的文件上:傳流獲取,十分麻煩
            //我們一般都建議使用Apache的文件上傳組件來實現,common-fileupload, 它需要依賴於commons- io組件

            /*

            在使用ServletFileUpload對象解析請求時需要DiskFileItemFactory對象。
            所以,我們需要在進行解析工作前構造DiskFileItemFactory對象,
            通過ServletFileUpload,對象的構造方法或setFileItemFactory()方法沒置ServLetFileUpload對象的fileItemFactory屬性。
            */


            //1.創建DiskFileItemFactory對象,處理文件上: 傳路徑或者大小限制的;
            DiskFileItemFactory factory = new DiskFileItemFactory();
            //通過這個工廠設置一個緩衝區,當上:傳的文件大於這個緩衝區的時候,將他放到臨時文件中;
            factory.setSizeThreshold(1024 * 1024); //緩存區大小爲1M
            factory.setRepository(tempFile);//臨時目錄的保存目錄,需要一個File

            //2.獲取ServletFileUpload ServletFileUpload負責處理上傳的文件數據,並將表單中每個輸入項封裝成一個FileItem對象
            ServletFileUpload upload = new ServletFileUpload(factory);

            //監聽文件上傳進度 可以參考實現文件上傳時的進度條
            upload.setProgressListener(new ProgressListener() {
                @Override
                //pBytesRead:已經讀取到的文件大樸
                //pContentLength :文件 大樸
                public void update(long pBytesRead, long pContentLength, int pItems) {
                    //總大小 pContentLength
                    //已上傳大小 pBytesRead
                    System.out.println("已上傳: " + (pBytesRead*100) /pContentLength + "%");
                }
            });
            //處理亂碼問題
            upload.setHeaderEncoding("UTF-8");
            //1024=1kb*1024=1M*10=10M
            //設置單個文件的最大值
            upload.setFileSizeMax(1024 * 1024 * 10);
            //設置總共能夠上傳文件的大小            
            upload.setSizeMax(1024 * 1024 * 10);

            //3.處理上傳的文件
            //解析前端請求,把表單中的每一個輸入項封裝成一個個的FileItem
            List<FileItem> fileItems = upload.parseRequest(request);

            //遍歷單個FileItem
            for (FileItem fileItem : fileItems) {

                //判斷輸入項是一個普通輸入項還是帶文件的輸入項
                if (fileItem.isFormField()) {
                    //是一個普通表單
                    String name = fileItem.getFieldName();
                    String value = fileItem.getString("UTF-8");
                    System.out.println(name + ":" + value);

                } else {
                    //是一個文件輸入項

                    //============= 處理文件 開始 ===============
                    //獲取上傳的帶路徑的文件名
                    String uploadFileName = fileItem.getName();
                    //如果文件名爲空或者文件名不合法 則捨棄這個輸入項
                    if (uploadFileName == null || uploadFileName.trim().equals("")) {
                        continue;
                    }
                    //獲得上傳的文件名
                    String fileName = uploadFileName.substring(uploadFileName.lastIndexOf("/") + 1);
                    //獲得文件的後綴名
                    String fileNameSuffix = uploadFileName.substring(uploadFileName.lastIndexOf(".") + 1);

                    System.out.println("文件信息[文件名:" + fileName + ", 文件類型:" + fileNameSuffix + "]");

                    //============= 處理文件 結束 ===============

                    //============= 存放地址 開始 ===============
                    //使用UUID保證文件夾名的唯一 一個文件對應一個UUID的文件夾
                    String uuidPath = UUID.randomUUID().toString();
                    String relPath = uploadPath + "/" + uuidPath;
                    File relPathFile = new File(relPath);
                    if (!relPathFile.exists()) {
                        relPathFile.mkdir();
                    }

                    //============= 存放地址 結束 ===============


                    //============= 文件傳輸 開始 ===============
                    //獲取輸入項中的流
                    InputStream inputStream = fileItem.getInputStream();

                    //創建一個輸出流
                    FileOutputStream fileOutputStream = new FileOutputStream(relPath + "/" + fileName);

                    //緩衝區
                    byte[] buffer = new byte[1024 * 1024];

                    int len = 0;
                    while ((len = inputStream.read(buffer)) > 0) {
                        fileOutputStream.write(buffer, 0, len);
                    }

                    //============= 文件傳輸 結束 ===============

                    //關閉流
                    fileOutputStream.close();
                    inputStream.close();

                    //刪除臨時文件
                    fileItem.delete();
                }

            }

        } catch (FileUploadException e) {
            e.printStackTrace();
        }

        //響應客戶端
        response.getWriter().write("OK!");

    }

}

配置好Servlet之後,提交就可以發現上傳的文件被存放到控制檯打印的地址了。

在這裏插入圖片描述
在這裏插入圖片描述
文件上傳就實現成功了。


文件上傳有幾個注意點:

  • 爲了保證上傳文件的安全,上傳的文件一般保存在外界無法直接訪問的目錄下。
  • 爲了防止文件的重複,應該爲上傳的文件提供一個唯一的文件名。
  • 爲了節省服務器的內存資源,上傳的文件通常會限制大小。
  • 爲了上傳文件的合法性,一般會通過後綴名限制文件上傳的類型。

一般實際操作就視實際情況而定,博主這裏沒有限制文件上傳的類型,僅供參考。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章