apache commons fileupload 输入输出流API（2016-07-01更新）

变更了获取输入流的方法，由FileItemStream.openStream()方法改为使用FileItemStream.getInputStream()方法进行获取。

-------------------------------------------------------

为什么描述输入输出流？（Why Streaming?）

那些被描述在用户手册的传统API是预设上传文件条目在用户实际访问之前必须被存储在某个地方的。这种方法很方便，因为它可以方便地访问一个文件上传条目的内容。另一方面，它却是消耗内存和时间的。

输入输出流API允许你增加复杂度以换取最佳性能以及使用最小内存。此外，API更轻量，从而更容易去理解。

它如何工作（How it works）

FileUpload 类被用于依次访问表单字段，这些表单字段是通过客户端发送的。然而FileItemFactory 被完全忽略了。

解析（Parsing the request）

首先，不要忘记确保所处理的请求确实是一个文件上传请求。这通常是使用同一个静态方法处理的，它们已经被你在传统API知晓了。

// 检查我们处理的是文件上传请求
boolean isMultipart = ServletFileUpload.isMultipartContent(request);

现在我们准备好解析一个请求以获取它对应的条目集合。这里告诉我们怎么处理它：

// 创建一个新的文件上传处理程序
ServletFileUpload upload = new ServletFileUpload();

// 解析请求
FileItemIterator iter = upload.getItemIterator(request);
while (iter.hasNext()) {
    FileItemStream item = iter.next();
    String name = item.getFieldName();
    InputStream stream = item.getInputStream();
    if (item.isFormField()) {
        System.out.println("Form field "  name  " with value "
             Streams.asString(stream)  " detected.");
    } else {
        System.out.println("File field "  name  " with file name "
             item.getName()  " detected.");
        // 处理字节输入流
        ...
    }
}

这就是所需要的全部了，是的！