HttpComponents 基础接口/类与HTTP message的对应关系

Posted LarryZeal

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了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实现类

HttpRequestHierarchy

在说这些实现类之前,必须先说一下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接口,没有更多内容。

以上是关于HttpComponents 基础接口/类与HTTP message的对应关系的主要内容,如果未能解决你的问题,请参考以下文章

JAVA基础抽象类与接口

Java基础--抽象类与接口

Java8基础之抽象类与接口

Java——基础知识——抽象类与抽象方法接口

java基础知识--抽象类与接口

java面试题