基于表单的文件上传

如果在表单中使用表单元素 <input type=“file” />，浏览器在解析表单时，会自动生成一个输入框和一个按钮，输入框可供用户填写本地文件的文件名和路径名，按钮可以让浏览器打开一个文件选择框供用户选择文件：



当表单需要上传文件时，需指定表单 enctype 的值为 multipart/form-data

在 form 元素的语法中，enctype 属性指定将数据发送到服务器时浏览器使用的编码类型。 

enctype 属性取值:

application/x-www-form-urlencoded：表单 enctype 属性的默认值。这种编码方案使用有限的字符集，当使用了非字母和数字时，必须用”%HH”代替(H 代表十六进制数字)。对于大容量的二进制数据或包含非 ASCII 字符的文本来说，这种编码不能满足要求。

multipart/form-data：form 设定了enctype=“multipart/form-data”属性后，表示表单以二进制传输数据 .



Commons-fileupload 组件上传的基本原理

FileUpload组件将页面提交的所有元素(普通form表单域，如text和文件域file)都看作一样的FileItem，这样上传页面提交的 request请求也就是一个FileItem的有序组合，FileUpload组件可以解析该request，并返回一个一个的FileItem。而对每一个FileItem，FileUpload组件可以判断出它是普通form表单域还是文件file域，从而根据不同的类型，采取不同的操作－－如果是表单域，就读出其值，如果是文件域，就保存文件到服务器硬盘上或者内存中



Commons-fileupload 组件API

ServletFileUpload 负责处理上传的文件数据，并将每部分的数据封装成一到 FileItem 对象中。

DiskFileItemFactory 是创建 FileItem 对象的工厂，在这个工厂类中可以配置内存缓冲区大小和存放临时文件的目录。

ServletFileUpload 在接收上传文件数据时，会将内容保存到内存缓存区中，如果文件内容超过了 DiskFileItemFactory 指定的缓冲区的大小，那么文件将被保存到磁盘上，存储为 DiskFileItemFactory 指定目录中的临时文件。等文件数据都接收完毕后，ServletUpload 在从文件中将数据写入到上传文件目录下的文件中





进行文件上传和下载的具体操作：

首先，加载必要的jar包：“commons-fileupload-1.2.1.jar”，“commons-io-1.4.jar”

步骤：

0. 创建 FileItemFactory 子类 DiskFileItemFactory 的对象

1.为了得到 ServletFileUpload 对象, 先需要得到 FileItemFactory 的一个对象, 然后调用 new ServletFileUpload(FileItemFactory fif); 方法得到 ServletFileUpload 对象

2.为了得到 FileItem 的集合， 先需要得到 ServletFileUpload 对象， 然后调用该对象的 parseRequest() 方法得到 FileItem 的 List

3.从 HttpServletRequest 对象中得到 FileItem 的集合

4. 对上述集合进行遍历：判断是表单域还是文件域



下面是对文件上传相关操作的代码示例。

