使用FileUpload组件上传文件

一、进行文件上传时, 表单需要做的准备

1.请求方式为 POST：<form action="uploadServlet" method="post" ... >

2. 使用 file 的表单域： <input type="file" name="file"/>

3. 使用 multipart/form-data 的请求编码方式:

<form action="uploadServlet" method="post" enctype="multipart/form-data"> 
　　File: <input type="file" name="file"/>
　　<input type="submit" value="Submit"/> 
</form>

4. 关于 enctype

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

二、服务端

不能再使用 request.getParameter() 等方式获取请求信息. 获取不到, 因为请求的编码方式已经改为 multipart/form-data, 以二进制的方式来提交请求信息。可以使用输入流的方式来获取，但不建议这样做。具体使用 commons-fileupload 组件来完成文件的上传操作。

1. 搭建环境：加入 commons-fileupload-1.2.1.jar、commons-io-2.0.jar。

2. 基本思想：

① commons-fileupload 可以解析请求, 得到一个 FileItem 对象组成的 List。

② commons-fileupload 把所有的请求信息都解析为 FileItem 对象, 无论是一个一般的文本域还是一个文件域。

③ 可以调用 FileItem 的 isFormField() 方法来判断是一个表单域或不是表单域(则是一个文件域)。

3. 再来进一步获取信息

if (item.isFormField()) {
   String name = item.getFieldName();
   String value = item.getString();
   ...
} 

if (!item.isFormField()) {
   String fieldName = item.getFieldName();
   String fileName = item.getName();
   String contentType = item.getContentType();
   boolean isInMemory = item.isInMemory();
   long sizeInBytes = item.getSize();
   
   InputStream uploadedStream = item.getInputStream();
   ...
   uploadedStream.close();
}

如何得到 List<FileItem> 对象？

（1）简单的方式

// 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);

（2）复杂的方式：可以为文件的上传加入一些限制条件和其他的属性。

// Create a factory for disk-based file items
DiskFileItemFactory factory = new DiskFileItemFactory();

//设置内存中最多可以存放的上传文件的大小, 若超出则把文件写到一个临时文件夹中. 以 byte 为单位
factory.setSizeThreshold(yourMaxMemorySize);
//设置那个临时文件夹
factory.setRepository(yourTempDirectory);

// Create a new file upload handler
ServletFileUpload upload = new ServletFileUpload(factory);

//设置上传文件的总的大小. 也可以设置单个文件的大小. 
upload.setSizeMax(yourMaxRequestSize);

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

问题1：如果是一个多选, 若何获取对应的字符串数组. 每一个都对应一个 FileItem 对象。

<input type="checkbox" name="interesting" value="Reading"/>Reading
<input type="checkbox" name="interesting" value="Party"/>Party
<input type="checkbox" name="interesting" value="Sports"/>Sports
<input type="checkbox" name="interesting" value="Shopping"/>Shopping