文件上传

Posted 2020-10-03

一、文件上传编程
1、在用户页面中添加上传输入项 （客户端页面操作）
<input type="file" />
注意事项：
1) 必须为文件上传input 提供name属性，否则文件上传内容不会被表单提交
2) 表单的提交是post （get提交数据在url地址上显示，有长度限制）
3) 设置enctype=multipart 使得文件上传编码 ----- MIME编码格式

2、在servlet中读取上传文件的数据，并保存到服务器硬盘中
通过request.getInputStream

常用文件上传API ：
1) JSP独立开发年代 jsp-smartupload ---- JSP Model1
jspSmartUpload是一个可免费使用的全功能的文件上传下载组件，适于嵌入执行上传下载操作的JSP文件中。
2) JSP+Servlet 开发web应用 Apache commons-fileupload ---- JSP Model2
FileUpload 是 Apache commons下面的一个子项目，用来实现Java环境下面的文件上传功能，与常见的SmartUpload齐名。
3) Servlet3.0规范中提供对文件上传的支持

Apache commons-fileupload 使用
1) 去 http://commons.apache.org/fileupload/ 下载fileupload jar包
同时下载 commons-fileupload 和  commons-io 两个包  -------- fileupload依赖io包
2) 将jar包导入 web 工程WEB-INF/lib下
3) 编程实现
步骤一：获得DiskFileItemFactory文件项工厂 DiskFileItemFactory factory=new DiskFileItemFactory();
步骤二：通过工厂获得文件上传请求核心解析类 ServletFileUpload   ServletFileUpload fileUpload=new ServletFileUpload(factory);
步骤三：使用ServletFileUpload对request进行解析---- 获得很多个FileItem    List<FileItem> list=fileUpload.parseRequest(request);
步骤四：对每个FileItem进行操作判断FileItem是不是普通字段 isFormField    for(FileItem item:list){ if(item.isFormField){...}}
代表普通字段FileItem
　　getFieldName();  ---- 获得表单项name属性  String name=item.getFieldName();
　　getString(); ----- 获得表单项value   String value=item.getString();

代表文件上传FileItem
　　getInputStream() --- 获得文件内容输入流   InputStream in=item.getInputStream();
　　getName() ------ 获得上传文件名称    String fileName=item.getName();

　　　　　　　　　　　　　　　　　　　OutputStream out=new FileOutputStream(this.getServletContextt.getReanPath("upload/"+filename));

　　　　　　　　　　　　　　　　　　　byte[] bs=new byte[1024]; int i=0;

　　　　　　　　　　　　　　　　　　　while((i=in.read(bs))!=-1){out.write(bs,0,i);}

问题：早期IE6 浏览器提交，上传文件时，请求中存放是客户端完整路径 ----- 在服务器端保存文件时，需要切掉客户端路径，只保留文件名
int index = filename.lastIndexOf("\\");
if (index != -1) {
    filename = filename.substring(index + 1);// 获得真实文件名
}
二、commons-fileupload 核心API 分析
1、DiskFileItemFactory 磁盘文件项工厂类  factory.下面的方法
public DiskFileItemFactory(int sizeThreshold, java.io.File repository)  构造工厂时，指定内存缓冲区大小和临时文件存放位置
public void setSizeThreshold(int sizeThreshold) 设置内存缓冲区大小，默认10K
public void setRepository(java.io.File repository)设置临时文件存放位置，默认System.getProperty("java.io.tmpdir").

内存缓冲区： 上传文件时，上传文件的内容优先保存在内存缓冲区中，当上传文件大小超过缓冲区大小，就会在服务器端产生临时文件
临时文件存放位置： 保存超过了内存缓冲区大小上传文件而产生临时文件
* 产生临时文件可以通过FileItem的delete方法删除

2、ServletFileUpload 文件上传核心类   fileupload.下面的方法
static boolean  isMultipartContent(javax.servlet.http.HttpServletRequest request)  判断request的编码方式是否为multipart/form-data

java.util.List     parseRequest(javax.servlet.http.HttpServletRequest request) 解析request，将请求体每个部分封装FileItem对象，返回List<FileItem>

void setFileSizeMax(long fileSizeMax) 设置单个文件上传大小  和 void  setSizeMax(long sizeMax) 设置总文件上传大小

void setHeaderEncoding(java.lang.String encoding)  设置编码集 解决上传文件名乱码 *****

void setProgressListener(ProgressListener pListener) 设置文件上传监听器 （用来监控文件上传进度）
* 上传时间、剩余大小、速度、剩余时间

3、FileItem 表示文件上传表单中每个数据部分  item.下面的方法
boolean isFormField()  判断该数据项是否为文件上传项，true 不是文件上传 false 是文件上传
if(fileItem.isFormField()){
   // 不是上传项
   java.lang.String getFieldName()  获得普通表单项name属性
   java.lang.String getString() / java.lang.String getString(java.lang.String encoding) 获得普通表单项value属性 传入编码集用来解决输入value乱码
}else{
   // 是上传项
   java.lang.String getName() 获得上传文件名 （注意IE6存在路径）
   java.io.InputStream     getInputStream() 获得上传文件内容输入流
   // 上传文件
   void delete()  删除临时文件（删除时，必须要管理输入输出流）
}

注意事项：因为文件上传表单采用编码方式multipart/form-data 与传统url编码不同，所有getParameter 方法不能使用 setCharacterEncoding 无法解决输入项乱码问题

