JSP Загрузка файлов

JSP можно использовать с HTML-тегом form, чтобы позволить пользователям загружать файлы на сервер. Загруженные файлы могут быть текстовыми файлами, файлами изображений или любыми документами.

В этой главе мы используем Servlet для обработки загрузки файлов. Используются следующие файлы:

upload.jsp: форма загрузки файла.
message.jsp: страница перенаправления после успешной загрузки.
UploadServlet.java: Servlet обработки загрузки.
Требуемые jar-файлы: commons-fileupload-1.3.2, commons-io-2.5.jar.

Структурная схема выглядит следующим образом:

Далее мы подробно рассмотрим это.

Создание формы загрузки файла

Следующий HTML-код создает форму загрузки файла. На следующие моменты следует обратить внимание:

Formmethodформы должен быть установлен в методPOST, нельзя использовать метод GET.
Formenctypeформы должен быть установлен вmultipart/form-data.
Formactionформы должен быть установлен в файл сервлета, который обрабатывает загрузку файлов на серверной стороне. В следующем примере для загрузки файлов используется сервлетUploadServlet.
Чтобы загрузить один файл, следует использовать один тег <input .../> с атрибутом type="file". Чтобы разрешить загрузку нескольких файлов, включите несколько тегов input с разными значениями атрибута name. Теги input имеют разные значения атрибута name. Браузер свяжет кнопку выбора файла с каждым тегом input.

Код файла upload.jsp выглядит следующим образом:

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
    "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>文件上传实例 - Example</title>
</head>
<body>
<h1>文件上传实例 - Example</h1>
<form method="post" action="../TomcatTest/UploadServlet" enctype="multipart/form-data">
    选择一个文件:
    <input type="file" name="uploadFile" />
    <br/><br/>
    <input type="submit" value="上传" />
</form>
</body>
</html>

Напишите серверный сервлет

Ниже приведен исходный код UploadServlet, используемый для обработки загрузки файлов. Перед этим мы сначала убедимся, что пакеты зависимостей были импортированы в каталог WEB-INF/lib проекта:

The following example depends on FileUpload, so make sure you have the latest version ofcommons-fileupload.x.x.jar. Вы можете скачать его сhttp://commons.apache.org/proper/commons-fileupload/Скачать.
FileUpload зависит от Commons IO, поэтому убедитесь, что у вас есть последняя версияcommons-io-x.x.jarфайла. Вы можете скачать его сhttp://commons.apache.org/proper/commons-io/Скачать.

Вы можете напрямую скачать два пакета зависимостей, предоставленных этим сайтом:

commons-fileupload-1.3.2.jar
commons-io-2.5.jar

Исходный код UploadServlet выглядит следующим образом:

package com.example.test;

import java.io.File;
import java.io.IOException;
import java.io.PrintWriter;
import java.util.List;
 
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 org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;
 

/**
 * Servlet implementation class UploadServlet
 */

// 如果不配置 web.xml ，可以使用下面的代码
// @WebServlet("/UploadServlet")
public class UploadServlet extends HttpServlet {
    private static final long serialVersionUID = 1L;
     
    // 上传文件存储目录
    private static final String UPLOAD_DIRECTORY = "upload";
 
    // 上传配置
    private static final int MEMORY_THRESHOLD   = 1024 * 1024 * 3;  // 3MB
    private static final int MAX_FILE_SIZE      = 1024 * 1024 * 40; // 40MB
    private static final int MAX_REQUEST_SIZE   = 1024 * 1024 * 50; // 50MB
 
    /**
     * 上传数据及保存文件
     */
    protected void doPost(HttpServletRequest request,
        HttpServletResponse response) throws ServletException, IOException {
        // 检测是否为多媒体上传
        if (!ServletFileUpload.isMultipartContent(request)) {
            // 如果不是则停止
            PrintWriter writer = response.getWriter();
            writer.println("Error: 表单必须包含 enctype=multipart/form-data");
            writer.flush();
            return;
        }
 
        // 配置上传参数
        DiskFileItemFactory factory = new DiskFileItemFactory();
        // 设置内存临界值 - 超过后将产生临时文件并存储于临时目录中
        factory.setSizeThreshold(MEMORY_THRESHOLD);
        // 设置临时存储目录
        factory.setRepository(new File(System.getProperty("java.io.tmpdir")));
 
        ServletFileUpload upload = new ServletFileUpload(factory);
         
        // 设置最大文件上传值
        upload.setFileSizeMax(MAX_FILE_SIZE);
         
        // 设置最大请求值 (包含文件和表单数据)
        upload.setSizeMax(MAX_REQUEST_SIZE);
        
        // 中文处理
        upload.setHeaderEncoding("UTF-8"); 

        // 构造临时路径来存储上传的文件
        // 这个路径相对当前应用的目录
        String uploadPath = getServletContext().getRealPath("/") + File.separator + UPLOAD_DIRECTORY;
       
         
        // 如果目录不存在则创建
        File uploadDir = new File(uploadPath);
        if (!uploadDir.exists()) {
            uploadDir.mkdir();
        }
 
        try {
            // 解析请求的内容提取文件数据
            @SuppressWarnings("unchecked")
            List<FileItem> formItems = upload.parseRequest(request);
 
            if (formItems != null && formItems.size() > 0) {
                // 迭代表单数据
                for (FileItem item : formItems) {
                    // 处理不在表单中的字段
                    if (!item.isFormField()) {
                        String fileName = new File(item.getName()).getName();
                        String filePath = uploadPath + File.separator + fileName;
                        File storeFile = new File(filePath);
                        // 在控制台输出文件的上传路径
                        System.out.println(filePath);
                        // 保存文件到硬盘
                        item.write(storeFile);
                        request.setAttribute("message",
                            "文件上传成功!");
                    }
                }
            }
        } catch (Exception ex) {
            request.setAttribute("message",
                    "错误信息: " + ex.getMessage());
        }
        // 跳转到 message.jsp
        getServletContext().getRequestDispatcher("/message.jsp").forward(
                request, response);
    }
}

Код файла message.jsp выглядит следующим образом:

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
    "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>文件上传结果</title>
</head>
<body>
    <center>
        <h2>${message}</h2>
    </center>
</body>
</html>

Скомпилируйте и запустите Servlet

Скомпилируйте указанный выше Servlet UploadServlet и создайте необходимую запись в файле web.xml, как показано ниже:

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
        http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
    id="WebApp_ID" version="2.5">
  <servlet>
    <display-name>UploadServlet</display-name>
    <servlet-name>UploadServlet</servlet-name>
    <servlet-class>com.example.test.UploadServlet</servlet-class>
  </servlet>
   
  <servlet-mapping>
    <servlet-name>UploadServlet</servlet-name>
    <url-pattern>/TomcatTest/UploadServlet</url-pattern>
  </servlet-mapping>
</web-app>

Теперь попробуйте загрузить файл с помощью HTML-формы, созданной выше. Когда вы откроете http://localhost:8080/TomcatTest/upload.jsp в браузере, демонстрация будет выглядеть так:

Другие расширения

JSP Продвинутое руководство

JSP Загрузка файлов

Создание формы загрузки файла

Напишите серверный сервлет

Скомпилируйте и запустите Servlet