Android开发 -- Retrofit + Rxjava + Kotlin => Request API

前言

使用Retrofit 和 Rxjava以及基于kotlin配置网络请求端口，并使用Wiki百科的搜索接口得到搜索词条相关数目：https://en.wikipedia.org/w/api.php?action=query&format=json&list=search&srsearch=li%20zhaojia

步骤

1. 引用库：

//Retrofit
    implementation "com.squareup.retrofit2:retrofit:2.4.0"
    //Gson converter
    implementation "com.squareup.retrofit2:converter-gson:2.3.0"
    //String
    implementation "com.squareup.retrofit2:converter-scalars:2.3.0"
    //okhttp
    implementation "com.squareup.okhttp3:okhttp:3.10.0"
    implementation "com.squareup.okhttp3:logging-interceptor:3.8.0"
    //Rxjava
    implementation "com.squareup.retrofit2:adapter-rxjava2:2.4.0"
    //Rxjava2
    implementation "io.reactivex.rxjava2:rxandroid:2.0.2"
    implementation "io.reactivex.rxjava2:rxjava:2.1.9"
复制代码

2. 建立服务接口

interface WikiApiService{
    @GET("api.php")
    fun hitCountCheck(@QueryMap options:Map<String,String>):Observable<Model.Result>
    //an Observable, which is a Rxjava object that could analog as the endpoint fetcher result generator.
    companion object{
        fun create() :WikiApiService{
            val retrofit = Retrofit.Builder()
                .addCallAdapterFactory(RxJava2CallAdapterFactory.create())
                .addConverterFactory(GsonConverterFactory.create())
                .baseUrl("https://en.wikipedia.org/w/")
                .build()
            return retrofit.create(WikiApiService::class.java)
        }
    }
}
复制代码

因为须要query的变量有些多，因此使用QueryMap来统一管理变量，在activity中定义HashMap。其中Observable返回的是一个object,是咱们本身定义的获取数据类，由于咱们想获取相似这种数据：

{
 batchcomplete: "",
 continue: {
  sroffset: 10,
  continue: "-||"
 },
 query: {
  searchinfo: {
   totalhits: 16776   //target data
 },
 search: [...
复制代码

3. 建立数据索引对象

其中totalhits是咱们想获取的数据，咱们须要results -> query -> searchinfo -> totalhits ，因此咱们须要建立一个新的object来存放数据索引：

object Model {
    data class Result(val query: Query)
    data class Query(val searchinfo: SearchInfo)
    data class SearchInfo(val totalhits: Int)
}
复制代码

4. 在Activity中使用懒加载来建立observable实例并建立可取消的disposable:

private var disposable: Disposable? = null   // disposable is a cancelable object
private val wikiApiServe by lazy {
    WikiApiService.create()
}
复制代码

而后建立功能函数：

@SuppressLint("SetTextI18n")
private fun beginSearch(srsearch : String){
    val options = HashMap<String,String>()
    options["action"] = "query"
    options["format"] = "json"
    options["list"] = "search"
    options["srsearch"] = srsearch
    //Scheduler: Thread control
    disposable = wikiApiServe.hitCountCheck(options)
        .subscribeOn(Schedulers.io())  //subscribeOn(): choose a Thread to produce I/O scheduler:（read&write data、read&write db、change info on the Internet）
        .observeOn(AndroidSchedulers.mainThread())  //observeOn(): choose a Thread to spend AndroidSchedulers.mainThread()，on Android UI(main Thread)
        .subscribe(
            { result -> show_result.text = "${result.query.searchinfo.totalhits} results found"},
            { error -> Toast.makeText(this, error.message, Toast.LENGTH_LONG).show()}
        )
}
复制代码

在须要获取的edit text中使用这个功能函数就能够得到该搜索词条在wiki百科中的数目。

get_result.setOnClickListener {
    val text = edit_text.text.toString()
    if (edit_text.text.toString().isNotEmpty()){
        Toast.makeText(this, edit_text.text.toString(), Toast.LENGTH_LONG).show()
        beginSearch(text)
    }
}
复制代码

总结

在分线程中没法改变UI，也就是说必须在UI线程（AndroidSchedulers.MainThrea()）中才能改变UI布局。

建立接口服务的方法能够在interface中建立，也能够在Activity中建立，在interface中须要使用companion object，而后在Activity中实例化。