四 上传文件注意问题
1、上传文件后，在服务器端保存位置
第一类存放位置：直接存放WebRoot目录下 和 除WEB-INF META-INF的其它子目录下  例如: WebRoot/upload
* 客户端可以直接在浏览器上通过url访问位置（资料无需通过权限控制，而可以直接访问） ---- 对上传资源安全性要求不高、或者资源需要用户直接可见
* 例如：购物商城商品图片

第二类存放位置：放入WEB-INF及其子目录 或者 不受tomcat服务器管理目录 例如： WebRoot/WEB-INF/upload 、c:\ 、d:\abc
* 客户端无法通过URL直接访问，必须由服务器内部程序才能读取 （安全性较高，可以很容易添加权限控制）
* 例如：会员制在线视频

2、上传文件在同一个目录重名问题
如果文件重名，后上传文件就会覆盖先上传文件

文件名 UUID
filename = UUID.randomUUID().toString() + "_" + filename;

3、为了防止同一个目录下方上传文件数量过多 ---- 必须采用目录分离算法
1) 按照上传时间进行目录分离 （周、月 ）
2) 按照上传用户进行目录分离 ----- 为每个用户建立单独目录
3) 按照固定数量进行目录分离 ------ 假设每个目录只能存放3000个文件 ，每当一个目录存满3000个文件后，创建一个新的目录
4) 按照唯一文件名的hashcode 进行目录分离  
    public static String generateRandomDir(String uuidFileName) {
        // 获得唯一文件名的hashcode
        int hashcode = uuidFileName.hashCode();
        // 获得一级目录
        int d1 = hashcode & 0xf;
        // 获得二级目录
        int d2 = (hashcode >>> 4) & 0xf;

        return "/" + d2 + "/" + d1;// 共有256目录
    }

4、乱码问题
普通编写项 value属性乱码 ------------- fileItem.getString(编码集);
上传文件项 文件名乱码 --------- fileupload.setHeaderEncoding(编码集);

=========================================================================================================================
五、上传文件的进度监控
ServletFileUpload 类 提供 public void setProgressListener(ProgressListener pListener)
* 为文件上传程序绑定一个监听器对象，通过监听器可以监听文件上传全过程
* 和AJAX技术结合，编写文件上传进度条

设置监听器，文件上传程序会自动执行 监听器中 update方法 public void update(long pBytesRead, long pContentLength, int pItems)

在方法中可以获得 文件总大小、已经上传大小和 上传第几个元素

能否根据上面三个参数计算：剩余大小、传输速度、已用时间、剩余时间
1) 已用时间 = 当前时间 - 开始时间
2) 速度 = 已经上传大小/已用时间
3) 剩余大小 = 总大小- 已经上传大小
4) 剩余时间 = 剩余大小/速度

六、文件下载
将服务器端文件下载到客户端  

常见文件下载有两种编写方式
1、超链接直接指向下载资源
如果文件格式浏览器识别，将直接打开文件，显示在浏览器上， 如果文件格式浏览器不识别，将弹出下载窗口
对于浏览器识别格式的文件，通过另存为进行下载

客户端访问服务器静态资源文件时，静态资源文件是通过 缺省Servlet返回的，在tomcat配置文件conf/web.xml 找到 --- org.apache.catalina.servlets.DefaultServlet

2、编写服务器程序，读取服务器端文件，完成下载
必须设置两个头信息 ，来自MIME协议  Content-Type  Content-Disposition

response.setContentType(getServletContext().getMimeType(filename));
response.setHeader("Content-Disposition", "attachment;filename=" + filename); // 以附件形式打开，不管格式浏览器是否识别

七、下载案例：指定一个磁盘目录，通过树形结构遍历，遍历磁盘目录下及其子目录中文体 ，提供下载
* 遍历一个树形目录结构中所有文件

1、广度非递归 遍历目录中所有文件

2、使用get方式提交中文时
<a href="/day21/downloadList?path=D:\TTPmusic\何晟铭\何晟铭 - 爱的供养.mp3">何晟铭 - 爱的供养.mp3</a><br/>
问题：IE6 提交后，服务器经过get乱码处理获得 乱码
原因：IE6对中文直接进行 get提交时，进行URL编码 ---- 编码发生问题
解决：手动对get提交中文进行编码  ----- URLEncoder

3、如果下载文件是中文名，设置 response.setHeader("Content-Disposition", "attachment;filename=" + filename); 出现附件名乱码
不同浏览器处理下载附件名乱码 处理方式不同 ，例如 IE使用URL编码 、FF使用 BASE64编码

通过USER-AGENT 请求头信息字段，判断来访者浏览器类型
** 问题：火狐浏览器 在使用MimeUtility 进行Base64编码 时存在问题 ，如果字符串中没有中文，无法进行编码
解决：采用手动BASE64 编码
BASE64Encoder base64Encoder = new BASE64Encoder();
filename = "=?utf-8?B?" + base64Encoder.encode(filename.getBytes("utf-8")) + "?=";

==========================================================================================================================
综合案例： 上传下载系统
需求：
1、系统提供一个文件上传功能，在用户上传文件后，文件保存在服务器端指定目录，文件相关信息保存在数据库中
* 没上传一个文件，数据库中存在一条数据记录
2、系统提供一个文件下载功能，将数据表中所有资源信息，显示在页面上，允许用户进行下载

创建数据库环境
create database day21;

create table resources(
  id int primary key auto_increment,
  uuidname varchar(100) unique not null,
  realname varchar(40) not null,
  savepath varchar(100) not null,
  uploadtime timestamp ,
  description varchar(255)
);

导入jar包 、c3p0-config.xml 、JDBCUtils工具类