StringEntity 用于将字符串内容作为 HTTP 请求实体(请求体)

        StringEntity  类是 Apache HttpClient 库中的一个类,它用于将字符串内容作为 HTTP 请求实体(请求体)。这个类非常适合用于发送 JSON、XML 或其他需要以字符串形式发送的数据。以下是 StringEntity 类的一些常用方法和代码案例:

常用方法

  1. 构造方法

    • StringEntity(String string):创建一个默认内容类型为 text/plain 的 StringEntity
    • StringEntity(String string, Charset charset):创建一个指定字符编码的 StringEntity
    • StringEntity(String string, ContentType contentType):创建一个指定内容类型的 StringEntity
    • StringEntity(String string, String charset):创建一个指定字符编码的 StringEntity(已过时,建议使用 Charset 版本)。
  2. setContentEncoding(String contentEncoding):设置实体的内容编码。

  3. setContentType(String contentType):设置实体的内容类型。

  4. getContent():返回实体的内容流。

  5. getContentLength():返回实体内容的长度,如果未知则返回负数。

  6. isRepeatable():返回实体是否可以重复使用。

  7. writeTo(OutputStream outstream):将实体内容写入到输出流中。

代码案例

案例 1:使用 StringEntity 发送 JSON 数据。

import org.apache.http.entity.StringEntity;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

CloseableHttpClient httpClient = HttpClients.createDefault();
HttpPost httpPost = new HttpPost("http://example.com/api");
String json = "{\"key\":\"value\"}";
StringEntity entity = new StringEntity(json, "UTF-8");
entity.setContentType("application/json");
httpPost.setEntity(entity);

CloseableHttpResponse response = httpClient.execute(httpPost);
try {
    String responseBody = EntityUtils.toString(response.getEntity(), "UTF-8");
    System.out.println(responseBody);
} finally {
    response.close();
    httpClient.close();
}

        在这个例子中,我们创建了一个 HttpPost 对象,并使用 StringEntity 设置了请求体为 JSON 格式的数据。我们还设置了内容类型为 application/json 并发送了请求。响应内容被转换成字符串并打印出来。

案例 2:使用 StringEntity 发送表单数据。

import org.apache.http.entity.StringEntity;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.message.BasicHeader;
import org.apache.http.util.EntityUtils;

CloseableHttpClient httpClient = HttpClients.createDefault();
HttpPost httpPost = new HttpPost("http://example.com/api");
String form = "field1=value1&field2=value2";
StringEntity entity = new StringEntity(form, "UTF-8");
entity.setContentType(new BasicHeader("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8"));
httpPost.setEntity(entity);

CloseableHttpResponse response = httpClient.execute(httpPost);
try {
    String responseBody = EntityUtils.toString(response.getEntity(), "UTF-8");
    System.out.println(responseBody);
} finally {
    response.close();
    httpClient.close();
}

        在这个例子中,我们创建了一个 HttpPost 对象,并使用 StringEntity 设置了请求体为表单数据。我们还设置了内容类型为 application/x-www-form-urlencoded 并发送了请求。响应内容被转换成字符串并打印出来。

这些案例展示了如何使用 StringEntity 类来发送不同类型的数据。在实际应用中,你可以根据需要选择适当的构造方法和设置方法来满足你的要求。

上一篇:python可变数据类型和不可变数据类型


下一篇:net ASp.net Core 文件上传 IFormFile IFormFileCollection