转载请注明出处 http://www.jianshu.com/p/41a2d6e3204f (作者:韩栋)
本文为译文,由于译者水平有限,欢迎拍砖,读者也可以阅读原文
【OkHttp3-基本用法,OkHttp3-使用进阶(Recipes),OkHttp3-请求器(Calls),OkHttp3-连接(Connections),OkHttp3-拦截器(Interceptor)】
虽然通常你只需要提供一个URL
给OkHttp,OkHttp就可以帮你完成其他事情。但是实际上OkHttp连接服务器需要三个条件:URL
,Address
,Route
。
URLs(统一资源定位符)
提供一个URL
(比如https://github.com/square/okhttp
)让Http去连接服务器是最基本的工作。还有一种渐渐普遍的文件定位方式称为URN(同意名称定位符)
,它是利用一种分散式的命名方案去指定所需要访问的资源文件。
URLs
是抽象的:
-
URL
可以指定请求的类型是明文(Http
)或者是密文(Https
),但是无法指定使用的是哪个加密算法,也无法指定怎样去验证证书(HostnameVerifier
)或者指定哪种证书可以被验证(SSLSocketFactory
)。 -
URL
无法指定使用哪些代理服务器,以及指定哪些代理服务器进行身份认证。
URL
是具体的:
- 每一个
URL
都可以定义一个指定的路径(比如/square/okhttp
)以及查询条件(比如?q=sharks&lang=en
)。每个主机可以拥有多个URL
。
Address(地址)
Address
在OKHttp中是一个对象,它为OkHttp提供静态配置!
地址指定了一个服务器(比如github.com
)以及连接此服务器所需要的静态配置:端口号,HTTPS
设置,以及指定的网络协议(比如HTTP/2
或者SPDY
)。
相同地址的URL
也可以共用相同的底层TCP Socket
连接。共用相同的连接对于性能有很大的提升:更低的延迟,更大的吞吐量(复用连接,由于每个TCP
启动的都需要较多的准备工作),更少的电能损耗。OkHttp使用一个连接池,来自动复用HTTP/1.x connections
、HTTP/2
、SPDY
连接。
URL为地址提供了一些字段(比如域名、主机名、端口号),其他的字段都来自于OkHttpClient
。
Routes(路由)
Routes
在OKHttp中是一个对象,它为OkHttp提供动态配置!
路由提供了实际连接到服务器所需要的动态配置。比如所指定用来尝试连接服务器的IP
地址(从DNS
服务商获得)、连接过程中实际所使用到的代理服务器(如果使用了ProxySelector
),以及使用的是哪个版本的
TLS
协议(当使用Https
协议连接时候需要)。
对于一个地址来说 ,可能存在有很多种路由的方式。比如,当一个服务器被托管在多个数据中心,这时路由从DNS
供应商获取的响应中就可以获取到多个IP
地址。
Connections(连接)
当你使用OkHttp去请求一个URL
时,OkHttp为你做了如下事情:
- OkHttp使用一个
URL
以及经过配置的OkHttpClient
去创建一个address
。这个address
表示我们将如何连接服务器。 - OkHttp尝试从连接池中获取一个适用于此
address
的Connection
。 - 如果OkHttp没有找到对应的
Connection
,那么OkHttp就会选择一条路由去尝试创建连接。这通常意味着需要向DNS
供应商发送一个请求去获取这个服务器的IP
地址,以及可能还需要选择TLS
版本和代理服务器。 - 如果此路由是一条新的路由,它将通过构建一个
Socket
连接,一个TLS
连接(通过Http
代理的Https
),或者直接通过一个TLS
进行连接(它需要TLS
握手)。 - OkHttp发送
Http
请求并读取响应。
如果在连接的过程中出现问题,那么OkHttp将会选择其他的路由进行重新连接。这意味着当一个服务器的某一个IP
地址无法访问时,OkHttp可以尝试别的IP
地址进行访问。或者当一个连接池过期或者你尝试连接的所用的TLS
版本不受服务器支持时,这种重连机制也是非常有用的。
一旦客户端发来接收到来自服务器的响应,那么这个Connection
将会被放置到连接池中以备于将来新的连接进行复用。Connection
在长期不使用的情况下,将会从这个连接池中被移除。
··