JavaWeb 文件的上传、下载

文件上传

表单

<form action="HandlerServlet" method="post" enctype="multipart/form-data">
  请选择要上传的文件:<input type="file" name="uploadFile" accept="*/*" multiple /><br />
  <button type="submit">上传</button>
</form>

指定<form>的method="post"， enctype="multipart/form-data"。

accept指定文件类型，有多种类型时逗号分隔，multiple指定可以选择多个文件。

传统处理方式

ServletInputStream inputStream = request.getInputStream();

选择的文件是放在请求消息体中的。获取的输入流中包含了上传的所有文件，如果单个上传还好处理，如果同时上传多个，不好从中分离出单个文件的数据，且自己写代码获取文件名很麻烦。

Commons-FileUpload

Commons-FileUpload是Apache的开源组件，提供了一套处理上传文件的API。

使用FileUpload需要2个jar包：

commons-fileupload.jar
commons-io.jar 这是FileUpload依赖的IO包，要单独下载添加。

FileUpload组件主要的接口、类：

DiskFileItemFactory类将请求消息实体中的每一个参数都封装为单独的FileItem对象
ServletFileUpload类调用DiskFileItemFactory类来封装请求参数，并对封装好的FileItem做进一步处理，以List<FileItem>形式返回
FileItem接口用于封装请求参数，提供了一系列操作上传文件的方法。

DiskFileItemFactory类的常用方法

DiskFileItemFactory() //空参的构造方法，使用默认临界值、系统临时文件夹
DisFileItemfactory(int size, File repository) //带参的构造方法，指定临界值、缓存目录

FileItem createItem() //将一个请求参数封装为FileItem，并返回封装好的FileItem。这个方法由DiskFileItemFactory内部自动调用。不用我们管。

set|SizeThreshold(int size) //设置临界值
setRepository(File repository) //设置缓存目录。这2个方法都要对应的get方法。

JVM的内存是有限的，比如用户上传一个1G的文件，直接保存在JVM内存中，实打实地占用服务器内存，这绝对不行。

临界值指定文件大小，小于临界值的文件直接存储在JVM内存中，大于临界值的文件，以临时文件（.tmp）的形式保存在缓存目录中。默认为10240，默认单位Byte，即10KB。

缓存目录可以指定为磁盘上的某一个文件夹，以File形式指定，不指定时默认使用系统的临时文件夹。

ServletFileUpload类的常用方法

ServletFileUpload() //空参构造器
ServletFileUpload(FileItemFactory fileItemFactory) //带参的构造器，指定使用的FileItemFactory对象。FileItemFactory是接口，一般使用它的实现类DiskFileItemFactory（上面那个类）。

setFileItemFactory(FileItemFactory fileItemFactory)
setSizeMax(long size) //设置请求消息实体内容（传递的所有请求参数）的最大尺寸，防止用户恶意上传超大文件浪费服务器存储空间。默认单位Byte。
setFileSizeMax(long size) //设置单个文件的最大尺寸
setHeaderEncoding("utf-8") //设置请求参数的字符集，未设置时使用HttpServletRequest设置的字符集，若HttpServletRequest也未设置字符集，则使用系统默认的字符集。

以上几个setter()方法均有对应的getter()方法。

List<FileItem> parseRequest(HttpServletRequest request) //调用FileItemFactory对象的方法，开始封装每个请求参数，以List<FileItem>形式返回封装好的所有的请求参数
FileItemIterator getItemIterator(HttpServletRequest request) //同上，只是返回的是迭代器

注意：是封装每一个请求参数，不是只封装上传的文件，所以有些FileItem保存的是普通的请求字段。

FileItem接口常用的方法

boolean isFormField() //判断这个FileItem封装的是不是普通的表单字段
String getFieldName() //获取字段名，即表单控件的name属性
String getName() //获取上传文件的文件名（带有后缀，比如：1.jpg），如果封装的是普通的表单字段，得到是null
long getSize() //获取文件的大小，默认单位字节
String getContentType() //获取文件类型，比如image/jpeg
boolean isInMemory() //是否存储在JVM内存中。如果存储在内存中，返回true；存储在缓存目录中，返回false。

