一、上传原理思路
首先我们的输入流中包含普通项和上传项,普通项就是一些字段信息例如用户名、密码等,上传项就是我们选择的文件,例如图片等二进制文件。二者通过分割线隔开。我们通过判断可以知道哪些是上传项、哪些是普通项。当为上传项时,先在服务器上新建一个和上传文件名一样的文件,然后利用IO流,将这些二进制文件写入服务器上的这个文件中,就完成了文件的上传。
二、实现过程
客户端:HTML页面需要一个<form>
表单,且必须设置表单的enctype属性值为"multipart/form-data",以及method属性值为"post"(因为get方式不支持大量数据提交);表单里有一个<input type="file" name="">
的标签,且name属性值必须指定。
<form action="../Picking/intoNewWareh" method="post" class="form form-horizontal" id="form-admin" enctype="multipart/form-data">
<div class="row cl">
<label class="form-label col-3">文件:</label>
<input id="file" type="file" name="file" />
<input type="submit" value="上传">
</div>
</form>
服务端:主要进行IO读写操作。必须导入commons-fileupload和commons-io两个jar包,可以通过请求request对象的getInputStream获得一个输入流来读取请求中的文件数据。但是如果客户端上传多个文件时,就会很麻烦,所以提供了commons-fileupload和commons-io两个jar包来更方便的实现文件上传。
<!-- 上传组件包 -->
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.3.1</version>
</dependency>
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>2.4</version>
</dependency>
三、文件上传相关核心类
DiskFileItemFactory:相关API如下
- public DiskFileItemFactory():无参构造器
- public DiskFileItemFactory(int sizeThreshold, File repository):构造器,sizeThreshold设置缓冲区大小,默认1024byte;repository表示如果过缓冲区空间小于上传文件空间,那么会生成临时文件,repository就是指定该临时文件的保存路径,如果过未上传完成就中断,继续上传时就可以通过这个临时文件来继续上传。
- public void setSizeThreshold(int sizeThreshold):设置缓冲区大小
- public void setRepository(File repository):指定该临时文件的保存路径
ServletFileUpload:相关API如下
- public static final boolean isMultipartContent( HttpServletRequest request) :判断表单提交上来的数据内容是否是multipart类型的数据,即 form表单的 enctype="multipart/form-data",是则返回true,否则返回false
- public
List<FileItem>
parseRequest(HttpServletRequest request):解析request对象,返回一个泛型为FileItem 的List集合 - public void setFileSizeMax(long fileSizeMax):设置单个文件的空间大小的最大值
- public void setSizeMax(long sizeMax):设置所有文件空间大小之和的最大值
- public void setHeaderEncoding(String encoding):解决上传文件名的乱码问题
- public void setProgressListener(ProgressListener pListener):上传时的进度条。
FileItem:封装表单中提交的数据
- boolean isFormField():判断当前FileItem对象是表单中提交的文本数据项,还是文件数据项
- String getFieldName():获取文本项类型FileItem对象的name属性值,即相当于表单中的
<input type="text" name="name">
- String getString( String encoding ):获取文本项类型FileItem对象的value值,可以指定编码格式,也可以省略encoding不写
- String getName():应用于文件项类型的FileItem对象,用于获取文件的名称,包括后缀名
- InputStream getInputStream():获取输入流
- void delete():删除临时缓存文件(在输入以及输出流关闭后执行)
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.util.List;
import javax.servlet.ServletException;
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;
public class UploadServlet extends HttpServlet{
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
/**
* 1. 创建磁盘文件项工厂类 DiskFileItemFactory
* 2. 创建核心解析Request类 ServletFileUpload
* 3. 开始解析Request对象中的数据,并返回一个List集合( List中包含表单中提交的内容)
* 4. 遍历集合,判断是上传项还是普通项,最后获取内容
*/
DiskFileItemFactory fac=new DiskFileItemFactory();
ServletFileUpload upload=new ServletFileUpload(fac);
//防止中文的文件名乱码
upload.setHeaderEncoding("utf-8");
try {
//文件项
List<FileItem> fileItems = upload.parseRequest(req);
//遍历
for(FileItem item:fileItems){
//首先判断是普通文本项还是文件项,文件项与普通项由不同的API来处理
if(item.isFormField()){
//true表示普通文本项
//获取文本项的name属性值
String name=item.getFieldName();
//获取对应的文本,也就是表单的输入内容
String value=item.getString("utf-8");//防止中文乱码
System.out.println(name+":"+value);
}else{
//false表示文件项
//获取文件名称
String name=item.getName();
//获取文件项的输入流
InputStream in=item.getInputStream();
//获取服务器端文件存储的目标磁盘路径
String path=getServletContext().getRealPath("/upload");
System.out.println(path);
//获取输出流,输出到本地文件中
OutputStream out=new FileOutputStream(path+"/"+name);
//写入数据
int len=0;
byte[] b=new byte[1024];
while((len=in.read(b))!=-1){
out.write(b,0,len);
}
in.close();
out.close();
}
}
} catch (FileUploadException e) {
e.printStackTrace();
}
}
}
//改进上面的文件上传代码,添加一个临时文件
public class UploadServlet extends HttpServlet{
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
DiskFileItemFactory fac=new DiskFileItemFactory();
//设置缓冲区为1mb
fac.setSizeThreshold(1024*1024);
//设置临时文件的本地磁盘存储路径
File repository=new File(getServletContext().getRealPath("/temp"));
fac.setRepository(repository);
ServletFileUpload upload=new ServletFileUpload(fac);
//防止中文的文件名乱码
upload.setHeaderEncoding("utf-8");
try {
List<FileItem> fileItems = upload.parseRequest(req);
for(FileItem item:fileItems){
if(item.isFormField()){//为普通项
String name=item.getFieldName();
String value=item.getString();
String value=item.getString("utf-8");//防止中文乱码
System.out.println(name+":"+value);
}else{//为文件项
String name=item.getName();
InputStream in=item.getInputStream();
String path=getServletContext().getRealPath("/upload");
System.out.println(path);
OutputStream out=new FileOutputStream(path+"/"+name);
int len=0;
byte[] b=new byte[1024];
while((len=in.read(b))!=-1){
out.write(b,0,len);
}
in.close();
out.close();
}
}
} catch (FileUploadException e) {
e.printStackTrace();
}
}
}
四、关于文件上传的一些问题
- 文件重名可能会产生覆盖效果,可以在处理文件名时生成一个唯一的文件名。
- 如果所有的文件都储存在一个文件夹中,会导致文件夹下文件过多,可以一个用户一个文件夹,或者利用算法目录分离等方法。
五、参考博文
(1)https://blog.csdn.net/time__lc/article/details/88805750(通俗易懂的文件上传讲解)
(2)http://www.imooc.com/learn/265(慕课网视频讲解文件上传)
(3)https://my.oschina.net/ProgramerLife/blog/2052144(上传和下载都很详细)