HttpComponents (http 客户端) 常用类简介

http://hc.apache.org/

阿帕奇的开源项目。用于Http通信。

<dependency><groupId>org.apache.httpcomponents</groupId><artifactId>httpclient</artifactId><version>4.5.1</version></dependency>

1.client

org.apache.http.client.HttpClient
接口。
CloseableHttpClient org.apache.http.impl.client.HttpClients.createDefault()
此方法可以拿到HttpClient对象。它是线程安全的。

2.request

org.apache.http.HttpRequest
接口。实现类有HttpGet、HttpPost等。
org.apache.http.client.methods.HttpUriRequest
继承了HttpRequest接口的接口。
void org.apache.http.message.AbstractHttpMessage.addHeader(String name, String value)
添加请求的头部信息。

org.apache.http.client.methods.HttpGet
代表HttpGet请求。
org.apache.http.client.methods.HttpPost
代表HttpPost请求。

2.1 get请求

org.apache.http.client.methods.HttpGet.HttpGet(String uri)
HttpGet请求的构造函数。

2.2 post请求

org.apache.http.client.methods.HttpPost.HttpPost(String uri)
HttpPost请求的构造函数。
org.apache.http.entity.StringEntity.StringEntity(String string) 
http报文body的格式是字符串。用于构造json、xml类post请求。

3.设置参数

Builder org.apache.http.client.config.RequestConfig.custom()

拿到builder。

Builder org.apache.http.client.config.RequestConfig.Builder.setSocketTimeout(int socketTimeout)

设置socket链接超时。

Builder org.apache.http.client.config.RequestConfig.Builder.setConnectionTimeout(int connectionRequestTimeout)

设置http连接超时。socket超时是http超时的充分不必要条件。

Builder org.apache.http.client.config.RequestConfig.Builder.setConnectionRequestTimeout(int connectionRequestTimeout)

设置请求发出前的超时时间。适用于用连接池，连接池占满的情况。

RequestConfig org.apache.http.client.config.RequestConfig.Builder.build()

至此拿到了RequestConfig 对象。

void org.apache.http.client.methods.HttpRequestBase.setConfig(RequestConfigconfig)
设置连接超时等在内的参数。RequestConfig对象的生成见下行。

RequestConfig requestConfig = RequestConfig.custom().setConnectTimeout(2000).build();

4.execute

CloseableHttpResponse org.apache.http.impl.client.CloseableHttpClient.execute(HttpUriRequest request) 
执行请求并返回结果，是同步函数，需要等待。

5.response

org.apache.http.client.methods.CloseableHttpResponse
接口。
StatusLine org.apache.http.HttpResponse.getStatusLine()
获取状态栏。
HttpEntity org.apache.http.HttpResponse.getEntity()
获取消息实体。
InputStream org.apache.http.HttpEntity.getContent()
获取内容。如果是文本数据，通常这样来拿。

Scanner scanner = new Scanner(instream, "utf-8");

void org.apache.http.util.EntityUtils.consume(HttpEntity entity) 
调用HttpEntity.getContent()就得到了InputStream，此方法用于把流消费完，然后关掉这个InputStream。

6.代码