void write(File file) //将上传文件写到服务器的磁盘中。如果此文件是存储在缓存目录中的，写完会自动删除缓存目录中对应的临时文件。
InputStream getInputStream() //获取输入流
void delete() //清除FileItem存储的主体内容，如果存储在缓存目录中，会删除缓存目录中对应的临时文件。虽然GC会自动清除不再使用的临时文件，但使用完立即删除是最好的。

Servlet处理上传文件示例

 protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

         response.setContentType("text/html;charset=utf-8");

         //创建FileItemFactory对象

         DiskFileItemFactory diskFileItemFactory = new DiskFileItemFactory();

         File tempFolder=new File("E:/tempFolder");   //Java中的File即指文件，又指文件夹

         if (!tempFolder.exists()){  //不存在就新建

             tempFolder.mkdir();

         }

         //指定缓存目录

         diskFileItemFactory.setRepository(tempFolder);  

         //创建ServletFileUpload对象

         ServletFileUpload servletFileUpload = new ServletFileUpload(diskFileItemFactory);

         //指定编码字符集

         servletFileUpload.setHeaderEncoding("utf-8");

         try {

             //获取List<FileItem>

             List<FileItem> fileItems = servletFileUpload.parseRequest(request);

             for (FileItem fileItem:fileItems){

                 if(!fileItem.isFormField()){  //是上传文件

                     //使用UUID创建唯一的文件名

                     String fileName= UUID.randomUUID().toString()+"_"+fileItem.getName();

                     String path="C:/Users/chy/Desktop/upload/"+fileName;

                     fileItem.write(new File(path));  //写到服务器磁盘上。写完会自动删除临时文件。

                 }

             }

         } catch (FileUploadException e) {

             e.printStackTrace();

         } catch (Exception e) {

             e.printStackTrace();

         }

     }

防止文件重名，有2种方式

在文件名中加时间戳（毫秒）。当并发量很大时，依然可能出现重名。
在文件名中加UUID.randomUUID().toString() 。

UUID即通用唯一识别码，能唯一标识某个东西。

UUID产生的这个字符串包含32个十六进制数，用4根连词线-分为5段，示例： bd95572b-7fcf-46b2-ae3e-6087d66db40f ，8-4-4-4-12的形式。

文件下载

最简单的方式：使用<a>标签直接链接到文件地址。

<a href="http://www.xxx.com/resource/特斯拉.mp4">下载xxx</a>

有2个问题：

某些类型的文件，比如jpg、mp3、mp4、txt等会直接在网页中打开、播放，而非下载。
如果以后资源地址换了，比如换ftp服务器了、改资源路径了，需要一个个地修改<a>连接的href属性，十分麻烦。

解决方式：

（1）链接到Servlet，并传递文件名。

<a href="downloadServlet?fileName=特斯拉.mp4">下载xxx</a>

（2）Servlet

 protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

         request.setCharacterEncoding("utf-8");

         response.setContentType("text/html;charset=utf-8");

         String fileName = request.getParameter("fileName");

         //对文件名进行iso8859-1编码

         String browerFileName=new String(fileName.getBytes("utf-8"),"iso8859-1");



         //指定浏览器行为为下载

         response.addHeader("Content-Type","application/octet-stream");

         //指定下载文件名。注意这两个都是addHeader()，不是setHeader()

         response.addHeader("Content-Disposition","attachment;filename="+browerFileName);

         InputStream is = getServletContext().getResourceAsStream("resource/"+fileName);  //换路径时只需修改此句中的路径，不用修改每个<a>

         ServletOutputStream os= response.getOutputStream();

         byte[] buffer = new byte[1024];

         int len;

         while ((len=is.read(buffer))!= -1){  //注意是-1，不是0

             os.write(buffer);

         }

     }

红字是为了解决下载文件名中文乱码。

因为我们使用的是utf-8字符集，而chrome这些浏览器默认使用 iso8859-1 字符集。要转换一下，这样浏览器在设置下载文件名时才能识别文件名中的中文。

其实 <a href="downloadServlet?fileName=特斯拉.mp4">下载xxx</a> ，url中的中文也要转换一下，一个中文字符转换为%xxxx的形式（%后面跟着4个十六进制数）。

<a href="downloadServlet?fileName=<%=URLEncoder.encode("特斯拉.mp4","utf-8")%>">下载</a>

String URLEncoder.encode(String str, String charset) //静态方法，返回编码后的字符串

当然，不转换也行，都能正确识别。