English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

JSP 파일 업로드

JSP 可以与 HTML form 标签一起使用,来允许用户上传文件到服务器。上传的文件可以是文本文件或图像文件或任何文档。

本章节我们使用 Servlet 来处理文件上传,使用到的文件有:

  • upload.jsp : 文件上传表单。

  • message.jsp : 上传成功后跳转页面。

  • UploadServlet.java : 上传处理 Servlet。

  • 需要引入的 jar 文件:commons-fileupload-1.3.2、commons-io-2.5.jar。

结构图如下所示:


接下来我们详细介绍。

创建一个文件上传表单

下面的 HTML 代码创建了一个文件上传表单。以下几点需要注意:

  • 양식 method 속성은 설정되어야 합니다 POST 方法,不能使用 GET 方法。

  • 양식 enctype 속성은 설정되어야 합니다 multipart/form-데이터.

  • 양식 action 속성은 백엔드 서버에서 파일 업로드를 처리하는 Servlet 파일로 설정되어야 합니다. 아래의 예제는 UploadServlet Servlet를 사용하여 파일을 업로드해야 합니다。

  • 한 개의 파일을 업로드하려면,type="file"의 속성을 가진 단일 <input .../> 태그를 포함하여 여러 개의 파일을 업로드할 수 있도록多个文件上传,请包含多个 name 属性值不同的 input 标签。输入标签具有不同的名称属性的值。浏览器会为每个 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>파일 업로드 예제 - 기본 튜토리얼 웹사이트</title>
</head>
<body>
<h1>파일 업로드 예제 - 기본 튜토리얼 웹사이트</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>

백엔드 Servlet 작성

아래는 UploadServlet의 소스 코드입니다. 파일 업로드를 처리하는 코드이며, 이전에 의존성 패키지가 프로젝트의 WEB에 추가되었는지 확인해야 합니다:-INF/lib 디렉토리에:

당신은 사이트에서 제공하는 두 가지 의존성 패키지를 직접 다운로드할 수 있습니다:

UploadServlet의 소스 코드는 다음과 같습니다:

package com.w;3codebox.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 {
        // 미디어 업로드 여부 검사
        (!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.w3codebox.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, 다음과 같이 표시됩니다: