详解Android项目多服务端接口适配(超简单)
现状
Android项目如果是多服务端接口时，一般怎么弄呢？
方法1：服务器地址放在Header中
把服务器地址放在接口Header中，然后通过拦截器来动态修改请求地址而实现的。除了默认服务器的接口，其它都要加一个Header，有点麻烦。看起来也不爽，不简洁。
interfaceApiHeaderCase{
/**************************serverA****************************/
@Headers("host:$SERVER_HOST_A")
@GET("user/loginWithScanCode")
funaMethod1(@Query("id")id:Int):Observable
/**************************serverB****************************/
@Headers("host:$SERVER_HOST_B")
@GET("user/loginWithScanCode")
funbMethod1(@Query("id")id:Int):Observable
}
方法2：多套服务类，实例化为多个对象，准确查找接口归属服务
定义多个类，每个类定义一套服务接口。然后分别实例化为多个对象，再使用准确的对象来调用接口。这种方法运行效率是最高的，但是在开发时，可能无法快速知道接口归属与哪个服务，需要查看代码才能准确知晓，可以说是少了代码提示能力。
interfaceApiA{
@GET("user/loginWithScanCode")
funmethodA(@Query("id")id:Int):Observable
}
interfaceApiB{
@GET("user/loginWithScanCode")
funmethodB(@Query("id")id:Int):Observable
}
方法3：全写在一起，实例化为多个对象，准确调用方法
把所有接口都写在一个类中，然后根据服务地址分别实例化为多个对象。再准确调用方法，为了保证准确调用方法，可以给每个接口加个服务名的前缀，以减少方法调错的问题。
interfaceApiAllInOne{
/**************************serverA****************************/
@GET("user/loginWithScanCode")
funaMethod1(@Query("id")id:Int):Observable
/**************************serverB****************************/
@GET("user/loginWithScanCode")
funbMethod1(@Query("id")id:Int):Observable
}
constvalSERVER_HOST_A="https://www.a.com/"
constvalSERVER_HOST_B="https://www.b.com/"
fungetApi(retrofit:Retrofit,host:String):ApiAllInOne{
returnretrofit.newBuilder()
.baseUrl(host).build()
.create(ApiAllInOne::class.java)
}
funshowNomalUseCase(retrofit:Retrofit){
valapiA=getApi(retrofit,SERVER_HOST_A)//saveassingleinstanceforrepeatedusage
apiA.aMethod1(1).subscribe()
apiA.bMethod1(1).subscribe()//invalidusage,butnocompileerror
valapiB=getApi(retrofit,SERVER_HOST_B)
apiB.bMethod1(1).subscribe()
apiB.aMethod1(1).subscribe()//invalidusage,butnocompileerror
}
有更简单的方法吗？
当然有了，而且超方便！
定义接口
（建议）在一个KT文件中定义所有接口，方便查找和维护。
interfaceApiHolder:ApiA,ApiB
@BaseUrl("https://www.a.com/")
interfaceApiA{
@GET("user/loginWithScanCode")
funmethodA(@Query("id")id:Int):Observable
}
@BaseUrl("https://www.b.com/")
interfaceApiB{
@GET("user/loginWithScanCode")
funmethodB(@Query("id")id:Int):Observable
}
建工具类
一般都需要个工具类的，方便配置拦截器等。如果没有自定义的需求，也可以直接实例化来用。
可以重写invokeApi方法，全局给每个Observable设定线程。
classApiUtil:ApiHolderUtil(ApiHolder::class){ companionobject{ valapiUtil=ApiUtil() valapi=apiUtil.api } overridefuninvokeApi(api:Any,method:Method,args:Array<*>?):Any{ valobservable=super.invokeApi(api,method,args)asObservable<*> returnobservable.subscribeOn(Schedulers.io()) .observeOn(AndroidSchedulers.mainThread()) } }
动态更新服务地址
还可以动态更新服务地址，比如实现测试服务和正式服务间切换。
//updateapibaseUrlwhenneeded 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'//JitPackversion
}
该项目使用的三方库
- 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即可。
protectedopenfungetRetrofit(client:OkHttpClient):Retrofit{
returnRetrofit.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)
interfaceApiB{
@GET("user/loginWithScanCode")
funmethodB(@Query("id")id:Int):Observable
}
到此这篇关于详解Android项目多服务端接口适配(超简单)的文章就介绍到这了,更多相关Android多服务端接口适配内容请搜索毛票票以前的文章或继续浏览下面的相关文章希望大家以后多多支持毛票票！
声明：本文内容来源于网络，版权归原作者所有，内容由互联网用户自发贡献自行上传，本网站不拥有所有权，未作人工编辑处理，也不承担相关法律责任。如果您发现有涉嫌版权的内容，欢迎发送邮件至：czq8825#qq.com（发邮件时，请将#更换为@）进行举报，并提供相关证据，一经查实，本站将立刻删除涉嫌侵权内容。