• 畅游HttpCore


    欢迎

    非常欢迎阅读本文,本文主要介绍HttpCore是如何工作的。

    你应该知道HTTP是一种用于在客户端与服务端进行消息交换的协议。它使用的特别广泛,它通常运行在TCP/IP或者安全的TLS/SSL之上。

    Apache有一个HTTP协议的客户端实现Commons HttpClient。通俗地讲,称它为基于3.X的或者老代码。很多人都从中受益,但老代码在设计上有一些严重的限制。例如,有一个叫做HttpMethodBase的类,它同时表示一个请求和一个响应,它同时实现了两者的逻辑。这种将不同的功能放在一起的设计,让它很难维护,也很难进行扩展。

    因此,我们启动了它的后继项目,HttpComponents。基于老代码中经验和教训,使用新的方法来实现HTTP协议。最终,使用不现的模块来处理不同的方面。从HttpCore的名字可以看出来,这个模块处于核心的地位。它被定义为其他模块的基础。

    HttpCore处理HTTP消息的表示、传输逻辑包括发送和接收消息。它还被定义为一种基础框架,方便其他模块进行扩展其功能。与老代码不同,它不仅仅是HTTP客户端的实现,同时也可以做为服务端。正是因为它与老代码有这么大的不同,我们才决定将其放在新的包层次结构中,以免引起你的困惑。

    Q:我有一个问题。
    A:哦?什么问题,请讲。
    Q:如果把它放在新的包层次结构中,那使用老代码的应用程序就不是使用新的了啊?
    A:是的,由于老代码的设计上的限制,我们需要改动API。应用程序必须被重写,才能使用新的代码。没有办法避开这个问题。所有的新的包和老代码可以同时使用在相同的环境中,如Servlet引擎。

    下面跟随我一起来了解org.apache.http。

    消息

    首先,我们需要处理消息的表示方式。如果你不知如何表示一个消息,你就不能发送或者接收它,对吧?因此,我们有一些用于创建HTTP消息的接口。RequestLine用于请求,StatusLine于响应,它们都包含ProtocolVersionProtocolVersion是非常基础的,所以将其定义为类,而不是接口,当然,我们有HttpVersion继承自它。Header包含名字和值,值可以包含多个HeaderElement。最后还有一个表示消息体的HttpEntity

    Q:HttpVersion继承自ProtocolVersion?HttpCore中的协议不都是HTTP吗?

    A:当前不是了。至少有一个不一样的协议,SIP(会话发起协议),它与HTTP有着相似的消息格式,只有协议的名字和版本是不同的。正是因为它们如此相似,我们试图保留它。

    Q:明白了。

    除了上述创建消息的接口,还要收集消息。每一个HttpMessage都有头,可以按照需求进行添加或者删除。HttpRequest添加请求行,HttpEntityEnclosingRequest是一个实体(后面都称为Entity)。HttpResponse添加状态行和一个Entity。为了方便集成到框架的工厂模式之中,有一些用于创建请求和响应的工厂接口。

    Q:没有不带Entity的响应吗?

    A:是的。你不需要给一个响应提供一个Entity,将它设置为null就好。对于请求,我们事先就知道是否需要一个Entity。对于GET请求,是不需要Entity的,这就是为什么提供了两个不同接口的原因。响应多数情况下是有Entity的,只有的极特别的情况下才是空。但是事先来处理一个响应是否有Entity使得API处理起来很麻烦,所以我们使用了相同的接口,都包含Entity。

    Q:你说可以向HttpMessage添加或者从它删除头部,如果我想要一个只读的消息怎么办呢?

    A:我们放弃了对消息是否可以修改进行区分的做法。因为那样将添加大量的接口,而且传播对类型的检查和向下转型。HttpCore面向的是知道她们在做什么的人群。如果你需要消息保持不变,简单的做法就是你不要去修改它偷笑。如果你执意在阻止修改的话,你可以自己实现这个一个接口,当修改的方法被调用时抛出异常。

    接下来看看这个包里还有些什么东西,你会发现最重要的东西,这就是org.apache.http.message包。注意,所有的消息表示接口都有一些基础的实现类,但当你使用HttpCore写应用程序的时候不需要接触这些实现类。

    Q:我不能看到GetRequest和PostRequest等的实现吗?

    A:是的,在核心中并不包含这些类。核心就是当之无愧的核心。如果你需要一个GET请求,你只需要创建一个基本的请求,然后将GET作为HTTP方法的名字,对于POST和PUT也同样如此,除非你想用它们创建一个基础的实现封装请求。在客户端你可以找到一些默认的HTTP方法便利的类,对于核心来说,它们是多余的。

    Q:为什么可以使用GET方法创建实体封装请求,GET请求不没有Entity吗,这一点我不太明白?

    A:哈哈,你可以用核心类来做一些愚蠢的事情。核心就是核心,这意味着使用它的人应该清楚的知道他们在做什么。也许你想创建一个带实体的GET方法,用于测试服务器是如何应对非法请求的?

    Q:这倒是挺有意思的,我从来没有想过这样做。


    对于基础的实现还有其他的问题吗?好的,我们继续下一个问题。我们来看一看org.apache.http.entity。你可以在这里面看到一系列的消息实体。除了它们不再绑定为客户端,消息实体与老代码中实现基本没有什么差别。在老代码中,可以从字符串、字节数组、文件、输入流获取实体的内容。在连接中收到的消息,对应于BasicHttpEntity。在下面会看到连接的内容。我们还做一些工作,用于封装、缓存实体。使用EntityTemplate可以简化对一个实体的实现。

    Q:在老代码中实体有多个组成部分吗?

    A:根本上来讲,是这样的。但它们并不在核心当中。即使对于老代码来讲,它也被认为已经越出范围。它是在httpmime中的模块,而我们直接使用的是mime4j,它同样添加了额外的依赖。HttpCore根本没有外部的依赖。

    对于实体还有问题吗?没有我们就开始介绍连接。

    连接

    从客户端发消息给服务端,或者从服务端返回消息给客户端都需要连接。在接口层,提供了HttpConnection,允许检查连接是否打开,关闭连接,断开连接,获取统计数据。实际用于发送或者接收数据使用的是HttpClientConnection或者HttpServerConnection,具体使用哪一个取决于你要做什么。显然,客户端连接允许你发送请求并接收响应,服务端连接允许你接收请求并发送响应。消息的发送或者获取就是通过我们上面介绍的连接进行的。发送消息头部和消息的实体需要两次调用。这样可以显式处理expect-continue的握手。

    Q:我没有看到打开连接的方法啊?
    A:你有鹰一样的眼睛,不是吗?你是对的,在接口中,没有打开一个连接的方法。在我们决定这一点上,花了大量的时间来讨论这个问题,打开一个连接比想象的更加复杂,所以我们没有将它们放在核心当中。
    Q:如果我不能打开一个连接,那我该怎么使用连接呢?
    A:API与实现不是一回事。在API中并没有类似open的方法,但你的实现中可以提供这样的方法。我们提供的默认实现,提供一个打开的套接口,你可以在任何时候创建它。
    Q:套接口?我在接口当中也没有看到啊。是否可以设置TCP/IP的一些设置呢?
    A:当前,了解套接口是十分有用的。但是,套接口并不属于核心API。有人可能会使用API而不是Java套接口与本地的库进行通信。我们会在下面介绍正确的实现方式。
    Q:这是否意味着需要将实现类向下转型以获取IP和端口呢?
    A:不,没有那么糟。有一个HttpInetConnection接口,提供了对本地及远程的IP和端口的访问,这只是一个可选的接口,但它是被默认实现支持的。你只需要向下转型为接口,而不是实现类。

    在你问更多的问题之前,我们需要介绍点其他的东西,org.apache.http.impl,所有的连接的实现类都在这。不要迷惑,这样做只是为了代码的可维护性,你需要了解的只有两个类,DefaultHttpClientConnection和DefaultHttpServerConnection。提供了bind方法,传递一个打开的套接口,就打开了一个连接。由于继承自基类,也有getSocket方法。



    https://wiki.apache.org/HttpComponents/GuidedTourOfHttpCore

  • 相关阅读:
    JS在线编辑器
    meta标签
    webstorm快捷键
    微信JS-SDK调用
    iOS -- UIApplication
    Xcode -- apple llvm 6.0 error错误如何解决
    C -- 字符串数组与字符串指针
    MAC -- 小技巧
    C语言 -- 折半查找小程序
    C -- 小程序
  • 原文地址:https://www.cnblogs.com/furzoom/p/7710148.html
Copyright © 2020-2023  润新知