javaee-文件上傳加載

參考原文地址

文件上傳

文件上傳前的準(zhǔn)備

  1. 在表單中必須有一個(gè)上傳的控件
    <input type="file" name="testImg"/>
  2. 因?yàn)?GET 方式有請(qǐng)求大小的限制，所以表單的提交方式必須是 POST
    <form action="/upload" method="post">
  3. 表單默認(rèn)的編碼方式為 application/x-www-form-urlencoded ，應(yīng)該修改為 multipart/form-data ，以二進(jìn)制的形式進(jìn)行數(shù)據(jù)的傳輸
    <form action="/upload" method="post" enctype="multipart/form-data">
  • 注意：此時(shí) Servlet 中就不能再使用 request對(duì)象.getParameter(String name) 來獲取請(qǐng)求參數(shù)
image.png

上傳組件

要實(shí)現(xiàn)文件的上傳，需要基于以下兩種組件的一種：

  • Apache FileUpload 組件【操作比較復(fù)雜】
  • SmartUpload 組件【操作比較簡單，但存在一些問題】

基于 FileUpload 組件

使用基于Apache FileUpload上傳組件實(shí)現(xiàn)文件的上傳，步驟：

  1. 將必要的 jar 包導(dǎo)入到項(xiàng)目中
    commons-fileupload-1.2.2.jar
    commons-io-1.4.jar
  2. 簡單寫好 upload.jsp 上傳頁面：
<!DOCTYPE html>
<%@ page language="java" contentType="text/html; charset=UTF-8"
         pageEncoding="UTF-8" import="java.util.*" %>
<html>
<head>
    <title>文件的上傳和下載</title>
</head>
<body>

文件上傳：
<form action="/upload" method="post" enctype="multipart/form-data">
    <input type="file" name="testImg"/> <br>
    <input type="submit"/>
</form>

</body>
</html>
image.png
  1. 編寫 UploadServlet 處理相關(guān)請(qǐng)求：
package servlet;

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

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.File;
import java.io.IOException;
import java.util.List;

@WebServlet("/upload")
public class UploadServlet extends HttpServlet {

    protected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        // 驗(yàn)證請(qǐng)求是否滿足要求（post 請(qǐng)求 / enctype 是否以multipart打頭
        boolean isMultipart = ServletFileUpload.isMultipartContent(req);
        // 如果不滿足要求就立即結(jié)束對(duì)該請(qǐng)求的處理
        if (!isMultipart) {
            return;
        }

