转载自OkHttp3源码解析(整体流程)
今天主要讲一下 OkHttp3 源码解析(整体流程),主要分为四大块:
okhttp的基本用法
OkHttpClient分析
Request分析
Call分析
OkHttp的基本用法
- 添加依赖
implementation 'com.squareup.okhttp3:okhttp:3.11.0'
可以去Okhttp-Github 查看并依赖最新的版本。
- 添加网络权限
- 请求
构建OkHttpClient对象
构建Request对象
构建Call对象并通过execute()方法来执行同步Get请求
//同步请求
OkHttpClient okHttpClient=new OkHttpClient();
final Request request=new Request.Builder()
.url("https://www.wanandroid.com/navi/json")
.get()
.build();
final Call call = okHttpClient.newCall(request);
try {
Response response = call.execute();
Log.e("同步结果---- ",response.body().string()+"");
} catch (IOException e) {
e.printStackTrace();
}
运行后发现报错:
android.os.NetworkOnMainThreadException
在 Android4.0 以后,会发现,只要是写在主线程(就是 Activity )中的 HTTP 请求,运行时都会报错,这是因为 Android在4.0 以后为了防止应用的 ANR(Aplication Not Response)异常,解决方法就是在子线程中运行:
//同步请求
OkHttpClient okHttpClient=new OkHttpClient();
final Request request=new Request.Builder()
.url("https://www.wanandroid.com/navi/json")
.get()
.build();
final Call call = okHttpClient.newCall(request);
new Thread(new Runnable() {
@Override
public void run() {
try {
Response response = call.execute();
Log.e("同步结果---- ",response.body().string()+"");
} catch (IOException e) {
e.printStackTrace();
}
}
}).start();
//异步GET 请求
OkHttpClient okHttpClient=new OkHttpClient();
final Request request=new Request.Builder()
.url("https://www.wanandroid.com/navi/json")
.get()
.build();
final Call call = okHttpClient.newCall(request);
call.enqueue(new Callback() {
@Override
public void onFailure(Call call, IOException e) {
Log.d("okhttp_error",e.getMessage());
}
@Override
public void onResponse(Call call, Response response) throws IOException {
Gson gson=new Gson();
Log.d("okhttp_success",response.body().string());
}
});
POST 请求支持提交文件、流、string、表单等 。这里拿 POST 表单请求作为请求示例:
OkHttpClient okHttpClient = new OkHttpClient();
RequestBody requestBody = new FormBody.Builder()
.add("username", "qinzishuai")
.add("password", "111111")
.build();
Request request = new Request.Builder()
.url("https://www.wanandroid.com/user/login")
.post(requestBody)
.build();
okHttpClient.newCall(request).enqueue(new Callback() {
@Override
public void onFailure(Call call, IOException e) {
Log.d("okhttp", "onFailure: " + e.getMessage());
}
@Override
public void onResponse(Call call, Response response) throws IOException {
Log.d("okhttp", "onResponse: " + response.body().string());
}
});
OkHttpClient分析
初始化-构造方式
// 创建 OkHttpClient实例的两种方式
OkHttpClient okHttpClient = new OkHttpClient();
OkHttpClient okHttpClient = new OkHttpClient.Builder().build();
我们先研究第一种构造方式,也是默认的方式,我们点击 OkHttpClient 方法进去:
public OkHttpClient() {
this(new Builder());
}
发现是一个类构造方法,this其实就是指的是OkHttpClient,也就是如下方法:
OkHttpClient(Builder builder) {
this.dispatcher = builder.dispatcher;
this.proxy = builder.proxy;
this.protocols = builder.protocols;
this.connectionSpecs = builder.connectionSpecs;
this.interceptors = Util.immutableList(builder.interceptors);
this.networkInterceptors =
Util.immutableList(builder.networkInterceptors);
this.eventListenerFactory = builder.eventListenerFactory;
this.proxySelector = builder.proxySelector;
this.cookieJar = builder.cookieJar;
this.cache = builder.cache;
this.internalCache = builder.internalCache;
this.socketFactory = builder.socketFactory;
}
....部分代码省略
然后顺理成章的看一下new Builder() 方法:
public Builder() {
dispatcher = new Dispatcher();
protocols = DEFAULT_PROTOCOLS;
connectionSpecs = DEFAULT_CONNECTION_SPECS;
eventListenerFactory = EventListener.factory(EventListener.NONE);
proxySelector = ProxySelector.getDefault();
cookieJar = CookieJar.NO_COOKIES;
socketFactory = SocketFactory.getDefault();
hostnameVerifier = OkHostnameVerifier.INSTANCE;
certificatePinner = CertificatePinner.DEFAULT;
proxyAuthenticator = Authenticator.NONE;
authenticator = Authenticator.NONE;
connectionPool = new ConnectionPool();
dns = Dns.SYSTEM;
followSslRedirects = true;
followRedirects = true;
retryOnConnectionFailure = true;
connectTimeout = 10_000;
readTimeout = 10_000;
writeTimeout = 10_000;
pingInterval = 0;
}
不出意料, 都是做了一些初始化配置…这块的细节先不说,我们继续看另一个种构造方式。
OkHttpClient okHttpClient = new OkHttpClient.Builder().build();
我们点击build()方法:
public OkHttpClient build() {
return new OkHttpClient(this);
}
这里需要我们注意的是Builder 它是静态内部类,这很关键!看源码一定要仔细哦…
这里的建造者Builder这部分是用了 设计模式中的-建造者模式
如果不知道此模式的伙伴先去把它搞懂,我这里就先简单的说一下:
实用范围
当创建复杂对象的算法应该独立于该对象的组成部分以及它们的装配方式时。当构造过程必须允许被构造的对象有不同表示时。可以在网上上找找建造者模式的例子去学习一下,学习之后可以通过建造者模式去模仿 OkHttp 的请求(Request) 就理解的充分了!OkHttpClient初始化都配置了什么????上面讲到了OkHttpClient的两种构造方式, 通过查看源码,两种方式的配置是相同的,下面具体看一下到底配置了什么:
public Builder() {
dispatcher = new Dispatcher();
protocols = DEFAULT_PROTOCOLS;
connectionSpecs = DEFAULT_CONNECTION_SPECS;
eventListenerFactory = EventListener.factory(EventListener.NONE);
proxySelector = ProxySelector.getDefault();
cookieJar = CookieJar.NO_COOKIES;
socketFactory = SocketFactory.getDefault();
hostnameVerifier = OkHostnameVerifier.INSTANCE;
certificatePinner = CertificatePinner.DEFAULT;
proxyAuthenticator = Authenticator.NONE;
authenticator = Authenticator.NONE;
connectionPool = new ConnectionPool();
dns = Dns.SYSTEM;
followSslRedirects = true;
followRedirects = true;
retryOnConnectionFailure = true;
connectTimeout = 10_000;
readTimeout = 10_000;
writeTimeout = 10_000;
pingInterval = 0;
}
Dispatcher 调度器,执行异步请求时的策略
protocols OKHTTP实现的协议LIST
connectionSpecs TLS版本与连接协议
eventListenerFactory 监听器
proxySelector 代理选择器
CookieJar cookie
socketFactory socket 工厂
hostnameVerifier 主机name验证
proxyAuthenticator 代理验证
authenticator 验证
connectionPool 连接池
dns dns域名
cache 缓存
interceptors 拦截器
networkInterceptors 网络拦截器
等等等等,我就不一一列出了,这些如果开始不知道是干什么的,可以用谷歌翻译去翻译类开头的注释或者成员变量的名字,开始会好理解一下的。我也是这样翻译的。
至于每个成员变量的具体原理我们分析到它时再具体讲解…
Request分析
Request初始化
当我们构建完 OkHttpClient 对象,需要构造 Request 对象,构造方式如下:
- Get请求
final Request request=new Request.Builder()
.url("https://www.wanandroid.com/navi/json")
.get()
.build();
- POST请求
- 拿 POST 提交表单请求,这时就需要声明一个 RequestBody 对象了
RequestBody requestBody = new FormBody.Builder()
.add("username", "qinzishuai")
.add("password", "123456")
.build();
Request request = new Request.Builder()
.url("https://www.wanandroid.com/user/login")
.post(requestBody)
.build()
看到上面代码是不是很熟悉?和 OkHttpClient 很相似, 没错 Request 的构建也是 Builder 模式!我们点击 Request 源码进去,果然其中有静态的 Builder 内部类:
然后我们查一下Request在初始化时配置了哪些参数???
public static class Builder {
HttpUrl url;
String method;
Headers.Builder headers;
RequestBody body;
public Builder() {
this.method = "GET";
this.headers = new Headers.Builder();
}
//省略部分代码
public Request build() {
if (url == null) throw new IllegalStateException("url == null");
return new Request(this);
}
}
从代码看到了,如果没有声明,默认是 Get 请求 this.method = "GET" ,至于 url 等字段需要我们自己去配置:
- HttpUrl
请求访问的 url ,可以传 String 与 URL 具体方法如下:
public Builder url(String url) {
if (url == null) throw new NullPointerException("url == null");
// Silently replace web socket URLs with HTTP URLs.
if (url.regionMatches(true, 0, "ws:", 0, 3)) {
url = "http:" + url.substring(3);
} else if (url.regionMatches(true, 0, "wss:", 0, 4)) {
url = "https:" + url.substring(4);
}
return url(HttpUrl.get(url));
}
public Builder url(URL url) {
if (url == null) throw new NullPointerException("url == null");
return url(HttpUrl.get(url.toString()));
}
- method
请求类型 String method,支持多种请求类型
- Headers
Headers.Builder Http 消息的头字段
- body
RequestBody 类型,它是抽象类, 有些请求需要我们传入 body 实例 ,我们在通过源码来看一下:
如果是 GET 请求,body对象传的是 null
RequestBody解析
首先我们看一下RequestBody如何初始化??拿提交表单举例:
RequestBody requestBody = new FormBody.Builder()
.add("username", "qinzishuai")
.add("password", "000000")
.build();
不出所料,也是 Builder 模式,而且 RequestBody 是抽象类, FormBody 是 RequestBody 的其中一种实现类 ,另一个实现类是 MultipartBody
RequestBody 源码如下:
public abstract class RequestBody {
/** Returns the Content-Type header for this body. */
public abstract @Nullable MediaType contentType();
/**
* Returns the number of bytes that will be written to {@code sink} in a call to {@link #writeTo},
* or -1 if that count is unknown.
*/
public long contentLength() throws IOException {
return -1;
}
/** Writes the content of this request to {@code sink}. */
public abstract void writeTo(BufferedSink sink) throws IOException;
/**
* Returns a new request body that transmits {@code content}. If {@code contentType} is non-null
* and lacks a charset, this will use UTF-8.
*/
public static RequestBody create(@Nullable MediaType contentType, String content) {
Charset charset = Util.UTF_8;
if (contentType != null) {
charset = contentType.charset();
if (charset == null) {
charset = Util.UTF_8;
contentType = MediaType.parse(contentType + "; charset=utf-8");
}
}
byte[] bytes = content.getBytes(charset);
return create(contentType, bytes);
}
/** Returns a new request body that transmits {@code content}. */
public static RequestBody create(
final @Nullable MediaType contentType, final ByteString content) {
return new RequestBody() {
@Override public @Nullable MediaType contentType() {
return contentType;
}
@Override public long contentLength() throws IOException {
return content.size();
}
@Override public void writeTo(BufferedSink sink) throws IOException {
sink.write(content);
}
};
}
/** Returns a new request body that transmits {@code content}. */
public static RequestBody create(final @Nullable MediaType contentType, final byte[] content) {
return create(contentType, content, 0, content.length);
}
//省略部分代码...
}
核心方法有三个:
contentType():数据类型
contentLength():数据长度
writeTo(BufferedSink sink) :写操作
Call分析
newCall分析
Call初始化
我们首先看一下在哪用到了Call:
final Call call = okHttpClient.newCall(request);
想起来了吧?无论是 get 还是 post 请求 都要生成 call 对象,在上面我们发现 call 实例需要一个 okHttpClient 与 request 实例 ,我们先点进 Call 类去看看:
public interface Call extends Cloneable {
//请求
Request request();
//同步
Response execute() throws IOException;
//异步
void enqueue(Callback responseCallback);
//取消请求
void cancel();
//是否在请求过程中
boolean isExecuted();
//是否取消
boolean isCanceled();
Call clone();
//工厂接口
interface Factory {
Call newCall(Request request);
}
}
我们发现 Call 是个接口, 并定义了一些方方法(方法含义在注释上)。
我们继续看 newCal() 方法:
@Override public Call newCall(Request request) {
return RealCall.newRealCall(this, request, false /* for web socket */);
}
继续点击 newRealCall() :
private RealCall(OkHttpClient client, Request originalRequest, boolean forWebSocket) {
this.client = client;
this.originalRequest = originalRequest;
this.forWebSocket = forWebSocket;
this.retryAndFollowUpInterceptor = new RetryAndFollowUpInterceptor(client, forWebSocket);
}
static RealCall newRealCall(OkHttpClient client, Request originalRequest, boolean forWebSocket) {
// Safely publish the Call instance to the EventListener.
RealCall call = new RealCall(client, originalRequest, forWebSocket);
call.eventListener = client.eventListenerFactory().create(call);
return call;
}
从代码中我们发现在 newRealCall() 中初始化了 RealCall,RealCall 中初始化了 retryAndFollowUpInterceptor :
client:OkHttpClient 实例
originalRequest :最初的Request
forWebSocket :是否支持websocket通信
retryAndFollowUpInterceptor 从字面意思来说, 是重试和重定向拦截器 ,至于它有什么作用我们继续往下看
同步请求分析
Response response = call.execute();
我们点进 execute() 中查看:
@Override public Response execute() throws IOException {
synchronized (this) {
if (executed) throw new IllegalStateException("Already Executed");
executed = true;
}
captureCallStackTrace();
eventListener.callStart(this);
try {
client.dispatcher().executed(this);
Response result = getResponseWithInterceptorChain();
if (result == null) throw new IOException("Canceled");
return result;
} catch (IOException e) {
eventListener.callFailed(this, e);
throw e;
} finally {
client.dispatcher().finished(this);
}
}
从上面代码得知步骤:
通过 synchronized 保证线程同步,判断是否已经执行过 ,如果是直接抛异常
captureCallStackTrace(); 字面意思:捕获调用堆栈跟踪,我们通过源码发现里面涉及到了 retryAndFollowUpInterceptor
eventListener 回调 CallStart()
client.dispatcher().executed(this); 看到了 dispatcher 是不是很熟悉?之前在分析 okhttpClient 初始化的时候遇到了,我们点击 executed() 方法进去:
synchronized void executed(RealCall call) {
runningSyncCalls.add(call);
}
发现把我们传进来的 realcall 放到了 runningSyncCalls 队列中,从字面意思来说就是正在运行的同步的调用队列中,为什么说是队列呢?
private final Deque runningSyncCalls = new ArrayDeque<>();
- 我们回到 execute() 继续往下分析,剩下的代码我们提取出三行代码:
equesr result = getResponseWithInterceptorChain(); 生成一个 Response 实例
eventListener.callFailed(this, e); :eventListener 的 callFailed回调
client.dispatcher().finished(this); :dispatcher 实例的 finished方法
getResponseWithInterceptorChain() 分析
Response getResponseWithInterceptorChain() throws IOException {
// Build a full stack of interceptors.
List interceptors = new ArrayList<>();
interceptors.addAll(client.interceptors()); //自定义
interceptors.add(retryAndFollowUpInterceptor); //错误与跟踪拦截器
interceptors.add(new BridgeInterceptor(client.cookieJar())); //桥拦截器
interceptors.add(new CacheInterceptor(client.internalCache())); //缓存拦截器
interceptors.add(new ConnectInterceptor(client)); //连接拦截器
if (!forWebSocket) {
interceptors.addAll(client.networkInterceptors()); //网络拦截器
}
interceptors.add(new CallServerInterceptor(forWebSocket)); //调用服务器拦截器
Interceptor.Chain chain = new RealInterceptorChain(interceptors, null, null, null, 0,
originalRequest, this, eventListener, client.connectTimeoutMillis(),
client.readTimeoutMillis(), client.writeTimeoutMillis());
return chain.proceed(originalRequest);
}
从上面代码不难看出, 对最初的 request 做了层层拦截,每个拦截器的原理我们放在以后的章节去讲, 这里就不展开了!这里需要强调的一下 interceptors.addAll(client.interceptors()); ,client.interceptors() 是我们自定义的拦截器 它是在哪定义的?如何添加?我们去 OkHttpClient 类中发现:
可以通过初始化 OkHttpClient 实例 .addInterceptor 的形式添加。
另外这里涉及到了责任链设计模式,下节具体讲!
异步请求分析
call.enqueue(new Callback() {
@Override
public void onFailure(Call call, IOException e) {
Log.d("okhttp_error",e.getMessage());
}
@Override
public void onResponse(Call call, Response response) throws IOException {
Gson gson=new Gson();
Log.d("okhttp_success",response.body().string());
}
});
点击 enqueue() 查看:
@Override public void enqueue(Callback responseCallback) {
synchronized (this) {
if (executed) throw new IllegalStateException("Already Executed");
executed = true;
}
captureCallStackTrace();
eventListener.callStart(this);
client.dispatcher().enqueue(new AsyncCall(responseCallback));
}
通过 synchronized 保证线程同步,判断是否已经执行过 ,如果是直接抛异常
captureCallStackTrace(); 字面意思:捕获调用堆栈跟踪,我们通过源码发现里面涉及到了 retryAndFollowUpInterceptor
eventListener 回调 CallStart()
client.dispatcher().enqueue(new AsyncCall(responseCallback)); 调用了 Dispatcher.enqueue() 并传入了一个 new AsyncCall(responseCallback) 实例,点击 AsyncCall 查看:
AsyncCall 是 RealCall 的内部类!
final class AsyncCall extends NamedRunnable {
private final Callback responseCallback;
AsyncCall(Callback responseCallback) {
super("OkHttp %s", redactedUrl());
this.responseCallback = responseCallback;
}
String host() {
return originalRequest.url().host();
}
Request request() {
return originalRequest;
}
RealCall get() {
return RealCall.this;
}
@Override protected void execute() {
boolean signalledCallback = false;
try {
Response response = getResponseWithInterceptorChain();
if (retryAndFollowUpInterceptor.isCanceled()) {
signalledCallback = true;
responseCallback.onFailure(RealCall.this, new IOException("Canceled"));
} else {
signalledCallback = true;
responseCallback.onResponse(RealCall.this, response);
}
} catch (IOException e) {
if (signalledCallback) {
// Do not signal the callback twice!
Platform.get().log(INFO, "Callback failure for " + toLoggableString(), e);
} else {
eventListener.callFailed(RealCall.this, e);
responseCallback.onFailure(RealCall.this, e);
}
} finally {
client.dispatcher().finished(this);
}
}
}
AsyncCall 继承了 NamedRunnable ,我们看下 NamedRunnable 是什么:
public abstract class NamedRunnable implements Runnable {
protected final String name;
public NamedRunnable(String format, Object... args) {
this.name = Util.format(format, args);
}
@Override public final void run() {
String oldName = Thread.currentThread().getName();
Thread.currentThread().setName(name);
try {
execute();
} finally {
Thread.currentThread().setName(oldName);
}
}
protected abstract void execute();
}
原来 NamedRunnable 实现了 Runnable 接口是个线程类,在 run() 中 添加了抽象的 execute(); 方法,看到这里 我们应该有一个反应,那就是 AsyncCall 中具体的 execute() 应该在子线程执行
我们继续分析,client.dispatcher().enqueue(new AsyncCall(responseCallback)); 点击进入 enqueue():
synchronized void enqueue(AsyncCall call) {
if (runningAsyncCalls.size() < maxRequests && runningCallsForHost(call) < maxRequestsPerHost) {
runningAsyncCalls.add(call);
executorService().execute(call);
} else {
readyAsyncCalls.add(call);
}
}
runningAsyncCalls 正在运行的异步请求的队列
maxRequests 最大的请求数 64
maxRequestsPerHost host最大请求数 5 (可以通过Get与Set方式自定义设置)
如果正在运行的异步请求的队列大小低于 64 并且正在请求的 host 数量低于 5,就会执行(满足条件)
runningAsyncCalls.add(call);
executorService().execute(call);
这里把 AsyncCall 实例添加到 runningAsyncCalls中。
ExecutorService 表示线程池 继续看 executorService():
public synchronized ExecutorService executorService() {
if (executorService == null) {
executorService = new ThreadPoolExecutor(0, Integer.MAX_VALUE, 60, TimeUnit.SECONDS,
new SynchronousQueue(), Util.threadFactory("OkHttp Dispatcher", false));
}
return executorService;
}
其实就是生成了 executorService 实例,这就明白了,AsyncCall 实例放入线程池中执行了!如果不满足上面的请求数等条件:
readyAsyncCalls.add(call);
就会被添加到一个等待就绪的异步请求队列中,目的是什么呢???当然是等待时机再次添加到 runningAsyncCalls 中并放入线程池中执行,这块逻辑在 AsyncCall 类中的 execute() 至于原因我们继续往下看!
刚才我们说了,如果条件满足, AsyncCall实例就会在线程池中执行(.start),那我们直接去看run()中的 execute() :
@Override protected void execute() {
boolean signalledCallback = false;
try {
Response response = getResponseWithInterceptorChain();
if (retryAndFollowUpInterceptor.isCanceled()) {
signalledCallback = true;
responseCallback.onFailure(RealCall.this, new IOException("Canceled"));
} else {
signalledCallback = true;
responseCallback.onResponse(RealCall.this, response);
}
} catch (IOException e) {
if (signalledCallback) {
// Do not signal the callback twice!
Platform.get().log(INFO, "Callback failure for " + toLoggableString(), e);
} else {
eventListener.callFailed(RealCall.this, e);
responseCallback.onFailure(RealCall.this, e);
}
} finally {
client.dispatcher().finished(this);
}
}
上面代码中得知, 首先通过层层拦截器链处理生成了 response;然后通过一系列的判断,responseCallback 进行 onResponse 与 onFailure 回调,最后调用的 Dispatcher.finifshed()
这里需要注意的是 这里的 Dispatcher.finifshed(this) 与同步中的 Dispatcher.finifshed(this) 不一样 参数不同。
/** Used by {@code AsyncCall#run} to signal completion. */
void finished(AsyncCall call) {
finished(runningAsyncCalls, call, true);
}
我们继续看具体的 finifshed() 方法:
private void finished(Deque calls, T call, boolean promoteCalls) {
int runningCallsCount;
Runnable idleCallback;
synchronized (this) {
if (!calls.remove(call)) throw new AssertionError("Call wasn't in-flight!");
if (promoteCalls) promoteCalls();
runningCallsCount = runningCallsCount();
idleCallback = this.idleCallback;
}
if (runningCallsCount == 0 && idleCallback != null) {
idleCallback.run();
}
}
在线程同步的情况下 执行了 promoteCalls();:
private void promoteCalls() {
if (runningAsyncCalls.size() >= maxRequests) return; // Already running max capacity.
if (readyAsyncCalls.isEmpty()) return; // No ready calls to promote.
for (Iterator i = readyAsyncCalls.iterator(); i.hasNext(); ) {
AsyncCall call = i.next();
if (runningCallsForHost(call) < maxRequestsPerHost) {
i.remove();
runningAsyncCalls.add(call);
executorService().execute(call);
}
if (runningAsyncCalls.size() >= maxRequests) return; // Reached max capacity.
}
}
经过一系列的判断, 对等待就绪的异步队列进行遍历,生成对应的 AsyncCall 实例,并添加到 runningAsyncCalls 中,最后放入到线程池中执行!这里就是我们上面说到的等待就绪的异步队列如何与 runningAsyncCalls 对接的逻辑。
总结
同步请求流程:
生成 call 实例 realcall
Dispatcher.executed() 中的 runningSyncCalls 添加 realcall 到此队列中
通过 getResponseWithInterceptorChain() 对 request 层层拦截,生成 Response
通过 Dispatcher.finished(),把 call 实例从队列中移除,返回最终的 response
异步请求流程:
生成一个 AsyncCall(responseCallback) 实例(实现了 Runnable)
AsyncCall 实例放入了 Dispatcher.enqueue() 中,并判断 maxRequests (最大请求数)maxRequestsPerHost (最大 host 请求数)是否满足条件,如果满足就把 AsyncCall 添加到 runningAsyncCalls 中,并放入线程池中执行;如果条件不满足,就添加到等待就绪的异步队列,当那些满足的条件的执行时 ,在Dispatcher.finifshed(this) 中的 promoteCalls(); 方法中 对等待就绪的异步队列进行遍历,生成对应的AsyncCall实例,并添加到 runningAsyncCalls 中,最后放入到线程池中执行,一直到所有请求都结束。