java+addbinarybody_HttpClient使用MultipartEntityBuilder实现多文件上传

一、MultipartEntityBuilder 实现文件上传步骤

在HttpCient4.3之后上传文件主要使用的类是位于org.apache.http.entity.mime下的MultipartEntityBuilder(原先的MultipartEntity已经基本弃用了)基本实现步骤如下：

1.设置上传的模式；

setMode(HttpMultipartMode mode)，其中mode主要有BROWSER_COMPATIBLE，RFC6532，STRICT三种，默认值是STRICT。

2.创建MultipartEntityBuilder对象，并添加需要上传的数据；

a.利用MultipartEntityBuilder.create()来创建对象；

b.addBinaryBody：以二进制的形式添加数据，可以添加File、InputStream、byte[]类型的数据。

addBinaryBody(String name, File file, ContentType contentType, String filename)

addBinaryBody(String name, InputStream stream, ContentType contentType, String filename)

addBinaryBody(String name, byte[] b, ContentType contentType, String filename)

c.addTextBody：添加文本数据

addTextBody(String name, String text, ContentType contentType)

d.addPart：以Key/Value的形式添加ContentBody类型的数据

addPart(String name, ContentBody contentBody)

测试中选用了addBinaryBody。其中，第一个参数name的值，是服务器已经定义好的，服务器会根据这个字段来读取我们上传的文件流，不匹配则会报错。关于contentType，可以参考：http://tool.oschina.net/commons，不同文件扩展名所对应的类型。而file/stream和fileName，就是我们所要上传文件的信息。当用浏览器的开发者工具查看API请求时，我们会看到这些/参数基本位于API请求中的 Request Payload字段。

3.利用build()方法创建一个HttpEntity对象；

4.HttpEntity对象添加到指定的URL上，采用HttpPost的setEntity的方法；

5.最后调用HttpClient对象发送请求，并获取服务器的响应。

在HttpCient4.3之前上传文件主要使用MultipartEntity这个类，但现在这个类已经不在推荐使用了。随之替代它的类是MultipartEntityBuilder。

二、MultipartEntityBuilder类介绍

MultipartEntityBuilder这个类主要用于创建HttpEntity。它的主要方法有：

修饰符和类型

方法和描述

MultipartEntityBuilder

addBinaryBody(String name, byte[] b)

将字节数组以二进制的形式添加数据。

MultipartEntityBuilder

addBinaryBody(String name, byte[] b, ContentType contentType, String filename)

将字节数组以二进制的形式添加数据。

MultipartEntityBuilder

addBinaryBody(String name, File file)

将文件以二进制的形式添加数据。

MultipartEntityBuilder

addBinaryBody(String name, File file, ContentType contentType, String filename)

将文件以二进制的形式添加数据。

MultipartEntityBuilder

addBinaryBody(String name, InputStream stream)

MultipartEntityBuilder

addBinaryBody(String name, InputStream stream, ContentType contentType, String filename)

将输入流以二进制的形式添加数据。

MultipartEntityBuilder

addPart(String name, ContentBody contentBody)

添加ContentBody 类型的数据。

MultipartEntityBuilder

addTextBody(String name, String text)

添加文本数据。

MultipartEntityBuilder

addTextBody(String name, String text, ContentType contentType)

以指定的内容类型添加文本数据。

HttpEntity

build()

创建一个HttpEntity。

static MultipartEntityBuilder

create()

创建一个MultipartEntityBuilder对象。

<