文件的上传与下载

文件的上传与下载

文件的上传与下载在web应用中是非常常用，也是非常有用的。

例如：发送电子邮件时上传附件，下载网上资源时。

一、文件的上传

主要分为两个步骤：

        1.用户在页面中选择要上传的文件，然后将请求提交到Servelt

        2.Servelt收到请求，解析用户上传的文件，然后将文件存储到服务器

1.创建上传文件的表单

        <form action="" method="post" enctype="multipart/form-data">
		<input type="file" name="file" /><br /><br />
		<input type="submit" value="上传" />
	</form>

文件上传的表单和之前的表单类似，但有以下内容需要注意

表单的method属性必须为post

表单的enctype属性必须为multipart/form-data

上传文件的控件是intput，type属性为file

2.编写Servelt

页面的表单控件创建好以后，选中文件点击上传按钮请求将会提交到指定的Servlet来处理。

 注意：这里不能再像以前的Servlet中那样，通过request.getParamter()来获取请求参数了，当enctype="multipart/form-data"时，

再使用getParamter()获取到内容永远为空。因为浏览器发送请求的方式已经改变。

既然以前的方法不能使用了，这里我们必须要引入一个新的工具来解析请求中的参数和文件，这个工具就是commons-fileupload。

我们一般情况下使用commons-fileupload-1.3.1.jar这个工具来解析多部件请求。
> fileupload 依赖 commons-io 所以我们要是Filtupload需要同时导入io包。
> 核心类：
DiskFileItemFactory 
- 工厂类，用于构建一个解析器实例。

ServletFileUpload 
- 解析器类，通过该类实例来解析request中的请求信息。

FileItem 
- 工具会将我们请求中每一个部件，都封装为一个FileItem对象，处理文件上传时，只需要调用该对象的方法
- 方法：
boolean isFormField()  --> 当前表单项是否是一个普通表单项，true是普通表单项， false是文件表单项
String getContentType() --> 返回的是文件的类型，是MIME值
String getFieldName()   --> 获取表单项的name属性值
String getName() --> 获取上传的文件的名字
long getSize()          --> 获取文件的大小
String getString(String encoding) --> 获取表单项的value属性值，需要接受一个编码作为参数。
void write(File file)    --> 将表单项中的内容写入到磁盘中

> 使用步骤：
1.获取工厂类实例[DiskFileItemFactory]
2.获取解析器类实例[ServletFileUpload]
3.解析request获取FileItem[parseRequest()]

代码如下：

//创建工厂类
DiskFileItemFactory factory = new DiskFileItemFactory();
//创建请求解析器
ServletFileUpload fileUpload = new ServletFileUpload(factory);
//设置上传单个文件的的大小
fileUpload.setFileSizeMax(1024*1024*3);
//设置上传总文件的大小
fileUpload.setSizeMax(1024*1024*3*10);
//设置响应内容的编码
response.setContentType("text/html;charset=utf-8");
try {
	//解析请求信息，获取FileItem的集合
	List<FileItem> items = fileUpload.parseRequest(request);
	//遍历集合
	for (FileItem fileItem : items) {
		//如果是普通的表单项
		if(fileItem.isFormField()){
		    //获取参数名
		    String fieldName = fileItem.getFieldName();
		    //获取参数值
		    String value = fileItem.getString("utf-8");
		    System.out.println(fieldName+" = "+value);
	        //如果是文件表单项
	    }else{
		    //获取文件名
		    String fileName = fileItem.getName();
		    //获取上传路径
		    String realPath = getServletContext().getRealPath("/WEB-INF/upload");
		    //检查upload文件夹是否存在，如果不存在则创建
		    File f = new File(realPath);
		    if(!f.exists()){
			    f.mkdir();
		    };
		    //为避免重名生成一个uuid作为文件名的前缀
		    String prefix = UUID.randomUUID().toString().replace("-", "");
		    //将文件写入到服务器中
		    fileItem.write(new File(realPath+"/"+prefix+"_"+fileName));
		    //清楚文件缓存
		    fileItem.delete();
	    }
}
} catch (Exception e) {
	if(e instanceof SizeLimitExceededException){
		//文件总大小超出限制
		response.getWriter().print("上传文件的总大小不能超过30M");
	}else if(e instanceof FileSizeLimitExceededException){
		//单个文件大小超出限制
		response.getWriter().print("上传单个文件的大小不能超过3M");
	}
} 
response.getWriter().print("上传成功");

注意的问题：

