HttpClient 4 分段上传（Multipart Upload）

编程教程 > Java (3117) 2024-11-26 14:39:04

1.概述

在本教程中，我们将演示如何使用HttpClient 4执行分段上传操作。

我们将使用http://echo.200please.com作为测试服务器，因为它是公开的，它接受大多数类型的内容。

**2.使用AddPart方法**

让我们先看看MultipartEntityBuilder对象，以便将部分添加到Http实体，然后通过POST操作将其上传。

这是将部分添加到表示窗体的HttpEntity的通用方法。

例2.1。- 用两个文本部分和一个文件上传表格

File file = new File(textFileName);
HttpPost post = new HttpPost("http://echo.200please.com");
FileBody fileBody = new FileBody(file, ContentType.DEFAULT_BINARY);
StringBody stringBody1 = new StringBody("Message 1", ContentType.MULTIPART_FORM_DATA);
StringBody stringBody2 = new StringBody("Message 2", ContentType.MULTIPART_FORM_DATA);
// 
MultipartEntityBuilder builder = MultipartEntityBuilder.create();
builder.setMode(HttpMultipartMode.BROWSER_COMPATIBLE);
builder.addPart("upfile", fileBody);
builder.addPart("text1", stringBody1);
builder.addPart("text2", stringBody2);
HttpEntity entity = builder.build();
//
post.setEntity(entity);
HttpResponse response = client.execute(post);

请注意，我们正在通过指定服务器使用的ContentType值来实例化File对象。

另请注意，addPart方法有两个参数，它们的作用类似于表单的键/值对。这些仅在服务器端实际期望并使用参数名称时相关 - 否则，它们会被忽略。

**3.使用addBinaryBody和addTextBody方法**

创建多部分实体的更直接方式是使用addBinaryBody和AddTextBody方法。这些方法用于上传文本，文件，字符数组和InputStream对象。我们用简单的例子来说明如何。

例子3.1。- 上传文本和文本文件部分

HttpPost post = new HttpPost("http://echo.200please.com");
File file = new File(textFileName);
String message = "This is a multipart post";
MultipartEntityBuilder builder = MultipartEntityBuilder.create();
builder.setMode(HttpMultipartMode.BROWSER_COMPATIBLE);
builder.addBinaryBody("upfile", file, ContentType.DEFAULT_BINARY, textFileName);
builder.addTextBody("text", message, ContentType.DEFAULT_BINARY);
// 
HttpEntity entity = builder.build();
post.setEntity(entity);
HttpResponse response = client.execute(post);

请注意，这里不需要FileBody和StringBody对象。

同样重要的是，大多数服务器不检查文本正文的ContentType，因此addTextBody方法可能会忽略ContentType值。

该addBinaryBody API接受ContentType的 -但它也可能只是从二进制主体和形式参数拿着文件的名称创建实体。如前一节所述，如果未指定ContentType值，则某些服务器将无法识别该文件。

接下来，我们将添加一个zip文件作为InputStream，而图像文件将被添加为File对象：

例3.2。- 上传 Zip文件，图像文件和文本部分

HttpPost post = new HttpPost("http://echo.200please.com");
InputStream inputStream = new FileInputStream(zipFileName);
File file = new File(imageFileName);
String message = "This is a multipart post";
MultipartEntityBuilder builder = MultipartEntityBuilder.create();         
builder.setMode(HttpMultipartMode.BROWSER_COMPATIBLE);
builder.addBinaryBody
  ("upfile", file, ContentType.DEFAULT_BINARY, imageFileName);
builder.addBinaryBody
  ("upstream", inputStream, ContentType.create("application/zip"), zipFileName);
builder.addTextBody("text", message, ContentType.TEXT_PLAIN);
// 
HttpEntity entity = builder.build();
post.setEntity(entity);
HttpResponse response = client.execute(post);

请注意，可以即时创建ContentType值，就像上面的zip文件示例一样。

最后，并不是所有的服务器都确认InputStream部分。我们在代码的第一行实例化的服务器识别InputStream。

现在让我们看看addBinaryBody直接与字节数组一起工作的另一个示例：

例3.3。- 上传字节数组和文本

HttpPost post = new HttpPost("http://echo.200please.com");
String message = "This is a multipart post";
byte[] bytes = "binary code".getBytes(); 
// 
MultipartEntityBuilder builder = MultipartEntityBuilder.create();
builder.setMode(HttpMultipartMode.BROWSER_COMPATIBLE);
builder.addBinaryBody("upfile", bytes, ContentType.DEFAULT_BINARY, textFileName);
builder.addTextBody("text", message, ContentType.TEXT_PLAIN);
// 
HttpEntity entity = builder.build();
post.setEntity(entity);
HttpResponse response = client.execute(post);

注意ContentType - 它现在指定二进制数据。