快捷導(dǎo)航

詳解Android項(xiàng)目多服務(wù)端接口適配(超簡(jiǎn)單)

更新時(shí)間：2020年08月10日 08:29:35 作者：DonaldDu

這篇文章主要介紹了Android項(xiàng)目多服務(wù)端接口適配(超簡(jiǎn)單)，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

現(xiàn)狀

Android項(xiàng)目如果是多服務(wù)端接口時(shí)，一般怎么弄呢？

方法1：服務(wù)器地址放在Header中

把服務(wù)器地址放在接口Header中，然后通過攔截器來動(dòng)態(tài)修改請(qǐng)求地址而實(shí)現(xiàn)的。除了默認(rèn)服務(wù)器的接口，其它都要加一個(gè)Header，有點(diǎn)麻煩。看起來也不爽，不簡(jiǎn)潔。

interface ApiHeaderCase {
  /************************** server A ****************************/
  @Headers("host:$SERVER_HOST_A")
  @GET("user/loginWithScanCode")
  fun aMethod1(@Query("id") id: Int): Observable<ResponseBody>

  /************************** server B ****************************/
  @Headers("host:$SERVER_HOST_B")
  @GET("user/loginWithScanCode")
  fun bMethod1(@Query("id") id: Int): Observable<ResponseBody>
}

方法2：多套服務(wù)類，實(shí)例化為多個(gè)對(duì)象，準(zhǔn)確查找接口歸屬服務(wù)

定義多個(gè)類，每個(gè)類定義一套服務(wù)接口。然后分別實(shí)例化為多個(gè)對(duì)象，再使用準(zhǔn)確的對(duì)象來調(diào)用接口。這種方法運(yùn)行效率是最高的，但是在開發(fā)時(shí)，可能無法快速知道接口歸屬與哪個(gè)服務(wù)，需要查看代碼才能準(zhǔn)確知曉，可以說是少了代碼提示能力。

interface ApiA {
  @GET("user/loginWithScanCode")
  fun methodA(@Query("id") id: Int): Observable<ResponseBody>
}

interface ApiB {
  @GET("user/loginWithScanCode")
  fun methodB(@Query("id") id: Int): Observable<ResponseBody>
}

方法3：全寫在一起，實(shí)例化為多個(gè)對(duì)象，準(zhǔn)確調(diào)用方法

把所有接口都寫在一個(gè)類中，然后根據(jù)服務(wù)地址分別實(shí)例化為多個(gè)對(duì)象。再準(zhǔn)確調(diào)用方法，為了保證準(zhǔn)確調(diào)用方法，可以給每個(gè)接口加個(gè)服務(wù)名的前綴，以減少方法調(diào)錯(cuò)的問題。

interface ApiAllInOne {
  /************************** server A ****************************/
  @GET("user/loginWithScanCode")
  fun aMethod1(@Query("id") id: Int): Observable<ResponseBody>

  /************************** server B ****************************/
  @GET("user/loginWithScanCode")
  fun bMethod1(@Query("id") id: Int): Observable<ResponseBody>
}

const val SERVER_HOST_A = "https://www.a.com/"
const val SERVER_HOST_B = "https://www.b.com/"
fun getApi(retrofit: Retrofit, host: String): ApiAllInOne {
  return retrofit.newBuilder()
      .baseUrl(host).build()
      .create(ApiAllInOne::class.java)
}

fun showNomalUseCase(retrofit: Retrofit) {
  val apiA = getApi(retrofit, SERVER_HOST_A)//save as single instance for repeated usage
  apiA.aMethod1(1).subscribe()
  apiA.bMethod1(1).subscribe()//invalid usage, but no compile error

  val apiB = getApi(retrofit, SERVER_HOST_B)
  apiB.bMethod1(1).subscribe()
  apiB.aMethod1(1).subscribe()//invalid usage, but no compile error
}

有更簡(jiǎn)單的方法嗎？

當(dāng)然有了，而且超方便！

定義接口

（建議）在一個(gè)KT文件中定義所有接口，方便查找和維護(hù)。

interface ApiHolder : ApiA, ApiB

  @BaseUrl("https://www.a.com/")
  interface ApiA {
    @GET("user/loginWithScanCode")
    fun methodA(@Query("id") id: Int): Observable<ResponseBody>
  }

  @BaseUrl("https://www.b.com/")
  interface ApiB {
    @GET("user/loginWithScanCode")
    fun methodB(@Query("id") id: Int): Observable<ResponseBody>
  }

建工具類

一般都需要個(gè)工具類的，方便配置攔截器等。如果沒有自定義的需求，也可以直接實(shí)例化來用。

可以重寫invokeApi方法，全局給每個(gè)Observable設(shè)定線程。

class ApiUtil : ApiHolderUtil<ApiHolder>(ApiHolder::class) {
  companion object {
    val apiUtil = ApiUtil()
    val api = apiUtil.api
  }

  override fun invokeApi(api: Any, method: Method, args: Array<*>?): Any {
    val observable = super.invokeApi(api, method, args) as Observable<*>
    return observable.subscribeOn(Schedulers.io())
        .observeOn(AndroidSchedulers.mainThread())
  }
}

動(dòng)態(tài)更新服務(wù)地址

還可以動(dòng)態(tài)更新服務(wù)地址，比如實(shí)現(xiàn)測(cè)試服務(wù)和正式服務(wù)間切換。

//update api baseUrl when needed
  apiUtil.updateApi(ApiA::class, https://www.a2.com/)

調(diào)用接口

api.methodA(1).subscribe()
  api.methodB(1).subscribe()

引入依賴

dependencies {
  implementation 'com.github.DonaldDu:ApiHolder:x.x.x'//JitPack version
}

該項(xiàng)目使用的三方庫

OkHttp3
Retrofit2
rxjava3（可以修改為rxjava2）

api 'com.squareup.okhttp3:okhttp:4.7.2'
  api "com.squareup.retrofit2:retrofit:2.9.0"
  api "com.squareup.retrofit2:converter-gson:2.9.0"
  api "com.squareup.retrofit2:adapter-rxjava3:2.9.0"
  api 'io.reactivex.rxjava3:rxandroid:3.0.0'

其它說明

rxjava3 ->rxjava2

可以根據(jù)需要調(diào)整為rxjava2，建議用最新的。

//重寫ApiHolderUtil如下方法，RxJava3CallAdapterFactory ->RxJava2CallAdapterFactory即可。
  protected open fun getRetrofit(client: OkHttpClient): Retrofit {
    return Retrofit.Builder()
        .validateEagerly(validateEagerly)
        .addConverterFactory(getGsonConverterFactory())
        .addCallAdapterFactory(RxJava3CallAdapterFactory.create())
        .baseUrl("http://www.demo.com/")
        .client(client)
        .build()
  }

Timeout

可以給每套服務(wù)設(shè)置不同的超時(shí)

@BaseUrl("https://www.b.com/")
@Timeout(read = 100, timeUnit = TimeUnit.SECONDS)
interface ApiB {
  @GET("user/loginWithScanCode")
  fun methodB(@Query("id") id: Int): Observable<ResponseBody>
}

到此這篇關(guān)于詳解Android項(xiàng)目多服務(wù)端接口適配(超簡(jiǎn)單)的文章就介紹到這了,更多相關(guān)Android多服務(wù)端接口適配內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: