JSP 和 HTML Form 标签一起使用，来允许用户把文件上传到服务器。上传的文件可以是文本文件、图像文件或其它任何文档。

创建上传文件表单时，需要注意以下几点：

• 表单的 method 属性必须设置为 POST 方法，不能使用 GET 方法。
• 表单 enctype 属性应设置为 multipart/form-data。
• 表单 action 属性应设置为对应的 Servlet，用来处理文件上传的逻辑代码，下面示例中使用 FileUploadServlet 处理逻辑。
• 使用 标签上传单个文件，属性 type="file"。上传多个文件需添加多个 标签。

拓展

表单的 enctype 属性有以下 3 个值：

1. application/x-www-form-urlencoded：默认值，用于处理少量文本数据的传递。向服务器发送大量的文件或二进制数据时，效率很低。
2. multipart/form-data：上传二进制数据，只有使用了 multipart/form-data 才能完整的传递文件数据，进行上传操作。
3. text/plain：用于向服务器传递大量文本数据，适用于电子邮件的应用。

示例

<%@ page language="java" contentType="text/html; charset=UTF-8"pageEncoding="UTF-8"%>





上传文件
 
 

在 FileuploadServlet 中处理文件上传逻辑，代码如下：

package net.biancheng;

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;

@WebServlet("/FileuploadServlet")

public class FileuploadServlet 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;

}

// 配置fileItem工厂

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 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 页面显示是否上传成功：

1. <%@ page language="java" contentType="text/html; charset=UTF-8"
2. pageEncoding="UTF-8"%>
9. ${message}