JavaWeb - 文件的上传与下载（传智播客）

上传

文件上传的概述

1.上传对表单的限制

• method=”post”
• enctype=”multipart/form-data”
• 表单中需要添加文件表单项

<form action="xxx" method="post" enctype="multipart/form-data">
    用户名：<input type="text" name="username" /><br/>
    照片：<input type="file" name="zhaoPian" /><br/>
    <input type="submit" value="上传" />
</form>

2.上传对Servlet的限制

• request.getParameter(“xxx”);这个方法在表单为enctype=”multipart/form-data”时，它作废了，它永远返回null
• ServletInputStream request.getInputStream();包含整个请求的体

---

多部件表单的体
1.分隔出多个部件，即一个表单项一个部件。
2.一个部件中自己包含请求头和空行，以及请求体。
3.普通表单项：

• 1个头：Content-Disposition：包含name=”xxx”，即表单项名称
• 体就是表单项的值

4.文件表单项：
2个头：
- Content-Desposition：包含name=”xxxx”，即表单项名称：还有一个filename=”xxx”，表示上传文件的名称
- Content-Type：它是上传文件的MIME类型，例如：image/pjpeg，表示上传的是图片，图上中jpg扩展名的图片

---

commons-fileupload

• commons-fileupload.jar
• commons-io.jar
  这个小组件，它会帮我们解析request中的上传数据，解析后的结果是一个表单项数据封装到一个FileItem对象中。我们只需要调用FileItem的方法即可！

---

1.上传三步：
相关类：

• 工厂：DiskFileItemFactory
  
  • 解析器：ServletFileUpload
  • 表单项：FileItem

1). 创建工厂：DiskFileItemFactory factory = new DiskFileItemFactory();
2). 创建解析器：ServletFileUpload sfu = new ServletFileUpload(factory);
3). 使用解析器来解析request，得到FileItem集合：List< FileItem> fileItemList = sfu.paraseRequest(request);

2.FileItem:

• boolean isFormField()：是否为普通表单项！返回true为普通表单项，如果为false即为文件表单项
• String getFieldName()：返回当前表单项的名称
• String getString(String charset)：返回表单项的值，普通表单项的值都是字符串，通常charset是UTF-8
• String getName()：返回上传的文件名称
• long getSize()：返回上传文件的字节数
• InputStream getInputStream()：返回上传文件对应的输入流
• void write(File destFile)：把上传的文件内容保存到指定的文件中

---

文件上传的代码演示：
JSP：

<h4>文件上传演示2</h4>
<form action="Upload2Servlet" method="post" enctype="multipart/form-data">
    用户名：<input type="text" name="username" /><br/>
    照  片：<input type="file" name="file" /><br/>
    <input type="submit" value="上传" />
</form>

