commons-fileupload-1.2.1.jar这个包是做什么用的

commons-fileupload-1.2.1.jar这个包是做什么用的

Apache的commons-fileupload.jar可方便的实现文件的上传功能




一、简单介绍
     使用最为广泛的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工厂将进行相关的设置（不知道的情况下也可以不设置）
         DiskFileItemFactoryfactory = new DiskFileItemFactory();
        // maximum size that will bestored in memory
        factory.setSizeThreshold(4096);// 设置缓冲区大小，这里是4kb 
        // Location to save datathat is larger than maxMemSize.
        factory.setRepository(newFile("d:/"));// 设置临时目录 


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


3、生成上传ServletFileUpload类，并将DiskFileFactory工厂传给它，并对ServletFileUpload进行配置
       //Create a new file upload handler
        ServletFileUpload upload = newServletFileUpload(factory);
        upload.setFileSizeMax(3*1024*1024);//设置上传文件大小3M
        upload.setSizeMax(6*1024*1024);//设置请求总文件大小6M
4、从request得到上传的文件列表,并获得其迭代器
            //Parse the request to get file items.
            ListfileItems = upload.parseRequest(request);
            //Process the uploaded file items
            Iteratori = fileItems.iterator();
5、处理文件：写入或者其他操作
while(i.hasNext()) {
                FileItemfi = (FileItem) i.next();
                if(fi.isFormField()) {//当是表单域时，进行的处理
                    //Get the uploaded file parameters
                    StringfieldName = fi.getFieldName();//得到元素的name属性的值
                   StringfieldValue=fi.getString("utf-8");//得到元素的value的值
                    StringfileName = fi.getName();//这里是表单域，所以得到的是null
                   
                  
                    }else {//当是文件域时，将文件保存到硬盘中
                      StringbasePath = request.getRealPath("/upload");
                      StringcontentType = fi.getContentType();
                      booleanisInMemory = fi.isInMemory();
                      longsizeInBytes = fi.getSize();
                     StringfieldName = fi.getFieldName();//得到元素的name属
                      StringfileName = fi.getName();//取得上传的文件名
                        file= new File(basePath+"/"+filename);
                       fi.write(file);
                    }
                   
                    out.println("UploadedFilename: " + fileName + "
");
                }
            }
}
 
说明：
FileItem接口是对用户上传文件的封装
DiskFileItemFactory 实现了FileItemFactory接口，主要方法有public FileItemcreateItem(String fieldName, String contentType, boolean isFormField, StringfileName)
ServletFileUpload从FileUpload继承，而FileUpload又从FileUploadBase继承，功能：分析传入的request对象、得到文件列表FileItemIterator……