        try {
            // FileItem 是表單中的每一個(gè)元素的封裝
            // 創(chuàng)建一個(gè) FileItem 的工廠類
            FileItemFactory factory = new DiskFileItemFactory();
            // 創(chuàng)建一個(gè)文件上傳處理器（裝飾設(shè)計(jì)模式）
            ServletFileUpload upload = new ServletFileUpload(factory);
            // 解析請(qǐng)求
            List<FileItem> items = upload.parseRequest(req);
            for (FileItem fileItem :
                    items) {
                // 判斷空間是否是普通控件
                if (fileItem.isFormField()) {
                    // 普通控件
                } else {
                    // 上傳控件
                    // 將上傳的文件保存到服務(wù)器
                    fileItem.write(new File("C:/", "testImg.jpg"));
                }
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

文件上傳的細(xì)節(jié)

上面已經(jīng)能實(shí)現(xiàn)簡單的文件上傳功能了，但文件上傳有很多需要注意的地方。

  • 緩存大小和臨時(shí)目錄
    在上傳文件的時(shí)候,如果文件過大,而且是將文件放在緩存中,就可能造成內(nèi)存溢出
    默認(rèn)的緩存大小為 10 kb，臨時(shí)目錄的默認(rèn)值為 tomcat/temp
  • 解決方案：將操作緩存大小的文件放在服務(wù)器的磁盤(臨時(shí)目錄)中,在文件的大小超過設(shè)定的緩存大小的時(shí)候就會(huì)使用到臨時(shí)目錄
// 設(shè)置緩存大小 500kb
factory.setSizeThreshold(1024*500);
// 設(shè)置臨時(shí)目錄
factory.setRepository(new File("C:/"));
  • 通常不需要設(shè)置

另一個(gè)問題是：如果用戶 A 上傳了一個(gè)文件名叫xxx，用戶 B 也上傳了一個(gè)文件名叫 xxx，那么此時(shí)用戶 B 的文件會(huì)把用戶 A 的文件給覆蓋掉。

  • 文件名稱的處理
    相同文件名稱的文件，后面的文件會(huì)把前面的文件覆蓋掉
  • 解決方案：使用UUID來生成一個(gè)隨機(jī)的而且不重復(fù)字符串作為文件的名稱，獲取真實(shí)文件的后綴名需要用到 FilenameUtils 這個(gè)工具類
  • 語法：
String fileName = UUID.randomUUID().toString()+"."+FilenameUtils.getExtension(fileItem.getName());

文件類型的約束

上傳文件的類型應(yīng)該需要做一些約束的，比如在上傳頭像的時(shí)候就只允許上傳圖片，其他類型的文件都不應(yīng)該允許上傳，并且如果類型不正確的時(shí)候，應(yīng)該給用戶一個(gè)錯(cuò)誤的提示。

  • jsp 文件增加顯示錯(cuò)誤提示信息：
    我們給我們的 jsp 開頭增加一個(gè) <span> 來顯示錯(cuò)誤信息
<!DOCTYPE html>
<%@ page language="java" contentType="text/html; charset=UTF-8"
         pageEncoding="UTF-8" import="java.util.*" %>
<html>
<head>
    <title>文件的上傳和下載</title>
</head>
<body>

文件上傳：<span>${errorMsg}</span>
<form action="/upload" method="post" enctype="multipart/form-data">
    <input type="file" name="testImg"/> <br>
    <input type="submit"/>
</form>

</body>
</html>
  • 判斷上傳文件類型：
    限制文件類型那么就需要對(duì)文件類型進(jìn)行判斷
  • 語法：String contentType = fileItem.getContentType();
  • Servlet 源碼：
package servlet;

import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.FileItemFactory;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;
import org.apache.commons.io.FilenameUtils;

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

@WebServlet("/upload")
public class UploadServlet extends HttpServlet {

    protected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        // 驗(yàn)證請(qǐng)求是否滿足要求（post 請(qǐng)求 / enctype 是否以multipart打頭
        boolean isMultipart = ServletFileUpload.isMultipartContent(req);
        // 如果不滿足要求就立即結(jié)束對(duì)該請(qǐng)求的處理
        if (!isMultipart) {
            return;
        }

        try {
            // FileItem 是表單中的每一個(gè)元素的封裝
            // 創(chuàng)建一個(gè) FileItem 的工廠類
            FileItemFactory factory = new DiskFileItemFactory();
            // 創(chuàng)建一個(gè)文件上傳處理器（裝飾設(shè)計(jì)模式）
            ServletFileUpload upload = new ServletFileUpload(factory);
            // 解析請(qǐng)求
            List<FileItem> items = upload.parseRequest(req);
            for (FileItem fileItem :
                    items) {
                // 判斷空間是否是普通控件
                if (fileItem.isFormField()) {
                    // 普通控件
                } else {
                    // 上傳控件
                    String contentType = fileItem.getContentType();
                    if (!contentType.startsWith("image/")) {
                        // 實(shí)現(xiàn)簡單的錯(cuò)誤提示
                        req.setAttribute("errorMsg", "親，您上傳的文件格式不正確，請(qǐng)重新上傳！");
                        req.getRequestDispatcher("upload.jsp").forward(req, resp);
                        return;  // 如果不是圖片類型則不再對(duì)請(qǐng)求進(jìn)行處理
                    }
                    // 隨機(jī)命名文件名
                    String fileName = UUID.randomUUID().toString() + "." + FilenameUtils.getExtension(fileItem.getName());
                    // 將上傳的文件保存到服務(wù)器
                    fileItem.write(new File("C:/", fileName));
                }
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

解決中文亂碼問題

  • 解決中文文件名亂碼（事實(shí)上我在本地測(cè)試并沒有出現(xiàn)亂碼），得到解析器以后，就直接設(shè)置解析器的編碼為UTF-8就行了 
 fileUpload.setHeaderEncoding("UTF-8");
  • 解決表單數(shù)據(jù)亂碼，在獲取表單值的時(shí)候，按照UTF-8編碼來獲取
String value = fileItem.getString("UTF-8");

文件大小約束

  • 單個(gè)文件數(shù)據(jù)的大小約束
    即整個(gè)表單之中只有一個(gè)上傳控件
  • 語法：upload.setFileSizeMax(1024 * 500); // 單個(gè)文件不能超過500 kb
  • 一次請(qǐng)求數(shù)據(jù)的大小約束
    限制整個(gè)請(qǐng)求之中的數(shù)據(jù)大小
  • 語法：upload.setSizeMax(1024 * 750); // 整個(gè)請(qǐng)求文件大小不能超過 750 kb

使用 Map 封裝請(qǐng)求信息

上面提到，我們已經(jīng)無法用 request對(duì)象正常獲取到參數(shù)，那么我們究竟應(yīng)該怎么辦呢？

  • 使用 Map 封裝一下就好了，等到要用的時(shí)候再從 Map 中取出
![image.png](https://upload-images.jianshu.io/upload_images/10280355-81502ea2c1ad2700.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

SmartUpload

上面已經(jīng)基于 FileUpload 實(shí)現(xiàn)了文件的上傳，事實(shí)上也沒有想象中那么復(fù)雜，讓我們來看看 SmartUpload

要使用SmartUpload組件，就需要導(dǎo)入smartupload.jar開發(fā)包

快速入門

//實(shí)例化組件
SmartUpload smartUpload = new SmartUpload();

//初始化上傳操作
smartUpload.initialize(this.getServletConfig(), request, response);

try {

    //上傳準(zhǔn)備
    smartUpload.upload();

    //對(duì)于普通數(shù)據(jù)，單純到request對(duì)象是無法獲取得到提交參數(shù)的。也是需要依賴smartUpload
    String password = smartUpload.getRequest().getParameter("password");
    System.out.println(password);

    //上傳到uploadFile文件夾中
    smartUpload.save("uploadFile");

} catch (SmartUploadException e) {
    e.printStackTrace();    
}
  • 摘自：這里
  • 上面鏈接提到 SmartUpload 組件在解決中文亂碼中有一些小問題，我沒有測(cè)試過，但我覺得自己寫一個(gè) FileUpload 工具類已經(jīng)足夠使用了

文件下載

  1. 寫一個(gè)簡單的 jsp 頁面：
image.png
  1. 在 WEB-INF 下創(chuàng)建 download 文件夾，里面放入一個(gè) test.zip
  2. 編寫 Servlet 處理相關(guān)請(qǐng)求
package servlet;

import javax.servlet.ServletException;
import javax.servlet.ServletOutputStream;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.File;
import java.io.IOException;
import java.net.URLEncoder;
import java.nio.file.Files;
import java.nio.file.Paths;

@WebServlet("/download")
public class DownloadServlet extends HttpServlet {

    protected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {

        // 設(shè)置響應(yīng)數(shù)據(jù)的 MIME 類型
        resp.setContentType("application/x-msdownload");
        // 獲取文件名稱
        String fileName = req.getParameter("fileName");
        // 判斷瀏覽器是否是 IE
        String userAgent = req.getHeader("User-Agent");
        if (userAgent.contains("MSIE")) {
            // IE
            // 設(shè)置文件的名稱
            resp.setHeader("Content-Disposition", "attachment; fileName="
                    + URLEncoder.encode(fileName, "UTF-8"));
        } else {
            // 非IE
            resp.setHeader("Content-Disposition", "attachment; fileName="
                    + new String(fileName.getBytes("UTF-8"), "ISO-8859-1"));
        }

        // 獲取文件所在的路徑
        String path = req.getServletContext().getRealPath("/WEB-INF/download");

        // 獲取指定的文件對(duì)象
        File f = new File(path, fileName);
        ServletOutputStream out = resp.getOutputStream();
        // 將文件復(fù)制到輸出流中，響應(yīng)給瀏覽器
        Files.copy(Paths.get(f.getAbsolutePath()), out);
    }
}
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容