文件上传之 commons-fileupload

Posted 2020-06-13

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

二、介绍下 commons-FileUpload上传过程：
  首先要引入的.jar文件：
    commons-fileupload-1.2.1.jar
    commons-io-1.2.jar（此两个文件可以到官网：http://commons.apache.org/ （里面还会有帮助文档API）  下载）
   其次值得注意的是，凡是要上载文件的表单都必须设置enctype属性，且属性的值必须是multipart/form-data，同时请求方法必须是POST！！！！

1、检测request中是否包含有multipart内容（isMultipartContent(request)是它的一个静态方法）

ServletFileUpload.isMultipartContent(request)

 

2、如果有，生成DiskFileItemFactory工厂将进行相关的设置（不知道的情况下也可以不设置）

         DiskFileItemFactory factory = new DiskFileItemFactory();
        // maximum size that will be stored in memory
        factory.setSizeThreshold(4096);// 设置缓冲区大小，这里是4kb 
        // Location to save data that is larger than maxMemSize.
        factory.setRepository(new File("d:/"));// 设置临时目录 

        factory.setHeaderEncoding("UTF-8");//设置字符集 防止中文文件名乱码

3、生成上传ServletFileUpload类，并将DiskFileFactory工厂传给它，并对ServletFileUpload进行配置

       // Create a new file upload handler
        ServletFileUpload upload = new ServletFileUpload(factory);
        upload.setFileSizeMax(3*1024*1024);//设置上传文件大小3M
        upload.setSizeMax(6*1024*1024);//设置请求总文件大小6M

4、从request得到上传的文件列表,并获得其迭代器

            // Parse the request to get file items.
            List<FileItem> fileItems = upload.parseRequest(request);

            // Process the uploaded file items
            Iterator i = fileItems.iterator();

5、处理文件：写入或者其他操作

while (i.hasNext()) {
                FileItem fi = (FileItem) i.next();
                if (fi.isFormField()) {//当是表单域时，进行的处理
                    // Get the uploaded file parameters
                    String fieldName = fi.getFieldName();//得到元素的name属性的值

                   String fieldValue=fi.getString("utf-8");//得到元素的value的值
                    String fileName = fi.getName();//这里是表单域，所以得到的是null
                   
                  
                    } else {//当是文件域时，将文件保存到硬盘中

                      String basePath = request.getRealPath("/upload");

                      String contentType = fi.getContentType();
                      boolean isInMemory = fi.isInMemory();
                      long sizeInBytes = fi.getSize();

                     String fieldName = fi.getFieldName();//得到元素的name属

                      String fileName = fi.getName();//取得上传的文件名
                        file = new File(basePath+"/"+filename);

                       fi.write(file);
                    }
                   
                    out.println("Uploaded Filename: " + fileName + "<br>");
                }
            }

}

 

说明：

FileItem接口是对用户上传文件的封装

DiskFileItemFactory 实现了FileItemFactory接口，主要方法有public FileItem createItem(String fieldName, String contentType, boolean isFormField, String fileName)

ServletFileUpload从FileUpload继承，而FileUpload又从FileUploadBase继承，功能：分析传入的request对象、得到文件列表FileItemIterator……