迷之RxJava(四)—— Retrofit和RxJava的基情

概述

前文回顾: 迷之RxJava (三)—— 线程切换

今天来介绍下和RxJava搭配使用的好基友,就是我们的Retrofit啦,Retrofit使用动态代理的机制,为我们提供了一个简要的使用方法来获取网络上的资料,现在更新到2.0.0-beta2了(因为是beta,我也碰到一些坑,期待作者发布下一个版本)。

Retrofit不算是一个网络库,它应该算是封装了okhttp,然后为我们提供了一个友好的接口的一个工具库吧。

我们今天着重来介绍下RxJavaCallAdapterFactory这个类。用过的朋友们都知道,它是用来把Retrofit转成RxJava可用的适配类。

RxJavaCallAdapterFactory

OK,首先看下声明

public final class RxJavaCallAdapterFactory implements CallAdapter.Factory

CallAdapter.FactoryRetrofit这个库中的接口,用来给我们自定义去解析我们自己想要的类型用的。

举个栗子:

@GET("/aaa")
Observable getQuestionNewestList();

这么一个接口,retrofit本身是无法识别Observable然后去工作的,如果没有这个适配器就根本无法工作,因此我们的适配器的作用,就是生成我们想要的Observable

看下它的实现。

@Override
public CallAdapter get(Type returnType, Annotation[] annotations, Retrofit retrofit) {
    Class rawType = Utils.getRawType(returnType);
    boolean isSingle = "rx.Single".equals(rawType.getCanonicalName());
    if (rawType != Observable.class && !isSingle) {
      return null;
    }
    if (!(returnType instanceof ParameterizedType)) {
      String name = isSingle ? "Single" : "Observable";
      throw new IllegalStateException(name + " return type must be parameterized"
          + " as " + name + " or " + name + "");
    }
    
    CallAdapter> callAdapter = getCallAdapter(returnType);
    if (isSingle) {
      // Add Single-converter wrapper from a separate class. This defers classloading such that
      // regular Observable operation can be leveraged without relying on this unstable RxJava API.
      return SingleHelper.makeSingle(callAdapter);
    }
    return callAdapter;
}

这里代码的意思就是说,如果你返回的不是Observable这种类型,我就不干!
如果是的话,那我再来详细看下模板类是哪个,也就是getCallAdapter接口干的事。

private CallAdapter> getCallAdapter(Type returnType) {
    Type observableType = Utils.getSingleParameterUpperBound((ParameterizedType) returnType);
    Class rawObservableType = Utils.getRawType(observableType);
    if (rawObservableType == Response.class) {
      if (!(observableType instanceof ParameterizedType)) {
        throw new IllegalStateException("Response must be parameterized"
            + " as Response or Response");
      }
      Type responseType = Utils.getSingleParameterUpperBound((ParameterizedType) observableType);
      return new ResponseCallAdapter(responseType);
    }

    if (rawObservableType == Result.class) {
      if (!(observableType instanceof ParameterizedType)) {
        throw new IllegalStateException("Result must be parameterized"
            + " as Result or Result");
      }
      Type responseType = Utils.getSingleParameterUpperBound((ParameterizedType) observableType);
      return new ResultCallAdapter(responseType);
    }

    return new SimpleCallAdapter(observableType);
}

这里告诉我们,除了ObservableObservable需要不同的Adapter处理外,其他的都让SimpleCallAdapter处理。

OK,我们就不看别的,直捣黄龙,看SimpleCallAdapter

SimpleCallAdapter 创建Observable的类

static final class SimpleCallAdapter implements CallAdapter> {
    private final Type responseType;

    SimpleCallAdapter(Type responseType) {
      this.responseType = responseType;
    }

    @Override public Type responseType() {
      return responseType;
    }

    @Override public  Observable adapt(Call call) {
      return Observable.create(new CallOnSubscribe<>(call)) //
          .flatMap(new Func1, Observable>() {
            @Override public Observable call(Response response) {
              if (response.isSuccess()) {
                return Observable.just(response.body());
              }
              return Observable.error(new HttpException(response));
            }
          });
    }
  }

这里总算看见我们熟悉的Observable接口咯,原来是自己定义了一个OnSubscribe,然后把Response通过flatMap转为我们想要的对象了。 这里同时也判断请求是否成功,进入Observable的工作流里了。

好,我们最终可以看下CallOnSubscribe干了啥

static final class CallOnSubscribe implements Observable.OnSubscribe> {
    private final Call originalCall;

    private CallOnSubscribe(Call originalCall) {
      this.originalCall = originalCall;
    }

    @Override public void call(final Subscriber> subscriber) {
      // Since Call is a one-shot type, clone it for each new subscriber.
      final Call call = originalCall.clone();

      // Attempt to cancel the call if it is still in-flight on unsubscription.
      subscriber.add(Subscriptions.create(new Action0() {
        @Override public void call() {
          call.cancel();
        }
      }));

      if (subscriber.isUnsubscribed()) {
        return;
      }

      try {
        Response response = call.execute();
        if (!subscriber.isUnsubscribed()) {
          subscriber.onNext(response);
        }
      } catch (Throwable t) {
        Exceptions.throwIfFatal(t);
        if (!subscriber.isUnsubscribed()) {
          subscriber.onError(t);
        }
        return;
      }

      if (!subscriber.isUnsubscribed()) {
        subscriber.onCompleted();
      }
    }
}

这里其实蛮简单的,callretrofitokhttp的一个代理,是一个同步网络请求,在这里就是典型的对网络进行数据请求,完了放到subscriberonNext里,完成网络请求。我们可以看下,它把unsubscribe,也就是取消请求的情况处理的挺好。

subscriber.add(Subscriptions.create(new Action0() {
    @Override public void call() {
      call.cancel();
    }
}));

这段代码是给subscribe增加一个unsubscribe的事件。 也就是请求完成的时候,会自动对call进行一个终止,也就是httpclose行为。

前方高能

今天被坑到这里很久,我们对API调用了observeOn(MainThread)之后,线程会跑在主线程上,包括onComplete也是,unsubscribe也在主线程,然后如果这时候调用call.cancel会导致NetworkOnMainThreadException,所以一定要在retrofit的API调用ExampleAPI.subscribeOn(io).observeOn(MainThread)之后加一句unsubscribeOn(io)

完整的就是ExampleAPI.subscribeOn(io).observeOn(MainThread).unsubscribeOn(io)

你可能感兴趣的:(迷之RxJava(四)—— Retrofit和RxJava的基情)