OkHttp阅读笔记(一)

因为日常使用原因,目前只关心Http1.1协议相关的代码。
第一篇只关心执行流程,后续会仔细分析一些细节。
从一个简单的例子进入

 okHttpClient.newCall(new Request.Builder().build()).enqueue(new Callback() {
            @Override
            public void onFailure(Call call, IOException e) {}
            @Override
            public void onResponse(Call call, Response response) throws IOException {}
        });

从代码的角度上面来看,意思就是创建一个新的请求,然后将请求放入队列当中。
接着看实际的请求

@Override public Call newCall(Request request) {
    return new RealCall(this, request, false /* for web socket */);
  }

通过装饰模式,Request最终都会封装成RealCall,接着看一下enqueue操作

@Override public void enqueue(Callback responseCallback) {
    synchronized (this) {
      if (executed) throw new IllegalStateException("Already Executed");
      executed = true;//标记当前请求开始执行
    }
    captureCallStackTrace();
    // 这里将回调封装到AsyncCall中
    // 然后将当前请求送入OkHttpClient中的Dispatcher中
    client.dispatcher().enqueue(new AsyncCall(responseCallback));
  }

工作最后到了Dispatcher中,OkHttpClient创建的时候会创建一个Dispatcher

 private int maxRequests = 64;//calls的最大并发量
 private int maxRequestsPerHost = 5;//同一个请求host的最大允许并发请求
 //这两个参数共同决定了一个call是否可以进入执行状态

 /** Ready async calls in the order they'll be run.
  * 双向队列,用于放置那些准备开始异步请求的calls
  * */
  private final Deque readyAsyncCalls = new ArrayDeque<>();

  /** Running asynchronous calls. Includes canceled calls that haven't finished yet.
   * 双向队列,用于放置那些在运行中的异步calls,也包括那些已经执行然后被要求取消的calls(因为它们还没有完成)
   * */
  private final Deque runningAsyncCalls = new ArrayDeque<>();

 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;
  }

 synchronized void enqueue(AsyncCall call) {
    if (runningAsyncCalls.size() < maxRequests && runningCallsForHost(call) < maxRequestsPerHost) {
      //如果当前执行中的异步请求数目和已经执行的同一host数目没有超过最大值
      //添加到执行中队列并开始异步执行请求
      runningAsyncCalls.add(call);
      executorService().execute(call);
    } else {
      //否则进入准备执行队列当中
      readyAsyncCalls.add(call);
    }
  }

因为OkHttp不是单纯的基于Android平台实现,更应该看做java实现,所以说会看到最大并发量可以达到64之大,所以说平常做Android开发的时候还是要根据情况进行管理。
执行线程池为缓存线程池,用于更快的响应新的任务,尝试重用线程或者直接新起线程执行任务,这个对于快速的任务来说是一个不错的选择,不过对于Android平台来说,可能还是使用有所限制比较好,比方说使用固定核心线程数的线程池。
接下来任务开始执行,说明AsyncCall本身就是一个Runnable,接着看run()方法

@Override public final void run() {
    String oldName = Thread.currentThread().getName();
    Thread.currentThread().setName(name);
    try {
      execute();
    } finally {
      Thread.currentThread().setName(oldName);
    }
  }

@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 {
          responseCallback.onFailure(RealCall.this, e);
        }
      } finally {//最后对运行中队列进行处理,并且可以尝试唤醒等待队列中的请求,并且尝试回调空闲状态
        client.dispatcher().finished(this);
      }
    }

逻辑比较清晰,实际上就是在子线程中进行请求操作,并且对响应进行封装。
然后对结果进行callback回调,最后进行以下Dispatcher中的数据处理即可。
请求中出现任何异常或者被取消都会回调失败,这点稍微需要注意。
回调默认在子线程中,Android在使用的时候稍微注意线程的切换问题。
接下来看一下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()));
    //处理http协议的缓存逻辑
    interceptors.add(new CacheInterceptor(client.internalCache()));
    //处理socket建立连接或者复用连接过程,总之这里会建立连接
    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);
    return chain.proceed(originalRequest);
  }

获得请求结果的过程实际上就是上述那一堆拦截器的执行结果,执行控制逻辑在RealInterceptorChain中

public Response proceed(Request request, StreamAllocation streamAllocation, HttpCodec httpCodec,
                          RealConnection connection) throws IOException {
    if (index >= interceptors.size()) throw new AssertionError();

    calls++;

    // If we already have a stream, confirm that the incoming request will use it.
    if (this.httpCodec != null && !this.connection.supportsUrl(request.url())) {
      throw new IllegalStateException("network interceptor " + interceptors.get(index - 1)
              + " must retain the same host and port");
    }

    // If we already have a stream, confirm that this is the only call to chain.proceed().
    if (this.httpCodec != null && calls > 1) {
      throw new IllegalStateException("network interceptor " + interceptors.get(index - 1)
              + " must call proceed() exactly once");
    }

    // Call the next interceptor in the chain.
    // 为了获取响应结果,每一个拦截器最终都会通过RealChain.proceed来获得结果
    // 那么在这里会调用下一个拦截器
    // index会在调用的之前的拦截器的基础上+1
    RealInterceptorChain next = new RealInterceptorChain(
            interceptors, streamAllocation, httpCodec, connection, index + 1, request);
    //index默认为0
    Interceptor interceptor = interceptors.get(index);
    //也就是说拦截器的执行顺序满足添加顺序,然后内部会进行循环
    Response response = interceptor.intercept(next);

    // Confirm that the next interceptor made its required call to chain.proceed().
    if (httpCodec != null && index + 1 < interceptors.size() && next.calls != 1) {
      throw new IllegalStateException("network interceptor " + interceptor
              + " must call proceed() exactly once");
    }

    // Confirm that the intercepted response isn't null.
    if (response == null) {
      throw new NullPointerException("interceptor " + interceptor + " returned null");
    }

    return response;
  }

简要描述一下这个方法的意义,首先这里会获得RealCall中设置的拦截器列表,然后拿出当前标记的拦截器(从0开始),并且将下一个拦截器交给当前拦截器。
每一个拦截器的最终执行结果都是Response,这意味这如果拦截器自身产生Response返回,则调用链开始往回走。
如果通过之前传入的下一个拦截器执行,这样会导致调用链会继续向下执行,最终再向上执行。

总结

这一篇只是描述了执行的一个流程,从下一篇开始会描述每一个拦截器的意义。

你可能感兴趣的:(OkHttp阅读笔记(一))