第一个问题
> 部分浏览器会将文件的完整路径作为文件名发送。
C:UserslilichaoDesktopday20图片蒙娜丽莎.jpg
> 像这类文件名我们需要截取一下字符串，只获取名字这部分，而不需要获取路径部分的信息。
通过如下代码对文件名进行截取字符串的操作：
if(name.contains("\")){
//如果包含则截取字符串
name = name.substring(name.lastIndexOf("\")+1);
}
第二个问题
> 上传的文件有可能出现重名，后上传的文件会将先上传的文件覆盖。
> 解决：给文件名加一个唯一的前缀。
唯一标识_fennu.jpg
UUID_fennu.jpg

第三个问题
> 有些情况需要限制上传文件的大小。
- 设置单个文件大小为50KB：
fileUpload.setFileSizeMax(1024*50);
- 设置完单个文件大小限制以后，一旦上传的文件超过限制，则会抛出如下异常：
FileSizeLimitExceededException
所有可以对该异常进行捕获，当出现该异常时则设置一个错误消息。

- 设置多个文件的总大小为150KB
fileUpload.setSizeMax(1024*150);
- 当多个文件的大小超出范围时，会抛出如下异常
SizeLimitExceededException

第四个问题
> 当用户上传一个空的文件，依然会将文件保存到硬盘上。
> 在保存文件应该先对文件的大小进行判断，如果size为0，则不处理。

二、文件的下载

简介
> 将服务器中的文件下载到本地。
> 一般情况下资源所在的链接发送给浏览器，浏览器就会自动下载。
但是当浏览器支持当前文件的格式，浏览器会自动打开文件，而不会弹出下载窗口。
> 直接将资源放在项目的目录下，浏览器可以直接访问到资源。
所以一般我们下载的资源不能让浏览器直接访问到。

下载所需要的内容
1.获取到文件的流
2.设置两个响应头

下载相关的两个响应头
1) 文件类型 Content-Type --> 文件的MIME类型
Content-Type：告诉浏览器文件的类型，需要设置一个MIME值
response.setContent-Type("MIME值")
通过servletContext.getMimeType(path)方法可以直接获取文件的MIME类型

2) 下载文件的信息 Content-Disposition --> attachment; filename=文件名
Content-Disposition告诉浏览器如何处理文件，
attachment 告诉浏览器这个文件是一个附件的形式发给你的，需要你做下载的操作
filename 告诉浏览器下载文件的名字

3) 乱码的问题，当将文件的名字设置为中文，浏览器正常显示文件的名字。
因为从服务器向浏览器发送中文时，需要对内容进行URL编码。
> 大部分浏览器使用如下方式即可解决乱码问题：URLEncoder.encode(fileName, "utf-8");
> 但是火狐默认以Base64来解码的，所以要为火狐单独处理。

> 可以使用如下代码来判断浏览器的类型，然后进行不同的编码处理
//判断当前浏览器是否为火狐
if(ua.contains("Firefox")){
//是火狐浏览器，使用BASE64编码
fileName = "=?utf-8?b?"+new BASE64Encoder().encode(fileName.getBytes("utf-8"))+"?=";
}else{
//给文件名进行URL编码
//URLEncoder.encode()需要两个参数，第一个参数时要编码的字符串，第二个是编码所采用的字符集
fileName = URLEncoder.encode(fileName, "utf-8");
}

>  还有一种不太讲理的方式，谁问跟谁急。反正好使
- 向将字符串用gbk进行解码，然后在使用iso8859-1进行编码
fileName = new String(fileName.getBytes("gbk"),"iso8859-1");

相关代码：

		ServletContext servletContext = request.getServletContext();
		String fileName="风吹麦浪.mp3";
		String path=servletContext.getRealPath("/WEB-INF/"+fileName);
		File file = new File(path);
		String type = servletContext.getMimeType(path);
		//1.创建输入流
		InputStream in = new FileInputStream(file);
		//
		response.setContentType(type);
		fileName = new String(fileName.getBytes("gbk"),"iso8859-1");
		response.setHeader("Content-Disposition","attachment;filename="+fileName);
		ServletOutputStream out = response.getOutputStream();
		IOUtils.copy(in, out);

方法二：

String realPath = getServletContext().getRealPath("/WEB-INF/mp3/中国话.mp3");	
	File file = new File(realPath);//获取文件的File对象	
	FileInputStream is = new FileInputStream(file);//获取文件的输入流
	//获取头信息		
	String contentType = getServletContext().getMimeType(realPath);//获取文件的MIME信息
	String filename = "zhongguohua.mp3";//设置下载文件的名字	
	String disposition = "attachment; filename="+ filename ;//创建Content-Disposition信息	
	long size = file.length();//获取文件长度
	//设置头信息	
	response.setContentType(contentType);//设置Content-Type
	response.setHeader("Content-Disposition", disposition);//设置Content-Disposition
	response.setContentLength((int)size);//设置文件长度
	//发送文件	
	ServletOutputStream out = response.getOutputStream();//通过response获取输出流，用于向浏览器输出内容
	//将文件输入流通过输出流输出
	byte[] b = new byte[1024];
	int len = 0;
	while((len=is.read(b))> 0){
	out.write(b, 0, len);
	}
	//最后不要忘记关闭输入流，输出流由Tomcat自己处理，我们不用手动关闭
	is.close();

注意：文档文本下载时可以使用字符流，图片、音乐、视频时都必须使用字节流，否则会读不出来；不要忘记关闭流。