Java實現文件上傳

JavaWeb實現文件的上傳(整理自西部開源秦疆老師)

1、准備工作

對於文件上傳，瀏覽器在上傳的過程中是將文件以流的形式提交到服務器端的。

一般采用Apache的開源工具common-fileupload這個文件上傳組件。

common-fileupload是依賴於common-io這個包的，所以還需要下載這個包。

我們下載最新的jar包:

• common-fileupload : 點擊下載

• common-io :點擊下載

在JavaWeb項目中導入Jar包：

2、使用類介紹

【文件上傳注意事項】

1、為保證服務器的安全，上傳的文件應放在外界無法訪問的目錄下，如WEN-INF。

2、為防止同名文件產生覆蓋現象，要為文件指定一個唯一的文件名。

3、要對上傳文件的大小進行限制。

4、限制上傳文件的類型，收到文件時，判斷文件名十分合法。

【需要用到的類詳解】

ServletFileUpload負責處理上傳的文件數據，並將表單中的每個輸入項封裝成一個FileItem對象，在使用ServletFileUpload對象解析請求時需要DiskFileItemFactory對象。所以，我們需要在進行解析工作前構造好DiskFileItemFactory對象，通過ServletFileItem對象的構造方法或setFileItemFactory()設置ServletFileUpload對象的fileItemFactory屬性。

FileItem類

在HTML頁面中必須要有name：<p>上傳文件：<input type="file" name="filename"></p>

表單中如果包含一個文件上傳項的話，這個表單的entype屬性必須設置為multipart/form-data

    <form action="${pageContext.request.contextPath}/upload.do" method="post"enctype="multipart/form-data">
        <p>用戶名：<input type="text" name="username" placeholder="請填寫用戶名"></p>
        <p>上傳文件：<input type="file" name="filename"></p>
        <p><input type="submit" value="提交"><input type="reset" value="重置"></p>

瀏覽器的表單類型為multipart/form-data的話，服務器想獲取數據就要通過流

【常用方法介紹】

//isFormFile方法用於判斷FileItem類對象封裝的數據是一個普通文本表單
//還是一個文件表單，如果時普通表單字段則返回true，否則返回false
boolean isField();

//getFieldName方法用於返回表單標簽name屬性的值
String getFieldName();
//getString方法用於將FileItem對象中保存的數據流內容以一個字符串返回
String getString();

//getName方法用於獲得文件上傳字段中的文件名。
String getName();

//以流的形式返回上傳文件的數據內容。
InputStream getInputStream();

//delete方法用來清空FileItem類對象中存放的主體內容
//如果主體內容被保存在臨時文件中，delete方法將刪除該臨時文件
void delete();

ServletFileUpload類

ServletFileUpload負責處理上傳的文件數據，並將表單中的每個輸入項封裝成一個FileItem對象中，使用其parseRequest(HttpServletRequest)方法可以將通過表單中每一個HTML標簽提交的數據封裝成一個FileItem對象，然后以List列表的形式返回。使用該方法處理上傳文件簡單易用。

3、代碼編寫

UploadFileServlet

package com.yatian.servlet;

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;

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;