Servlet：

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

        /**
         * 
         * 上传三部
         * 1.得到工厂
         * 2.利用工厂，创建解析器
         * 3.解析request，得到FileItem集合
         * 4.遍历FileItem集合调用API函数完成文件的保存
         */

        DiskFileItemFactory factory = new DiskFileItemFactory();
        ServletFileUpload sfu = new ServletFileUpload(factory);
        try {
            List<FileItem> fileItemList = sfu.parseRequest(request);
            FileItem fi1 = fileItemList.get(0);
            FileItem fi2 = fileItemList.get(1);

            System.out.println("普通表单项演示：");
            System.out.println(fi1.getFieldName() + ":" + fi1.getString("UTF-8"));

            System.out.println("文件表单项演示：");
            System.out.println(fi2.getContentType());
            System.out.println(fi2.getSize());
            File file = new File("d:/lalal.jpg");
            fi2.write(file);
        } catch (FileUploadException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (Exception e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
    }

文件上传的细节

1.文件必须保存到WEB-INF下

• 目的是不让浏览器直接访问到
• 把文件保存到WEB-INF目录下

2.文件名称相关信息

• 有的浏览器上传的文件名是绝对路径，这需要切割！c:\files\baibing.jpg

String filename = fi2.getName();
Int index = filename.lastIndexOf("\\");
if(index != -1){
    filename = filename.subString(index + 1);
}

• 文件名乱码或者普通表单项乱码：
  
  • request.setCharactorEncoding(“UTF-8”);//优先级低。但因为fileupload内部会调用request.getCharacterEncoding();，所以这个方法也是有效的
  • servletFileUpload.setHeaderEncoding(“utf-8”);//优先级高
• 文件同名问题：我们需要为每个文件添加名称前缀，这个前缀要保证不能重复。uuid
  filename = CommonUtils.uuid() + “_” + filename;

3.目录打散

不建议在同一个目录下存放太多文件

• 首字符打散：使用文件的首字母作为目录名称，例如：abc.txt，那么我们把文件保存到a目录下。如果a目录这时不存在，那么创建。
• 事件打散：使用当前日期作为目录
• 哈希打散
  
  • 通过文件名称得到int值，即调用hashCode()方法
  • 把它的int值转换成16进制0~9，A~F。int值是4字节32位，一个十六进制数是4位的，所以最多有8个十六进制数，一个十六进制数代表一个文件夹
  • 获取十六进制的前两位用来生成目录，目录为二层

---

示例：
Servlet：

protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        request.setCharacterEncoding("UTF-8");
        DiskFileItemFactory factory = new DiskFileItemFactory();
        ServletFileUpload sfu = new ServletFileUpload(factory);
        try {
            List<FileItem> fileItemList = sfu.parseRequest(request);
            FileItem fi = fileItemList.get(1);

            //切割路径文件名
            String filename = fi.getName();
            int index = filename.lastIndexOf("\\");
            if(index != -1){
                filename = filename.substring(index + 1);               
            }

            //处理同名问题，添加uuid
            String savename = CommonUtils.uuid() + "_" + filename;


            /**
             * 生成二层目录
             * 1.得到文件名称
             * 2.得到hashCode
             * 3.转成十六进制
             * 4.获取前两个字符用来生成目录
             */
            //1.得到文件保存的路径
            String root = this.getServletContext().getRealPath("/WEB-INF/files/");
            //2.得到hashCode
            int hashCode = filename.hashCode();
            String hex = Integer.toHexString(hashCode);

            //System.out.println(root);D:\workspace\.metadata\.plugins\org.eclipse.wst.server.core\tmp0\wtpwebapps\myFileUpload\WEB-INF\files
            //3.获取hex的前两个字母，与root连接在一起，生成一个完成的路径
            File dirFile = new File(root, hex.charAt(0) + "/" + hex.charAt(1));
            //4.创建目录链
            dirFile.mkdirs();
            //5.创建目录文件
            File destFile = new File(dirFile, savename);
            //6.保存 
            fi.write(destFile);

        } catch (FileUploadException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (Exception e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }

    }

4.上传文件的大小限制

• 单个文件大小限制
  
  • sfu.setFileSizeMax(100 * 1024)：限制单个文件大小为100KB
  • 上面的方法调用，必须在解析开始之前调用
  • 如果上传的文件超出限制，在parseRequest()方法执行时，会抛出异常！FileUploadBase.FileSizeLimitExceededException
• 整个请求所有数据大小限制
  
  • sfu.setSizeMax(1024 * 1024);//限制整个表单大小为1M
  • 这个方法也是必须在parseRequest()方法之前调用
  • 如果上传的文件超出限制，在parseRequest()方法执行时，会抛出异常！FileUploadBase.SizeLimitExceededException

---

实例：

DiskFileItemFactory factory = new DiskFileItemFactory();
ServletFileUpload sfu = new ServletFileUpload(factory);

//限制单个文件大小为100k
sfu.setFileSizeMax(100 * 1024);
//限制整个表单大小为1M
sfu.setSizeMax(1024 * 1024);

try{
    List<FileItem> fileItemList = sfu.parseRequest(request);
}catch(){}

5.缓存大小与临时目录

• 缓存大小：超出多大，才向硬盘保存！默认为10KB
• 临时目录：向硬盘的什么目录保存
  设置缓存大小与临时目录：new DiskFileItemFactory(20 * 1024, new File(“F:/temp”));

下载

下载基本知识

1.下载就是向客户端响应字节数据
原来我们响应的都是html的字符数据
把一个文件变成字节数组，使用response.getOutputStream()来响应给浏览器

2.下载的要求
两个头一个流

• Content-Type：你传递给客户端的文件是什么MIME类型，例如：image/pjpeg
• Content-Disposition：它的默认值为inline，表示在浏览器窗口中打开
  attachment;filename=xxx，表示下载文件，filename是弹出下载框中的文件名
• 流：要下载的文件数据

---

示例：
Servlet：

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // TODO Auto-generated method stub
        String filename = "F:/我的音乐很少/网易云音乐下载/Adam Lambert - Trespassing.mp3";
        String contentType = this.getServletContext().getMimeType(filename);    
        String contentDisposition = "attachment;filename=haha.mp3";

        //一个流
        FileInputStream input = new FileInputStream(filename);
        //设置头
        response.setHeader("Content-Type", contentType);
        response.setHeader("Content-Disposition", contentDisposition);

        ServletOutputStream output = response.getOutputStream();
        IOUtils.copy(input, output);
    }

下载的细节

显示在下载框中的中文名称时，会出现乱码。

• FireFox：Base64编码
• 其他大部分浏览器：URL编码

通用方案：filename = new String(filename.getByte(“GBK”), “ISO-8859-1”);
但这种通用方案在文件名称中含有一些特殊字符的时候可能结果会不如人意，所以我们还是要使用浏览器对应的编码

public class DownUtils{
    public static String filenameEncoding(String filename, HttpServletRequest request) throws IOException{
        String agent = request.getHeader("User-Agent");//获取浏览器
        if(agent.contains("Firefox")){
            BASE64Encoder base64Encoder = new BASE64Encoder();
            filename = "=?utf-8?B?" + base64Encoder.encode(filename.getBytes("utf-8")) + "?=";
        }else if(agent.contains("MSIE")){
            filename = URLEncoder.encode(filename, "utf-8");
        }else{
            filename = URLEncoder.encode(filename, "utf-8");
        }
        return filename;
    }
}

---

示例：
Servlet：

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // TODO Auto-generated method stub
        String filename = "F:/我的音乐很少/网易云音乐下载/Adam Lambert - Trespassing.mp3";

        //为了使下载框中显示中文文件名称不出现乱码
        //String framename = new String("哈哈.mp3".getBytes("GBK"), "ISO-8859-1");
        String framename = filenameEncoding("哈哈.mp3", request);

        String contentType = this.getServletContext().getMimeType(filename);    
        String contentDisposition = "attachment;filename=" + framename;

        //一个流
        FileInputStream input = new FileInputStream(filename);
        //设置头
        response.setHeader("Content-Type", contentType);
        response.setHeader("Content-Disposition", contentDisposition);

        ServletOutputStream output = response.getOutputStream();
        IOUtils.copy(input, output);
    }