文件上传.
1.准备工作.
对于文件上传,浏览器在上传的过程中是将文件以流的形式提交到服务器端的。
一般选择采用Apache的开源工具common-fileupload这个文件上传组件。
common-fileupload是依赖于common-io这个包的,所以我们需要这两个jar包
common-fileupload : https://mvnrepository.com/artifact/commons-fileupload/commons-fileupload
common-io : https://mvnrepository.com/artifact/commons-io/commons-io/
maven依赖.
<!-- https://mvnrepository.com/artifact/commons-fileupload/commons-fileupload -->
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.4</version>
</dependency>
<!-- https://mvnrepository.com/artifact/commons-io/commons-io -->
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>2.7</version>
</dependency>
2.使用类介绍.
文件上传注意事项(调优).
- 为保证服务器安全,上传文件应该放在外界无法直接访问的目录,比如放在
WEB-INF
目录下 - 为了防止文件覆盖的现象发生,要为上传产生一个唯一的文件名
- 时间戳(不太安全:不同用户同一时间上传同一文件)
- uuid 唯一识别的通用码
UUID.randomUUID()
- md5
- 。。。
- 要限制上传文件的最大值
- 服务器硬盘资源比较昂贵(当然有钱可以忽略)
- 可以限制上传文件的类型,在收到上传文件时,判断后缀名是否合法
- 同样是硬盘资源
需要用到的类详解.
ServletFileUpload
负责文件上传的文件数据,并将表单中的每个输入项封装成一个FIleItem
对象,在使用ServletFileUpload
对象解析请求时需要DiskFileItemFactory
对象。所以我们需要在进行解析工作前构造好DiskFileItemFactory
对象,通过ServletFileUpload
对象的构造方法或setFileItemFactory()
方法设置ServletFileUpload
对象的fileItemFactory
属性。
FileItem
类.
常用方法.
//用于判断FileItem类对象封装的数据(input等标签type是其他还是file)是一个普通表单还是一个文件表单
//普通 true
//文件 false
boolean isFormField();
//用于返回表单标签name属性的值
String getFieldName();
//用于将FileItem对象中保存的数据流内容以一个字符串返回 value属性的值
String getString();
//用于获取文件上传字段中的文件名
String getName();
//以流的形式返回上传文件的数据内容
InputStream getInputStream();
//如果主体内容被保存在临时文件中,该方法用于删除该临时文件
void delete();
ServletFileUpload
类.
ServletFileUpload
负责处理上传的文件数据,并将表单中每个输入项封装成一个FileItem
对象中
使用parseRequest(HttpServletRequest)
方法可以将通过表单中每一个HTML标签提交的数据封装成一个FileItem
对象,然后以List列表的形式返回,使用该方法处理上传文件简单易用。
3.代码编写.
文件上传表单.
表单如果包含一个文件上传输入项的话,这个表单的enctype属性必须设置为multipart/form-data
<!-- 通过表单文件上传必须 enctype="multipart/form-data"
method只能使用post ; get大小有限制
action可指定url
-->
<form method="post" action="#" enctype="multipart/form-data">
<!--multiple允许选中多文件-->
<input type="file" name="fileName" multiple/>
<input type="submit" value="文件上传">
</form>
.
fileUploadServlet (使用 fileupload + uuid).
try {
/*
1.判断上传文件的表单是一个普通表单还是一个文件表单
*/
if (!ServletFileUpload.isMultipartContent(req)){
return;//不带文件的表单 终止方法
}
/*
2.创建上传文件的保存路径, 建议在WEB-INF路径下
*/
String uploadPath = this.getServletContext().getRealPath("/WEB-INF/upload");
File uploadDir = new File(uploadPath);
if (!uploadDir.exists()){
uploadDir.mkdir();//目录不存在,创建目录
}
//缓存--临时路径
//如果文件超过一定大小,自动放到临时路径,过几天自动删除
String tmpPath = this.getServletContext().getRealPath("/WEB-INF/tmp");
File tmpDir = new File(tmpPath);
if (!tmpDir.exists()){
tmpDir.mkdir();//目录不存在,创建目录
}
/*
3.处理上传文件
一般都需要通过流来获取,我们可以使用request.getInputStream(),原生态的文件上传流获取,十分麻烦
通过Apache的文件上传组件实现
*/
//1. 创建DiskFileItemFactory对象,处理文件上传路径或者大小限制
DiskFileItemFactory factory = new DiskFileItemFactory();
//设置一个缓冲区,当文件大小超过缓冲区大小时,文件放到临时文件中
factory.setSizeThreshold(1024 * 1024);// 1M
factory.setRepository(tmpDir);//设置缓冲区临时目录
//2. 获取ServletFileUpload
ServletFileUpload upload = new ServletFileUpload(factory);
//监听文件上传进度 (可选)
upload.setProgressListener(new ProgressListener() {
/**
* @param pBytesRead 已经读取的文件大小
* @param pContentLength 文件大小
* @param pItems 文件读取个数 0:没有 1:正在读取第一个 2:第二个 。。。
**/
@Override
public void update(long pBytesRead, long pContentLength, int pItems) {
System.out.println("总大小:" + pContentLength + "\n已上传:" + pBytesRead + "\n正在上传:第" + pItems + "个");
}
});
//处理乱码问题 (可选)
upload.setHeaderEncoding("utf-8");
//设置单个文件的最大值 (可选)
upload.setFileSizeMax(1024 * 1024 * 10);//10M
//设置总共能够上传文件的大小 (可选)
upload.setSizeMax(1024 * 1024 * 20);//20M
//3. 处理上传的文件
//把前端请求解析,封装成一个FileItem对象(表单标签对象)List
List<FileItem> fileItems = upload.parseRequest(req);
for (FileItem fileItem : fileItems) {
if (fileItem.isFormField()){//普通标签
//getFiledName 得到标签的 name属性的值
String name = fileItem.getFieldName();
//getString得到 value属性的值
String value = fileItem.getString("utf-8");
System.out.println("name: " + name);
System.out.println("value: " + value);
}else{//文件标签
//=====================处理文件=================//
//获取上传文件的路径
String uploadFileName = fileItem.getName();
if (uploadFileName == null || "".equals(uploadFileName.trim())){
continue;
}
//获取上传的文件名
String fileName = uploadFileName.substring(uploadFileName.lastIndexOf("/") + 1);
//获取文件的后缀名
String ExtName = uploadFileName.substring(uploadFileName.lastIndexOf(".") + 1);
//使用UUID(唯一识别的通用码)随机生成一个唯一识别的通用码
String uuid = UUID.randomUUID().toString();
//=====================存放地址=================//
// 使用 UUID 创建一个文件夹 upload 路径下
String realPath = uploadPath + "/" + uuid;
//给每一个文件创建一个uuid文件夹
File uuidDir = new File(realPath);
if (!uuidDir.exists()){//没有就创建
uuidDir.mkdir();
}
//=====================文件传输=================//
//获取文件上传的流
InputStream in = fileItem.getInputStream();
//创建一个文件输出流
FileOutputStream out = new FileOutputStream(realPath + "/" + fileName);
//创建一个缓冲区
byte[] buf = new byte[1024*1024];//1M
int len = 0;
while((len=in.read(buf)) != -1){
out.write(buf, 0 , len);
}
out.close();
in.close();
//上传成功,删除临时文件
fileItem.delete();
}
}
} catch (FileUploadException e) {
e.printStackTrace();
}
补充.
1.普通表单和文件表单.
- 普通
- enctype=”application/x-www-form-urlencoded”>
- 文件
- enctype:multipart/form-data
- input type=”file”
- enctype:multipart/form-data