本教學演示如何使用Apache HttpClient 4.5發出Http POST請求。 HTTP POST請求方法請求伺服器接受請求中包含的實體作為URI標識的Web資源。 發布的資料可以是但不限於現有資源的注釋或資料格式化的JSON,XML或提交的表單資料。 伺服器可以使用發布的資料來更新資料庫中的資源,或處理這些資料。
我們使用maven來管理依賴關係,並使用Apache HttpClient 4.5版本。 將以下依賴項新增到您的專案中,以便建立HTTP POST請求方法。
pom.xml 檔案的內容如下 -
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.yiibai.httpclient.httmethods</groupId>
<artifactId>http-get</artifactId>
<version>1.0.0-SNAPSHOT</version>
<url>https://memorynotfound.com</url>
<name>httpclient - ${project.artifactId}</name>
<dependencies>
<!-- Apache Commons IO -->
<dependency>
<groupId>org.apache.httpcomponents</groupId>
<artifactId>httpclient</artifactId>
<version>4.5.2</version>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.5.1</version>
<configuration>
<source>1.8</source>
<target>1.8</target>
</configuration>
</plugin>
</plugins>
</build>
</project>
在以下範例中,我們將資料發布到資源URL:http://httpbin.org/post
。 該資源確認資料並返回一個JSON物件,我們只需將其列印到控制台。 注意:使用Java7
的try-with-resources
來自動處理關閉ClosableHttpClient
。 接下來使用Java 8
的lambda
作為ResponseHandler
。 在這裡,根據Http狀態程式碼判斷返回狀態,當一切正常時,我們會將解析的響應正文返回給String。 當狀態碼不是所期望的時候,將丟擲一個ClientProtocolException
,表明Http POST請求方法失敗。 最後,我們將響應主體列印到控制台。
檔案:HttpPostRequestMethodExample.java -
package com.yiibai.httpdemo;
import org.apache.http.HttpEntity;
import org.apache.http.client.ClientProtocolException;
import org.apache.http.client.ResponseHandler;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;
import java.io.IOException;
/**
* This example demonstrates the use of {@link HttpPost} request method.
*/
public class HttpPostRequestMethodExample {
public static void main(String... args) throws IOException {
try (CloseableHttpClient httpclient = HttpClients.createDefault()) {
HttpPost httpPost = new HttpPost("http://httpbin.org/post");
httpPost.setEntity(new StringEntity("Hello, World"));
System.out.println("Executing request " + httpPost.getRequestLine());
// Create a custom response handler
ResponseHandler<String> responseHandler = response -> {
int status = response.getStatusLine().getStatusCode();
if (status >= 200 && status < 300) {
HttpEntity entity = response.getEntity();
return entity != null ? EntityUtils.toString(entity) : null;
} else {
throw new ClientProtocolException("Unexpected response status: " + status);
}
};
String responseBody = httpclient.execute(httpPost, responseHandler);
System.out.println("----------------------------------------");
System.out.println(responseBody);
}
}
}
執行上面範例程式碼,得到以下結果 -
Executing request POST http://httpbin.org/post HTTP/1.1
----------------------------------------
{
"args": {},
"data": "Hello, World",
"files": {},
"form": {},
"headers": {
"Accept-Encoding": "gzip,deflate",
"Connection": "close",
"Content-Length": "12",
"Content-Type": "text/plain; charset=ISO-8859-1",
"Host": "httpbin.org",
"User-Agent": "Apache-HttpClient/4.5.5 (Java/1.8.0_65)"
},
"json": null,
"origin": "112.67.161.222",
"url": "http://httpbin.org/post"
}