详解Android项目多服务端接口适配(超简单)

 更新时间:2020年08月10日 08:29:35   作者:DonaldDu  
这篇文章主要介绍了Android项目多服务端接口适配(超简单),文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

现状

Android项目如果是多服务端接口时,一般怎么弄呢?

方法1:服务器地址放在Header中

把服务器地址放在接口Header中,然后通过拦截器来动态修改请求地址而实现的。除了默认服务器的接口,其它都要加一个Header,有点麻烦。看起来也不爽,不简洁。

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:多套服务类,实例化为多个对象,准确查找接口归属服务

定义多个类,每个类定义一套服务接口。然后分别实例化为多个对象,再使用准确的对象来调用接口。这种方法运行效率是最高的,但是在开发时,可能无法快速知道接口归属与哪个服务,需要查看代码才能准确知晓,可以说是少了代码提示能力。

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:全写在一起,实例化为多个对象,准确调用方法

把所有接口都写在一个类中,然后根据服务地址分别实例化为多个对象。再准确调用方法,为了保证准确调用方法,可以给每个接口加个服务名的前缀,以减少方法调错的问题。

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
}

有更简单的方法吗?

当然有了,而且超方便!

定义接口

(建议)在一个KT文件中定义所有接口,方便查找和维护。

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

建工具类

一般都需要个工具类的,方便配置拦截器等。如果没有自定义的需求,也可以直接实例化来用。

可以重写invokeApi方法,全局给每个Observable设定线程。

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())
  }
}

动态更新服务地址

还可以动态更新服务地址,比如实现测试服务和正式服务间切换。

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

调用接口

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

引入依赖

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

该项目使用的三方库

  • 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

可以根据需要调整为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

可以给每套服务设置不同的超时

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

到此这篇关于详解Android项目多服务端接口适配(超简单)的文章就介绍到这了,更多相关Android多服务端接口适配 内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Android开发中Flutter组件实用技巧

    Android开发中Flutter组件实用技巧

    这篇文章主要为大家介绍了Android开发中Flutter组件实用技巧,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-05-05
  • Android 调用发送短信的方法

    Android 调用发送短信的方法

    这篇文章主要介绍了Android 调用发送短信的方法的相关资料,主要实现Android 调用短信的使用,希望通过本文能帮助到大家,需要的朋友可以参考下
    2017-09-09
  • Kotlin实用语法糖空安全类型转换及相等性判断

    Kotlin实用语法糖空安全类型转换及相等性判断

    这篇文章主要为大家介绍了Kotlin实用语法糖空安全类型转换及相等性判断示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-06-06
  • Android中Dialog自定义上下文花式菜单

    Android中Dialog自定义上下文花式菜单

    这篇文章主要为大家详细介绍了Android中Dialog自定义上下文花式菜单,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-10-10
  • Android TextView Marquee的应用实例详解

    Android TextView Marquee的应用实例详解

    这篇文章主要介绍了Android TextView Marquee的应用实例详解的相关资料,这里说明使用方法及简单实例和注意实现,需要的朋友可以参考下
    2017-08-08
  • Flutter调用Android和iOS原生代码的方法示例

    Flutter调用Android和iOS原生代码的方法示例

    这篇文章主要给大家介绍了关于Flutter调用Android和iOS原生代码的相关资料,文中通过示例代码介绍的非常详细,对大家学习或者使用Flutter具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧
    2019-04-04
  • Android setTag方法的key问题解决办法

    Android setTag方法的key问题解决办法

    这篇文章主要介绍了Android setTag方法的key问题解决办法的相关资料,需要的朋友可以参考下
    2016-09-09
  • Android语音识别技术详解及实例代码

    Android语音识别技术详解及实例代码

    这篇文章主要介绍了Android语音识别技术的相关资料,并附实例代码及实例实现效果图,需要的朋友可以参考下
    2016-09-09
  • Android实现美团外卖底部导航栏动画

    Android实现美团外卖底部导航栏动画

    这篇文章主要介绍了Android实现美团外卖底部导航栏动画,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2019-11-11
  • ActivityManagerService广播注册与发送示例解析

    ActivityManagerService广播注册与发送示例解析

    这篇文章主要为大家介绍了ActivityManagerService广播注册与发送示例解析,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-03-03

最新评论