RxRetroHttp如何為多套API請求適配

小編給大家分享一下RxRetroHttp如何為多套API請求適配，相信大部分人都還不怎么了解，因此分享這篇文章給大家參考一下，希望大家閱讀完這篇文章后大有收獲，下面讓我們一起去了解一下吧！

初始化

首先，大多庫的必備階段：初始化。我們先來看看初始化的代碼，在Application的onCreate中執行

RxRetroHttp.init(this)
      .setBaseUrl("http://api1.com/")
      .setApiResultClass(Api1Result.class)
      .generateRetroClient()

這樣，初始化就做完了。。。此處應有掌聲。。。

“我掌你大爺！！！說好的處理多套API規則呢！！！”

額咳。。。客觀莫急。。。待我徐徐道來

通過剛剛的初始化，你已經設置了App中主API請求的基本配置。如果你的App中，就像前言里描述的那樣，需要對接多套API規則，那么在初始化之后，再加入如下代碼

RxRetroHttp.getInstance()
      .setBaseUrl("https://api2.com/")
      .setApiResultClass(Api2Result.class)
      .generateRetroClient("API2")

相信大家已經看出區別了吧，沒錯，就是在generateRetroClient這個方法中，加入了一個Tag，而這個Tag，就是處理多套API請求的關鍵。

在setApiResultClass方法中，傳入的就是對于API規范的基類，具體情況會在后面講到。

調用

初始化完成后，如何調用呢

RxRetroHttp.create(Api2Service.class).getApi2Info()

我們可以看到，這就是Retrofit風格的調用方式。

在這里，Api2Service也就是Retrofit風格的ApiService，但是也略有不同

@RetroTag("API2")
public interface Api2Service {
  @GET("test/info")
  Observable<Api2Info> getApi2Info();
}

我們看看不同在哪，下面是純Retrofit的書寫方式

public interface Api2Service {
  @GET("test/info")
  Observable<Api2Result<Api2Info>> getApi2Info();
}

沒錯，區別就在于：

1、省去了基類的這一層包裹。這么做的原因是，個人認為，在ApiService這一層，每個接口定義都需要設置ApiResult包裹是不人性的，哈哈哈。

2、RetroTag接口，用于指示Tag，當然這是對于初始化時設置了Tag的API請求。

當然，如果你還是希望以基類包裹的方式，也是可以的，那就是在初始化的時候，不調用setApiResultClass方法就行了。

另外，如果你不想增加RetroTag注解，也是可以的，那在調用的時候，就需要調用另一個方法，放入Tag，如下：

RxRetroHttp.create(Api2Service.class, "API2").getApi2Info()

ApiResult

現在，我們來看看ApiResult。

在setApiResultClass方法中傳入的，是實現了IApiResult接口的請求返回基類，簡單的樣例代碼如下

public class Api2Result<T> implements IApiResult<T> {
  private int code;
  private String msg;
  private T result;
  @Override
  public boolean isSuccess(){
    return code == 1;
  }
  @Override
  public T getData(){
    return result;
  }
  @Override
  public String getResultMsg(){
    return msg;
  }
  @Override
  public String getResultCode(){
    return String.valueOf(code);
  }
  @Override
  public String getDataField(){
    return "result";
  }
}

其對應的返回json如下

{
  code: 1,
  msg: "請求成功",
  result: {
    ...
  }
}

這是一個較為常用的API返回格式，而我們所要做的，就是實現幾個基本方法，其中，isSuccess()返回的是請求成功的判斷，getData()返回的是請求到的具體數據，getResultMsg()返回的是API請求信息，getResultCode()表示返回碼，getDataField()返回的是json數據中表示具體數據的字段（在上面的json例子中，就是“result”）。

更多配置

Http請求不可能沒有相關的配置，而本框架并沒有為大家內置很多配置方法，原因是，我認為這并不是本框架的主要功能。當然，大家也是可以進行自定義配置的，配置方式如下：

RxRetroHttp.init(this).setXXX().setXXX();
Retrofit.Builder retrofitBuilder = RxRetroHttp.getRetrofitBuilder();
retrofitBuilder.setXXX().setXXX();
OkHttpClient.Builder okHttpBuilder = RxRetroHttp.getOkHttpClientBuilder();
okHttpBuilder.setXXX().setXXX();
RxRetroHttp.getInstance().generateRetroClient();
//RxRetroHttp.getInstance().generateRetroClient("YourTag")

當然各套API請求之間的配置也是隔離的。框架也提供了一些簡單的快捷配置方法，比如addInterceptor、addNetworkInterceptor等，更多的配置可以通過上述方式，獲取retrofitBuilder和okHttpBuilder來配置。

以上是“RxRetroHttp如何為多套API請求適配”這篇文章的所有內容，感謝各位的閱讀！相信大家都有了一定的了解，希望分享的內容對大家有所幫助，如果還想學習更多知識，歡迎關注億速云行業資訊頻道！