java文件上传

一、上传原理思路

首先我们的输入流中包含普通项和上传项，普通项就是一些字段信息例如用户名、密码等，上传项就是我们选择的文件，例如图片等二进制文件。二者通过分割线隔开。我们通过判断可以知道哪些是上传项、哪些是普通项。当为上传项时，先在服务器上新建一个和上传文件名一样的文件，然后利用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(上传和下载都很详细)