public class FileServlet extends HttpServlet {
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws javax.servlet.ServletException, IOException {
        //判斷上傳的表單是普通表單還是帶文件的表單，是返回true,否返回false；
        if (!ServletFileUpload.isMultipartContent(request)){
            return;//如果這是一個普通文件我們直接返回
        }//如果通過了這個if，說明我們的表單是帶文件上傳的

        //創建上傳文件的保存目錄，為了安全建議在WEB-INF目錄下，用戶無法訪問
        String uploadpath = this.getServletContext().getRealPath("WEB-INF/Upload");//獲取上傳文件的保存路徑
        File uploadfile = new File(uploadpath);
        if (!uploadfile.exists()){
            uploadfile.mkdir();//如果目錄不存在就創建這樣一個目錄
        }

        /*//臨時文件
        //臨時路徑，如果上傳的文件超過預期的大小，我們將它存放到一個臨時目錄中，過幾天自動刪除，或者提醒用戶轉存為永久
        String tmppath = this.getServletContext().getRealPath("WEB-INF/tmp");
        File file = new File(tmppath);
        if (!file.exists()){
            file.mkdir();//如果目錄不存在就創建這樣臨時目錄
        }*/
        //處理上傳的文件一般需要通過流來獲取，我們可以通過request.getInputstream(),原生態文件上傳流獲取，十分麻煩
        //但是我們都建議使用Apache的文件上傳組件來實現，common-fileupload,它需要依賴於common-io組件；

        try {
            //1、創建DiskFileItemFactory對象，處理文件上傳路徑或限制文件大小
            DiskFileItemFactory factory = gteDiskFileItemFactory(file);
            //2、獲取ServletFileUpload
            ServletFileUpload upload = getServletFileUpload(factory);
            //3、處理上傳文件
            String msg = uploadParseRequest(upload,request,uploadpath);
            //Servlet請求轉發消息
            request.setAttribute("msg",msg);
            request.getRequestDispatcher("/info.jsp").forward(request,response);
        }catch (FileUploadException e){
            e.printStackTrace();
        }
    }
    public static DiskFileItemFactory gteDiskFileItemFactory(File file){
        //1、創建DiskFileItemFactory對象，處理文件上傳路徑或限制文件大小
        DiskFileItemFactory factory = new DiskFileItemFactory();

        //通過這個工廠設置一個緩沖區，當上傳的文件大小大於緩沖區的時候，將它放到臨時文件中；
        factory.setSizeThreshold(1024 * 1024);//緩沖區大小為1M
        factory.setRepository(file);
        return factory;
    }
    public static ServletFileUpload getServletFileUpload(DiskFileItemFactory factory){
        //2、獲取ServletFileUpload
        ServletFileUpload upload = new ServletFileUpload(factory);
        /*//監聽文件上傳進度
        upload.setProgressListener(new ProgressListener() {
            @Override
            public void update(long pBytesRead, long lpContentLenght, int i) {
                //pBytesRead:已讀取到的文件大小
                //pContentLenght：文件大小
                System.out.println("總大小："+lpContentLenght+"已上傳："+pBytesRead);
            }
        });

        //處理亂碼問題
        upload.setHeaderEncoding("UTF-8");
        //設置單個文件的最大值
        upload.setFileSizeMax(1024 * 1024 * 10);
        //設置總共能夠上傳文件的大小
        //1024 = 1kb * 1024 = 1M * 10 = 10M
        upload.setSizeMax(1024 * 1024 * 10);
        return upload;
    }*/
    public static String uploadParseRequest(ServletFileUpload upload,HttpServletRequest request,String uploadpath) throws IOException, FileUploadException {
        String msg = "";
        //3、處理上傳文件
        //把前端的請求解析，封裝成一個FileItem對象
            List<FileItem> fileItems = upload.parseRequest(request);
            for (FileItem fileItem : fileItems) {
                if (fileItem.isFormField()){ //判斷是普通表單還是帶文件的表單
                    //getFieldName指的是前端表單控件的name
                    String name = fileItem.getFieldName();
                    String value = fileItem.getString("UTF-8");//處理亂碼
                    System.out.println(name+":"+value);
                }else {//判斷它是帶文件的表單

                    //======================處理文件=======================//

                    //拿到文件的名字
                    String uploadFileName = fileItem.getName();
                    System.out.println("上傳的文件名："+uploadFileName);

                    if (uploadFileName.trim().equals("") || uploadFileName == null){
                        continue;
                    }

                    //獲得上傳的文件名，例如/img/girl/ooa.jpg,只需要ooa，其前面的后面的都不需要
                    String fileName = uploadFileName.substring(uploadFileName.lastIndexOf("/") + 1);
                    //獲得文件的后綴名
                    String fileExtName = uploadFileName.substring(uploadFileName.lastIndexOf(".") + 1);
                    /*
                     * 如果后綴名 fileExtName 不是我們需要的
                     *就直接return，不處理，告訴用戶類型不對
                     * */
                    System.out.println("文件信息【文件名："+fileName+"文件類型："+fileExtName+"】");

                    //可以使用UUID(唯一通用識別碼)來保證文件名的統一
                    String uuidFileName = UUID.randomUUID().toString();


                    //=======================傳輸文件=========================//
                    //獲得文件上傳的流
                    InputStream inputStream = fileItem.getInputStream();

                    //創建一個文件輸出流
                    FileOutputStream fos = new FileOutputStream(uploadpath + "/" + uuidFileName +"."+ fileExtName);

                    //創建一個緩沖區
                    byte[] buffer = new byte[1024 * 1024];

                    //判斷是否讀取完畢
                    int len = 0;

                    //如果大於0，說明還存在數據
                    while ((len=inputStream.read(buffer))>0){
                        fos.write(buffer,0,len);
                    }

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

                    msg = "文件上傳成功！";
                    fileItem.delete();//上傳成功，清除臨時文件
                }
            }

        return msg;
    }
}