OkHttp_3.12.0源码分析

OkHttp_3.12.0源码分析

基于OkHttp:3.12.0:https://github.com/square/okhttp/tree/okhttp_3.12.x

RTFSC

Read The Fucking Source Code

流程分析

  1. 用户层面调用形式:
OkHttpClient#newCall(new Request())#enquenue(new Callback(){})

  1. OkHttpClient#newCall(new Request()):OkHttpClient根据client、request创建RealCall,RealCall里面包含所有请求的各种配置信息:拦截器、请求连接、调度器Dispatcher、ConnectionPool等
//OkHttpClient
@Override public Call newCall(Request request) {
    return RealCall.newRealCall(this, request, false /* for web socket */);
  }
  1. RealCall#enqueue(new Callback(){}):
    1. 通过RealCall中的client间接获取Dispatcher--维护一个线程池、readyAsyncCalls、runningAsyncCalls、runningSyncCalls三个请求队列。
    2. Dispatcher的enqueue会把当前的responseCallback包装成AsyncCall的形式放入readyAsyncCalls队列中,注意AsyncCall实现了Runnable接口。
//RealCall
@Override public void enqueue(Callback responseCallback) {
     //其它信息...    
     client.dispatcher().enqueue(new AsyncCall(responseCallback));
  }
  
// Dispatcher    
 void enqueue(AsyncCall call) {
    synchronized (this) {
         readyAsyncCalls.add(call);
        }
        promoteAndExecute();
    } 
  1. Dispatcher#promoteAndExecute:这一步会遍历readyAsyncCalls把准备队列中的AsyncCall放到runningAsyncCalls运行队列中;同时放到立马执行的一个列表中:executableCalls。这里一些额外的判断是:,请求是否超过了最大请求数maxRequests,同一个host是否大于maxRequestsPerHostmaxRequests。
    //Dispatcher
    private boolean promoteAndExecute() {
        //...
        List<AsyncCall> executableCalls = new ArrayList<>();
        //伪代码...
        if(满足一定条件){executableCalls.addAll(readyAsyncCalls)}
    
        for (int i = 0, size = executableCalls.size(); i < size; i++) {
          AsyncCall asyncCall = executableCalls.get(i);
          asyncCall.executeOn(executorService());
        }
    
        return isRunning;
      }
  1. AsyncCall#executeOn(executorService()):

    1. AsyncCall#executeOn(ExecutorService):通过线程池执行当前对象,会调用上层NamedRunnable的run()方法。重点:这里完成线程切换逻辑,因为下面就要开始去执行耗时操作。
    2. NamedRunnable#run方法会调用execute(),具体逻辑在子类AsyncCall实现。
    3. AsyncCall#execute()是真正获取Response值、把值回调给responseCallback的步骤。
   //AsyncCall 
   void executeOn(ExecutorService executorService) {
       //...
       executorService.execute(this);//这里会调用父类的run方法
       //...
   }
    //NamedRunnable, AsyncCall的父类  
    public abstract class NamedRunnable implements Runnable {
      //...    
      @Override public final void run() {
        //...
        execute();
      }
      //子类AsyncCall做对应实现
      protected abstract void execute();
    }        
        
   #AsyncCall
   @Override protected void execute() {
       boolean signalledCallback = false;
       timeout.enter();
       try {
       //关键,去获取response对象,真正的耗时也就在这
       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) {
           e = timeoutExit(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);
         }
       }
     }
     
  1. RealCall#getResponseWithInterceptorChain:
    1. RealCall#getResponseWithInterceptorChain会把用户自定义的拦截器、系统级别的拦截器放到list中组装好,给一个new RealInterceptorChain。这里需要注意拦截器加入的顺序,用户拦截器优先级最高->系统一些中间拦截->最后网络请求。
    2. RealInterceptorChain#proceed在这里会构造一个新的RealInterceptorChain:next,注意新的RealInterceptorChain中index+1;另外根据当前的index取得当前拦截器,执行拦截器中唯一的方法intercept(next),具体执行的哪一个呢,就看上层实现的是哪一个具体实现。
    3. 我们随便看一个实现,假如BridgeInterceptor:会在BridgeInterceptor中执行BridgeInterceptor相关的实现,最关键的会执行chain.proceed(requestBuilder.build()),注意Chain是上一个创建的RealInterceptorChain,所以又跑到了第二步,同时index这个时候已经+1,如此完成递归操作!
    4. 经过2、3两步,通过迭代操作,完整所有拦截器的执行。至于说网络请求、缓存、重试、日志等等核心包括外围功能,全部通过拦截器实现,并且责任分明,高度解耦合,实现方式:责任链模式。
#RealCall
Response getResponseWithInterceptorChain() throws IOException {
    // Build a full stack of interceptors.
    List<Interceptor> 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);
  }
  
#RealInterceptorChain
@Override public Response proceed(Request request) throws IOException {
    return proceed(request, streamAllocation, httpCodec, connection);
  }

  public Response proceed(Request request, StreamAllocation streamAllocation, HttpCodec httpCodec,
      RealConnection connection) throws IOException {
    //...
    
    //注意这里又构造了一个RealInterceptorChain,重点index+1
    RealInterceptorChain next = new RealInterceptorChain(interceptors, streamAllocation, httpCodec,
        connection, index + 1, request, call, eventListener, connectTimeout, readTimeout,
        writeTimeout);
        
    //取当前index对应的拦截器
    Interceptor interceptor = interceptors.get(index);
    //执行取到的拦截器
    Response response = interceptor.intercept(next);
    
    //...
    return response;
  }

# BridgeInterceptor
@Override public Response intercept(Chain chain) throws IOException {
    //根据上游chain继续处理当前拦截器。注意:chain的源头:RealInterceptorChain#proceed中创建的next,一个新的RealInterceptorChain
    Request userRequest = chain.request();
    Request.Builder requestBuilder = userRequest.newBuilder();

    //各种逻辑,跳过只看核心...
    
    //核心,这里又回到了RealInterceptorChain#proceed
    Response networkResponse = chain.proceed(requestBuilder.build());

    //后续逻辑...

    return responseBuilder.build();
  }

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 155,958评论 4 358
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,179评论 1 286
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 105,792评论 0 237
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,409评论 0 202
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 51,723评论 3 285
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,174评论 1 204
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,543评论 2 306
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,270评论 0 194
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 33,899评论 1 236
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,235评论 2 240
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,771评论 1 255
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,139评论 2 249
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,688评论 3 228
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,936评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,646评论 0 192
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,194评论 2 265
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,145评论 2 258

推荐阅读更多精彩内容