fileupload文件上传用法概述

目录
    1、文件上传表单 和 普通文本表单 的区别
    2、文件上传对页面的要求
    3、文件上传对Servlet的要求
    4、fileupload概述
    5、fileupload简单应用
    6、fileupload上传示例
================================================================
文件上传概述

1、文件上传表单 和 普通文本表单 的区别
    文件上传表单：<form action="" method="post" enctype="multipart/form-data">
        -- 表示多部件表单数据,使用流上传数据。
    普通文本表单：（可以不设置enctype属性）
        -- 当method="get"时，enctype的默认值为null，没有正文，所以就不需要enctype了。
        -- 当method="post"时，enctype的默认值为"application/x-www-form-urlencoded"，表示使用url编码正文；

2、文件上传对页面的要求
    1)必须使用表单，而不能是超链接；
    2)表单的method必须是POST，而不能是GET；
    3)表单的enctype属性必须是"multipart/form-data"
    4)在表单中添加file表单字段，即<input type="file" name="xxx"/>
    例如：
    <form action="${pageContext.request.contextPath }/FileUploadServlet" 
  method="post" enctype="multipart/form-data">
        用户名：<input type="text" name="username"/><br/>
        文件1：<input type="file" name="file1"/><br/>
        文件2：<input type="file" name="file2"/><br/>
        <input type="submit" value="提交"/>
    </form>

3、文件上传对Servlet的要求
    表单是文件上传表单时，对Servlet也是有要求的。文件上传表单的数据也是被封装到request对象中的。
    request.getParameter(String)方法获取指定的表单项字符内容，但文件上传表单已不在是字符内容而是字节内容，所以失效。
    使用 ServletInputStream  request.getInputStream()方法获取整个表单内容放到IO流中，它是InputStream接口的子类，
    这个ServletInputStream对象对应整个表单的正文部分（按F12 查看请求信息是从第一个分隔线开始，到最后），
    这说明我们需要的解析流中的数据。
    当然解析它是很麻烦的一件事情，而Apache已经帮我们提供了解析它的工具：commons-fileupload。

　　可以尝试把request.getInputStream()这个流中的内容打印出来，再对比httpWatch中的请求数据。
    public void doPost(HttpServletRequest request, HttpServletResponse response) throws Exception {
        InputStream in = request.getInputStream();
        String s = IOUtils.toString(in);
        System.out.println(s);
    }
    Servlet的要求小结：
        (1)方法 request.getParameter() 失效，无法获取表单数据；
        (2)使用 request.getInputStream()得到所有的表单数据，而不是一个表单项的数据；
        (3)这说明如果不使用fileupload，我们就需要自己来对 request.getInputStream() 的内容进行解析！！！

4、fileupload概述
    fileupload是由apache的commons组件提供的上传组件。它最主要的工作就是帮我们解析request.getInputStream()。
    fileupload组件需要的JAR包有：
        commons-fileupload.jar，核心包；
        commons-io.jar，依赖包。
5、fileupload简单应用
    fileupload的核心类有：DiskFileItemFactory、ServletFileUpload、FileItem。
    使用fileupload组件的步骤如下：
    1.创建工厂类DiskFileItemFactory对象：DiskFileItemFactory factory = new DiskFileItemFactory();
    2.使用工厂创建解析器对象：ServletFileUpload fileUpload = new ServletFileUpload(factory);
    3.使用解析器来解析request对象：List<FileItem> list = fileUpload.parseRequest(request);

    隆重介绍FileItem类，它才是我们最终要的结果。一个FileItem对象对应一个表单项（表单字段）。
    一个表单中存在文件字段和普通字段，可以使用FileItem类的isFormField()方法来判断表单字段是否为普通字段，
    如果不是普通字段，那么就是文件字段了。
        * boolean isFormField()：判断当前表单字段是否为普通文本字段，true表示普通表单项；false表示文件表单项；
        --------------------
        * String getFieldName()：获取字段名称，例如：<input type="text" name="username"/>，返回的是username；
        * String getString()：获取字段的内容，如果是文件字段，那么获取的是文件内容，当然上传的文件必须是文本文件；
        --------------------
        * String getName()：获取文件字段的文件名称；
        * String getContentType()：获取上传的文件的类型，例如：text/plain
        * int getSize()：获取上传文件的大小；
        * InputStream getInputStream()：获取上传文件对应的输入流；
        * void write(File)：把上传的文件保存到指定文件中。
6、fileupload上传示例
    需求：写一个简单的上传示例：
        * 表单包含一个用户名字段，以及一个文件字段；
        * Servlet保存上传的文件到uploads目录，显示用户名，文件名，文件大小，文件类型。
    步骤：
        第一步：
            完成index.jsp，只需要一个表单。注意表单必须是post的，而且enctype必须是mulitpart/form-data的。
            <form action="/FileUploadServlet" method="post" enctype="multipart/form-data">
                用户名：<input type="text" name="username"/><br/>
                文件1：<input type="file" name="file1"/><br/>
                <input type="submit" value="提交"/>
            </form>

        第二步：
            完成 FileUploadServlet
            public void doPost(HttpServletRequest request, HttpServletResponse response) throws Exception {
                request.setCharacterEncoding("utf-8");
                response.setContentType("text/html;charset=utf-8");
                /**
                * 1、创建工厂
                * 2、创建解析器
                * 3、得到文件列表
                */

                // 1、创建工厂
                DiskFileItemFactory dfif = new DiskFileItemFactory();
                //设置缓存大小及目录
                // DiskFileItemFactory dfif = new DiskFileItemFactory(1024*20, new File("F:\\temp"));
                // 2、使用工厂创建解析器对象
                ServletFileUpload fileUpload = new ServletFileUpload(dfif);
                // 3、使用解析器对象解析request，得到FileItem列表
                List<FileItem> list = fileUpload.parseRequest(request);

                for(FileItem fileItem : list) {
                    if(fileItem.isFormField()) {  //判断是否为普通表单项
                        String fieldName = fileItem.getFieldName();// 获取当前表单项的字段名称
                        if(fieldName.equals("username")) {
                            response.getWriter().print("用户名：" + fileItem.getString() + "<br/>");
                        }
                    }else{  //如果当前表单项不是普通表单项，说明就是文件表单项
                        String fileName = fileItem.getName();//获取上传文件的名称
                        // 如果上传的文件名称为空，即没有指定上传文件
                        if(fileName == null || fileName.isEmpty()) {
                            continue;
                        }
                        // 获取真实路径，对应${项目目录}/uploads，当然，这个目录必须存在
                        String savepath = this.getServletContext().getRealPath("/WEB-INF/uploads");
                        // 通过uploads目录和文件名称来创建File对象
                        File file = new File(savepath, fileName);
                        fileItem.write(file); // 把上传文件保存到指定位置
                        response.getWriter().print("上传文件名：" + fileName + "<br/>");
                        response.getWriter().print("上传文件大小：" + fileItem.getSize() + "<br/>");
                        response.getWriter().print("上传文件类型：" + fileItem.getContentType() + "<br/>");
                    }
                }
            }