利用Jakarta commons fileupload组件实现多文件上传(原理)

曾经写过一篇 文章《利用MultipartFile实现文件上传》，可是最近在工作中，我需要同时上传多个文件，似乎用MultipartFile就不能胜任了，于是想到了Jakarta commons。Jakarta commons真是不错的，有那么多开源且好用的东东，太方便了。好了，闲话少说，开始介绍一下jakarta commons fileupload组件吧。
首先，需要到其官网上下载最新的jar包及其依赖的jar包，然后可以参考一下它的user guide，很简单，想信大家都能看懂，这里就把主要的内容提一下（相当于一个删减的翻译）。
一.基本原理

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

二.具体实现
对一个HttpRequest请求，我们要判断该请求是否是文件上传的请求


// Check that we have a file upload request


boolean isMultipart = ServletFileUpload.isMultipartContent(request);

不过，个人觉得这个方法一般不需要，我们一般是在需要上传时才采用fileupload组件处理request请求的。
如果确实是文件上传的请求，我们如何解析该request呢？


// Create a factory for disk-based file items


FileItemFactory factory = new DiskFileItemFactory();




// Create a new file upload handler


ServletFileUpload upload = new ServletFileUpload(factory);




// Parse the request




List /**//* FileItem */ items = upload.parseRequest(request);



至此我们已经的到了FileItem的list，对每个Item的处理要考虑是标准的form表单域还是上传文件file域，然后做不同的处理，可以通过以下方式实现：


// Process the uploaded items


Iterator iter = items.iterator();




while (iter.hasNext()) ...{


FileItem item = (FileItem) iter.next();






if (item.isFormField()) ...{


processFormField(item);




} else ...{


processUploadedFile(item);


}


}

对于一个简单的form表单域，我们可以通过以下方法得到该域的相关信息：


// Process a regular form field




if (item.isFormField()) ...{


String name = item.getFieldName();


String value = item.getString();


...


}

而对于一个upload file，我们则可以通过如下方式得到其相关信息：


// Process a file upload




if (!item.isFormField()) ...{


String fieldName = item.getFieldName();


String fileName = item.getName();


String contentType = item.getContentType();


boolean isInMemory = item.isInMemory();


long sizeInBytes = item.getSize();


...


}

实际上，对于一个上传的文件，我们一般不会把它包存在内存中，除非它足够小。我们一般是把它保存到硬盘上，使用以下方法就可以将上传的文件保存到服务器硬盘上了：


File uploadedFile = new File(...);


item.write(uploadedFile);

好了，到了这里，fileupload组件的基本api已经介绍完了，大家应该有点轮廓了吧？
在下一篇文章中，我会对commons FileUpload组件稍作包装，并做个简单的demo