HttpComponents 基础接口/类与HTTP message的对应关系
前提一：
什么是HTTP Message -- 遵循HTTP协议发送的消息！其格式是固定的：HTTP Message = Message Line + Message Header + Message Body(optional) 。简言之，Http Message分为Http Request Message 和 Http Response Message两种，简称 Request 和 Response。
HTTP request 的header 由一个请求行和一组header字段组成。
HTTP response 的header 由一个状态行和一组header字段组成。
所有的HTTP message 都必须包含协议版本！某些HTTP message也可以包含一个content body（内容体）。
说明：上面提到的 “Body(optional)” 和 “content body” 是一回事，都是消息的内容体，也被叫做 “Entity”。对于HTTP message来说，”content body” /” entity”不是必须的，而是可选的，具体看情况需要 。
前提二：
HttpComponents可以认为主要是两大块，一块HttpCore，一块HttpClient。前者对应HTTP协议，后者则是应用--HTTP客户端编程。
HttpCore 遵循”前提一”的HTTP message定义来定义了HTTP message object，并支持对HTTP message 元素的序列化（格式化）和反序列化（解析）。
正文
首先是 HttpMessage 接口，一切的开始。
public interface HttpMessage { ProtocolVersion getProtocolVersion(); boolean containsHeader(String name); Header[] getHeaders(String name); Header getFirstHeader(String name); Header getLastHeader(String name); Header[] getAllHeaders(); void addHeader(Header header); void addHeader(String name, String value); void setHeader(Header header); void setHeader(String name, String value); void setHeaders(Header[] headers); void removeHeader(Header header); void removeHeaders(String name); HeaderIterator headerIterator(); HeaderIterator headerIterator(String name); @Deprecated HttpParams getParams(); @Deprecated void setParams(HttpParams params); }
很简单，除了一个获取协议版本的方法，还有params的SETTER/GETTER方法（已过时）之外，都是操作Headers的方法。
从上面无法直接区分request和response，所以要看其子接口 HttpRequest 和 HttpResponse 。
HttpRequest很简单，只多了一个获取请求行的方法。
public interface HttpRequest extends HttpMessage { RequestLine getRequestLine(); }
HttpResponse则多了很多方法。涉及到：状态行、状态码、entity、locale。
public interface HttpResponse extends HttpMessage { StatusLine getStatusLine(); void setStatusLine(StatusLine statusline); void setStatusLine(ProtocolVersion ver, int code); void setStatusLine(ProtocolVersion ver, int code, String reason); void setStatusCode(int code) throws IllegalStateException; void setReasonPhrase(String reason) throws IllegalStateException; HttpEntity getEntity(); void setEntity(HttpEntity entity); Locale getLocale(); void setLocale(Locale loc); }
来看一下常用的HttpRequest实现类。
在说这些实现类之前，必须先说一下HTTP中的method，其实这个method是form元素的属性。在HTML中，form元素内的表单数据可以被提交到服务器 -- 这里涉及到提交的地址、提交的内容与格式、希望服务器处理提交内容的方式。
method就是用来设置”希望服务器处理提交内容的方式”，其实我个人认为它有两个含义：一个是form提交的内容放在什么地方，一个是告诉服务器怎么解析提交的内容。
HTTP standard specification 中规定了一组method：GET, POST, PUT, DELETE 等等。详见 HTTP/1.1 Semantics and Contents。
HttpCore中提供与HTTP standard specification中规定的method一致的，从上图你可以看到HttpDelete、HttpPost、HttpPut、HttpPatch、HttpHead、HttpGet、HttpOptions、HttpTrace。从其源代码中可以看到每个类对应的标准文档内容。
例如：
org.apache.http.client.methods
@NotThreadSafe
public class HttpTrace
extends HttpRequestBase
HTTP TRACE method.
The HTTP TRACE method is defined in section 9.6 of RFC2616:
The TRACE method is used to invoke a remote, application-layer loop- back of the request message. The final recipient of the request SHOULD reflect the message received back to the client as the entity-body of a 200 (OK) response. The final recipient is either the origin server or the first proxy or gateway to receive a Max-Forwards value of zero (0) in the request (see section 14.31). A TRACE request MUST NOT include an entity.
Since:
4.0
所以，当我们需要发送请求时，直接选择相应的类使用即可。
事实上，最常用的只有GET/POST两种方式，所有的请求默认就是GET。
由于POST需要将发送的内容放到HTTP message body也就是entity中，所以 HttpPost类中有entity的GETTER/SETTER。
而GET是将发送的内容作为query string追加到URL后面，所以没有HTTP message body，也就是没有entity。
再来看看HttpResponse系列，需要注意的就一个，CloseableHttpResponse 接口，继承了HttpResponse接口和Closeable接口，没有更多内容。
