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

Основные курсы JSP

Дополнительные курсы JSP

Загрузка файлов 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-data.

  • форма action Атрибут должен быть установлен на Servlet файла на сервере, который обрабатывает загрузку файлов. В данном примере используется UploadServlet Servlet для загрузки файла.

  • Для загрузки одного файла вы должны использовать один элемент ввода с атрибутом type="file" <input .../>. Чтобы разрешить загрузку нескольких файлов, включите несколько элементов ввода с различными значениями атрибута name. Элементы ввода имеют различные значения атрибута name. Браузер будет связывать каждый элемент ввода с кнопкой выбора файла.

Код файла 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 проекта:

  • Следующий пример зависит от FileUpload, поэтому убедитесь, что у вас в classpath есть последняя версия commons-fileupload.x.x.jar Файл. Его можно найти в http://commons.apache.org/proper/commons-fileupload/ Загрузка.

  • FileUpload зависит от Commons IO, поэтому убедитесь, что у вас в classpath есть последняя версия commons-io-x.x.jar Файл. Его можно найти в http://commons.apache.org/proper/commons-io/ Загрузка.

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

С渊源 кода UploadServlet приведен ниже:

package com.w3codebox.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");　
　　　　　　　　// constructing a temporary path to store uploaded files
　　　　　　　　// этот путь относительно текущего приложения
　　　　　　　　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 , демонстрация будет выглядеть так:

Обработка даты JSPСессия JSP