//1. 验证是否使用 FileUpload 组件

        boolean isMultipart = ServletFileUpload.isMultipartContent(request);



        //2.1  不使用

        if(!isMultipart){

            response.getWriter().println("没有文件域");

            return;

        }



        //2.2 使用



        //3. 获取 DiskFileItemFactory 对象

        DiskFileItemFactory itemFactory = new DiskFileItemFactory();



        //4. 获取 ServletFileUpload 对象

        ServletFileUpload fileUpload = new ServletFileUpload();

        fileUpload.setFileItemFactory(itemFactory);

        设置上传文件的最大大小

        fileUpload.setFileSizeMax(1000 * 100);



        String forwardPage = null;



        try {

            //5. 调用 ServletFileUpload 的 parseRequest() 方法, 获取 FileItem 的集合

            List<FileItem> items = fileUpload.parseRequest(request);



            Map<String, String> paramMap = new HashMap<String, String>();

            FileItem fileItem = null;



            //6. 对 5 获取的集合进行遍历

            Iterator<FileItem> it = items.iterator();

            while(it.hasNext()){

                FileItem item = it.next();

                //7. 验证是否为表单域

                if(item.isFormField()){

                    //7.1 是表单域, 把获取到得 表单域的 fieldName 和 value 放在 map 中.

  获得表单中该字段的字段名

                    String fieldName = item.getFieldName();

获得表单中与上面字段名对应的字段值

                    String value = item.getString("UTF-8");



                    paramMap.put(fieldName, value);

                }

                    //7.2 不是表单域, 即为文件域. 获取 FileItem 对象, 注意限制条件.

                else{

这里获得了与file对应的FileItem对象

                    fileItem = item;

                }



            }



            //8. 对 7.2 获取的 FileItem 对象进行文件上传操作.

            //10.1 获取全路径名

            String path = null;



            path = this.getServletContext().getRealPath("/photoes");



            File photoesDir = new File(path);

            if(!photoesDir.exists()){

                photoesDir.mkdir();

            }



            path = path + "/" + paramMap.get("username");



            File file = new File(path + ".jpg");



            //10.2 上传操作，把用户在页面上传的文件保存到服务器

            fileItem.write(file);



上传文件表单的两个准备工作

1. 提交方式改为 POST

2. enctype 属性的取值改为 multipart/form-data



在获取表单值时

1. 不能使用 request.getParameter() 方法, 因为该方法仅能获取字符串, 对二进制无能为力.

2. 使用 fileUpload 组件读取上传文件及表单域字段.



fileUpload 组件的核心思想

fileUpload 组件认为: 所有的表单域(包含文件域和文本域)都是 FileItem 对象.

步骤:

1. 获取 FileItem 对象组成的 List

2. 对 List 进行遍历

3. 判断每一个  FileItem 对象是表单域 还是 文件域, 以进行不同的处理.



详细步骤:

1. 检查表单的 enctype 是否为 multipart/form-data, 以决定是否使用 FileUpload 组件进行解析请求

2. 若表单的 enctype 是否为 multipart/form-data, 则需要获取 封装了所有表单域 的对应的 FileItem 对象的 List: List<FileItem> list = null;

   3) 获取 ServletFileUpload 对象,　调用该对象的 public java.util.List parseRequest(javax.servlet.http.HttpServletRequest request)

               方法获取封装 FileItem 的List

   2) 需要使用 ServletFileUpload 的构造器来创建 ServletFileUpload 对象:

      ^ 使用任意一个构造器都可以得到 ServletFileUpload 对象, 但都需要先得到 FileItemFactory 对象

      * ServletFileUpload upload = new ServletFileUpload();

          upload.setFileItemFactory(factory);

        * ServletFileUpload upload = new ServletFileUpload(factory);

   1) 创建 FileItemFactory 接口是想类对象: DiskFileItemFactory, 直接创建该对象.

3. 可以调用 DiskFileItemFactory 的相关方法来对文件上传进行一些优化:

   1) setSizeThreshold(int sizeThreshold)：设置使用临时文件夹的大小.

   2) setRepository(): 设置临时文件夹

4. 可以调用 ServletUpload 的方法进行文件上传的一些控制

   1) setFileSizeMax: 设置单个文件的最大上传值

   2) setSizeMax：设置总上传文件的最大值, 以 byte 为单位.

5. 关于中文乱码的问题:

   1) 在解析 request 之前: request.setCharacterEncoding("UTF-8"); 可以解决文件域的乱码问题

   2) 在解析表单域时需要使用: new String(value.getBytes("iso-8859-1"), "UTF-8"); 解决中文乱码问题.

但是有时候，即使我们按照上面方式设置了，可以还是中文乱码，这个时候问题多半就出在tomcat的配置上了，打开tomcat的service.xml文件，在那里面注意下面部分

 <Connector port="8989" protocol="HTTP/1.1"

               connectionTimeout="20000"

               redirectPort="8443" useBodyEncodingForURI="true"/>

只有加上了红色部分的设置，我们在程序中配置EncodingUrl才能起作用。



下面一段代码是文件下载的相关操作

//1. 设置响应报头 contentType: application/x-msdownload -->

        //   告诉浏览器其所输出的内容的类型不是普通的文本文件或 HTML 文件，而是一个要保存到本地的下载文件

        //response.setHeader("conent-type", "application/x-msdownload");

        response.setContentType("application/x-msdownload");



        //2. 设置响应抱头 Content-Disposition: attachment -->

        //   Web 服务器希望浏览器不直接处理相应的实体内容，而是由用户选择将相应的实体内容保存到一个文件中

        response.setHeader("Content-Disposition", "attachment; filename=haha.ppt");



        //3. 利用 response.getOutputStream() 进行 io 操作

        OutputStream os = response.getOutputStream();

        BufferedOutputStream bos = new BufferedOutputStream(os);



        //文件的输入流

        InputStream is = null;

        is = new FileInputStream("E:\\source\\090515\\javaee\\fileupload\\fileUpload.ppt");

        BufferedInputStream bis = new BufferedInputStream(is);



        int length = 0;

        byte [] temp = new byte[1 * 1024 * 10];

        while((length = bis.read(temp)) != -1){

            bos.write(temp, 0, length);

            System.out.println("循环操作中...");

        }



        bis.close();

        bos.close();



但是上面的这种方式无法被迅雷之类的下载工具下载，如果希望被迅雷之类的东西下载，就直接这么写就可以了

request.getRequestDispatcher("/data/fileUpload.ppt")

            .forward(request, response);