Apache Commons FileUpload 实现文件上传

时间:2023-03-08 19:49:15

Commons FileUpload简介

Apache Commons是一个专注于可重用Java组件开发的 Apache 项目。Apache Commons项目由三个部分组成:

1、Commons Proper - 可重用Java组件的存储库。

2、The Commons Sandbox - 用于Java组件开发的工作区。

3、The Commons Dormant - 当前不活动的组件存储库。

Commons-FileUpload是Commons Proper中的一个组件,该组件依赖于Commons-IO ,Commons-IO也是 Commons Proper中的一个组件。

Commons FileUpload 的JAR包下载

Commons IO 的JAR包下载

前端文件上传页面

文件上传注意事项

FileUpload能解析符合HTML中基于表单的文件上载的HTTP请求 。也就是说,如果使用POST方法提交HTTP请求,并且内容类型为“multipart / form-data”,则FileUpload可以解析该请求,并使结果易于使用。

1、只能使用POST请求,GET请求只能提交普通的字符串(这是HTTP协议规定!)

2、form表单的文件控件是type="file"的input控件。

3、form标签的enctype属性是用来规定在发送表单数据之前如何对其进行编码,必须设置为:multipart/form-data。

enctype属性

enctype属性可能的值:application/x-www-form-urlencoded | multipart/form-data | text/plain。

enctype属性默认值是:application/x-www-form-urlencoded,表示普通的form表单元素提交,在发送前编码所有字符,提交的参数格式遵循:name=value&name=value&name=value...。

multipart/form-data,表示不对字符编码。直接提交二进制文件流。在使用包含文件上传控件的form表单时,必须使用该值。

text/plain,表示空格转换为 "+" 加号,但不对特殊字符编码。

index.jsp页面代码

<%@page contentType="text/html; charset=utf-8"%>
<!doctype html>
<html>
<head>
<title>apache commons fileupload</title>
</head>
<body> <form action="${pageContext.request.contextPath }/fileupload" method="post" enctype="multipart/form-data">
<%-- 普通的控件 --%>
username<input type="text" name="username"><br> <%-- FileItem --%>
<%-- 文件控件 --%>
file1<input type="file" name="file1"><br> <%-- FileItem --%>
file2<input type="file" name="file2"><br> <%-- FileItem --%>
<input type="submit" value="submit">
</form> </body>
</html>

后端接收文件接口

准备JAR包,添加到项目中Apache Commons FileUpload 实现文件上传

Servlet代码

package com.wb.controller;

import java.io.File;
import java.io.IOException;
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.FileUploadException;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload; @WebServlet(urlPatterns = {"/fileupload"})
public class FileUpController extends HttpServlet{ private static final long serialVersionUID = 5351212300627874456L; @Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { //创建一个“硬盘文件条目工厂”对象
DiskFileItemFactory factory = new DiskFileItemFactory();
//设置阈值,设置JVM一次能够处理的文件大小(默认吞吐量是10KB)
factory.setSizeThreshold(DiskFileItemFactory.DEFAULT_SIZE_THRESHOLD);
//设置临时文件的存储位置(文件大小大于吞吐量的话就必须设置这个值,比如文件大小:1GB ,一次吞吐量:1MB)
factory.setRepository(new File("E:\\TestFileUpload\\files")); //创建核心对象
ServletFileUpload fileUpload = new ServletFileUpload(factory);
//设置最大可支持的文件大小(10MB)
fileUpload.setFileSizeMax(1024*1024*10);
//设置转换时使用的字符集
//fileUpload.setHeaderEncoding("UTF-8"); if (ServletFileUpload.isMultipartContent(req)) {
try {
//解析请求
List<FileItem> fileItems = fileUpload.parseRequest(req);
for (FileItem fileItem : fileItems) {
if(fileItem.isFormField()) {//判断该FileItem为一个普通的form元素
//获取字段名
String fieldName = fileItem.getFieldName();
//获取字段值,并解决乱码
String fieldValue = fileItem.getString("UTF-8");
//String fieldValue = fileItem.getString();
System.out.println(fieldName + ":" + fieldValue);
}else {//判断该FileItem为一个文件
//获取文件名
String fileName = fileItem.getName();
System.out.println("fileName=" + fileName);
//获取文件大小
long fileSize = fileItem.getSize();
System.out.println("fileSize=" + fileSize);
fileItem.write(new File("E:\\TestFileUpload\\files" + File.separator + fileName));
}
}
} catch (FileUploadException e) {
e.printStackTrace();
} catch (Exception e) {
e.printStackTrace();
}
}
} }