前言:

推荐免费JavaWeb入门到实战视频:【狂神说Java】JavaWeb入门到实战_哔哩哔哩_bilibili

文件传输原理及介绍

文件传输原理流程图

image-20220421133107320

准备工作

  1. 文件上传的jar包下载

    • commons-io
    • commons-fileUpload
  2. 把jar包导入项目

    image-20220421165733320

  3. 使用类介绍

    【文件上传的注意事项】

    • 为了保证服务器安全,上传文件应该放在外界无法直接访问的目录下,例如WEB-INF目录下
    • 为了防止文件覆盖的现象发生,上传文件应生成唯一的文件名
    • 要限制上传文件的最大值
    • 可以限制上传文件的类型,再收到上传文件名时,判断后缀名是否合法

    【需要用到的类】

    • ServletFileUpload负责处理上传的文件数据,并将表单中每个输入项封装成一个FileItem对象,再使用ServletFileUpload对象解析请求时需要DiskFileItemFactory对象。
    • 我们需要在进行解析工作前构造好DiskFileItemFactory对象,通过ServletFileUpload对象的构造方法或setFileItemFactory()方法设置ServletFileUpload对象的FileItemFactory属性
  4. 准备工作完成

文件上传

FileItem类

在Html页面input必须要有name<input type="file" name="file1">

表单如果包含一个文件上传输入,则这个表单的enctype属性必须设置为multipart/form-data

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>文件上传</title>
</head>
<body>

<%-- 通过表单上传--%>
<form action="${pageContext.request.contextPath}/upload.do" method="post" enctype="multipart/form-data">
<%-- get有上传大小限制--%>
<input type="file" name="file1"><br>
<input type="file" name="file2"><br>
<input type="submit">
<input type="reset">
</form>
</body>
</html>

ServletFileUpload类

ServletFileUpload负责处理上传的文件数据,并将表单中每个输入法封装成一个FileItem对象中,使用parseRequest(HttpServletRequest)方法可以通过表单当中每一个HTML标签提交的数据封装为一个FileItem对象,然后以List列表的形式返回,使用该方法处理文件上传。

FileUpload.java

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
package com.jokerdig.servlet;

import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.ProgressListener;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;
import java.util.UUID;

/**
* @author Joker大雄
* @data 2022/4/21 - 14:52
**/
public class FileUpload extends HttpServlet {

@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
// 判断上传文件是普通表单还是带文件的表单
if(!ServletFileUpload.isMultipartContent(req)){
return ;// 中止方法 是普通表单
}
// 带文件的表单 上传文件应该放在WEB-INF目录下 安全
String uploadPath = this.getServletContext().getRealPath("/WEB-INF/upload");
File uploadFile = new File(uploadPath);
if(!uploadFile.exists()){
// 上传文件夹不存在
uploadFile.mkdir();// 创建
}
// 缓存 临时文件
String tmpPath = this.getServletContext().getRealPath("/WEB-INF/tmp");
File tmpFile = new File(tmpPath);
if(!tmpFile.exists()){
tmpFile.mkdir();// 创建
}
// 1. 创建DiskFileItemFactory对象,get处理文件上传路径或者大小限制
DiskFileItemFactory factory = getDiskFileItemFactory(tmpFile);
// 2. 获取ServletFileUpload
ServletFileUpload upload = getServletFileUpload(factory);
// 3. 上传文件
String msg = getParseRequest(upload,req,uploadPath);
// 将结果信息发送到页面
req.setAttribute("msg",msg);
req.getRequestDispatcher("info.jsp").forward(req,resp);
}
// 创建DiskFileItemFactory对象
public static DiskFileItemFactory getDiskFileItemFactory(File file){
// *创建DiskFileItemFactory对象,处理文件上传路径或者大小限制
DiskFileItemFactory factory = new DiskFileItemFactory();
// 通过工厂设置一个缓冲区,当上传文件大于这个缓冲区,将他放到临时文件中
factory.setSizeThreshold(1024*1024);// 缓冲区大小为1m
factory.setRepository(file); // 临时保存目录
return factory;
}

// 2. 获取ServletFileUpload
public static ServletFileUpload getServletFileUpload(DiskFileItemFactory factory) {
// 2. 获取ServletFileUpload
ServletFileUpload upload = new ServletFileUpload(factory);
// 监听文件上传进度
upload.setProgressListener(new ProgressListener() {
@Override
public void update(long pBytesRead, long pContentLength, int pItems) {
// pBytesRead:已经读取到的文件大小
// pContentLength:文件大小
System.out.println("总大小:"+pContentLength+"已上传:"+pBytesRead);
}
});
// 处理乱码
upload.setHeaderEncoding("utf-8");
// 设置单个文件最大值
upload.setFileSizeMax(1024*1024*10);
// 设置总共能狗上传文件大小
// 1024=1kb*1024=1M*10=10M
upload.setSizeMax(1024*1024*10);

return upload;
}
// 处理上传文件
public static String getParseRequest(ServletFileUpload upload,HttpServletRequest req,String uploadPath){
// 把前端请求解析,封装成一个FileItem对象
List<FileItem> fileItems = null;
String msg = null;
try {
fileItems = upload.parseRequest(req);
// fileItem 每一个表单对象
for (FileItem fileItem : fileItems) {
// 判断上传文件是否为普通表达那
if(fileItem.isFormField()){
String name = fileItem.getFieldName();
String value = fileItem.getString("utf-8");
System.out.println(name+":"+value);
}else{
// 上传为文件
String uploadFileName = fileItem.getName();
if(uploadFileName.trim().equals("")||uploadFileName==null){
continue;
}
// 获得上传的文件名
String fileName = uploadFileName.substring(uploadFileName.lastIndexOf("/")+1);
// 获取文件后缀
String fileExtName = uploadFileName.substring(uploadFileName.lastIndexOf(".")+1);
// 网络中传输的东西都需要实例化
// 所以我们在写实体类,为它实现 implements Serializable
// JNI = Java Native Interface Java本地化接口
// JVM --> 本地方法栈 native ---> C++
// 使用UUID随机生成
String uuidPath = UUID.randomUUID().toString();

// 文件真是存在路径 realPath
String realPath = uploadPath+"/"+uuidPath;
// 给每个文件创建对应的文件夹
File realPathFile = new File (realPath);
if(!realPathFile.exists()){
// 不存在就创建
realPathFile.mkdir();
}

// --------------文件传输-------------------
// 获得文件上传的流
InputStream inputStream = fileItem.getInputStream();
// 创建一个文件输出流 文件名字+"/"+uuidFileName
FileOutputStream os = new FileOutputStream(realPath+"/"+fileName);
// 创建缓冲
byte[] buffer = new byte[1024*1024];
// 判断是否读取完
int len = 0;
while((len=inputStream.read(buffer))>0){
os.write(buffer,0,len);
}
// 关闭流
os.close();;
inputStream.close();

msg="文件上传成功";
fileItem.delete();// 成功后清除临时文件
}
}
} catch (Exception e) {
e.printStackTrace();
}
return msg;
}
}

web.xml

1
2
3
4
5
6
7
8
9
<!--    FileUpload-->
<servlet>
<servlet-name>FileUpload</servlet-name>
<servlet-class>com.jokerdig.servlet.FileUpload</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>FileUpload</servlet-name>
<url-pattern>/upload.do</url-pattern>
</servlet-mapping>

上传文件成功

image-20220421165449806