JSP Subida de archivos

JSP se puede utilizar junto con la etiqueta HTML form para permitir a los usuarios subir archivos al servidor. Los archivos subidos pueden ser archivos de texto, archivos de imagen o cualquier documento.

En este capítulo usamos Servlet para manejar la subida de archivos. Los archivos utilizados son:

  • upload.jsp: el formulario de subida de archivos.
  • message.jsp: la página a la que se redirige después de una subida exitosa.
  • UploadServlet.java: el Servlet que procesa la subida.
  • Archivos jar necesarios: commons-fileupload-1.3.2, commons-io-2.5.jar.

El diagrama de estructura es el siguiente:

A continuación lo explicamos en detalle.


Crear un formulario de subida de archivos

El siguiente código HTML crea un formulario de subida de archivos. Los siguientes puntos requieren atención:

  • El formulariomethodel atributo debe establecerse enPOSTel método, no se puede usar el método GET.
  • El formularioenctypeel atributo debe establecerse enmultipart/form-data.
  • El formularioactionel atributo debe establecerse en el archivo Servlet que procesa la subida de archivos en el servidor. El siguiente ejemplo utilizaUploadServletel Servlet para subir archivos.
  • Para subir un solo archivo, debe utilizar una sola etiqueta <input .../> con el atributo type="file". Para permitir la subida de múltiples archivos, incluya varias etiquetas input con diferentes valores en el atributo name. Las etiquetas de entrada tienen diferentes valores de atributo name. El navegador asociará un botón de examinar a cada etiqueta input.

El código del archivo upload.jsp es el siguiente:

<%@ 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>文件上传实例 - Ejemplo</title>
</head>
<body>
<h1>文件上传实例 - Ejemplo</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>

Escribir el Servlet de backend

A continuación se muestra el código fuente de UploadServlet, utilizado para procesar la subida de archivos. Antes de esto, asegurémonos de que los paquetes de dependencia se hayan introducido en el directorio WEB-INF/lib del proyecto:

Puede descargar directamente los dos paquetes de dependencia proporcionados por este sitio:

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

El código fuente de UploadServlet es el siguiente:

package com.ejemplo.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);
    }
}

El código del archivo message.jsp es el siguiente:

<%@ 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>

Compilar y ejecutar el Servlet

Compile el Servlet UploadServlet anterior y cree las entradas necesarias en el archivo web.xml, como se muestra a continuación:

<?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.ejemplo.test.UploadServlet</servlet-class>
  </servlet>
   
  <servlet-mapping>
    <servlet-name>UploadServlet</servlet-name>
    <url-pattern>/TomcatTest/UploadServlet</url-pattern>
  </servlet-mapping>
</web-app>

Ahora intente usar el formulario HTML que creó anteriormente para subir archivos. Cuando acceda en su navegador a: http://localhost:8080/TomcatTest/upload.jsp , la demostración se muestra a continuación:

Otras extensiones