Callback

Net支持OkHttp的原有的队列请求 -- Callback

如果你决定使用协程可以不必阅读本章

Callback属于接口回调请求, 属于最原始的请求方式. 其代码冗余可读性不高, 并且无法支持并发请求协作

Callback

Callback属于OkHttp最原始的请求回调接口

Net.post("api").enqueue(object : Callback {
    override fun onFailure(call: Call, e: IOException) {
    }

    override fun onResponse(call: Call, response: Response) {
    }
})

NetCallback

原始的Callback是没有任何数据转换和全局错误功能的. 这里可以使用NetCallback

Net.post("api") {
    param("password", "Net123")
}.enqueue(object : NetCallback<String>() {
    override fun onSuccess(call: Call, data: String) {
        tvFragment.text = data
    }
})

NetCallback相较于Callback的特性

1. 可以指定泛型数据转换
2. 新增三个回调函数: onSuccess/onFailure/onComplete
3. 以上三个回调函数都运行在主线程

基本特性也被扩展在Callback中. 除开库本身自带的Callback你也可以仿照实现自己的特殊Callback

函数	描述
DialogCallback	自动显示隐藏加载对话框
StateCallback	自动显示缺省页
PageCallback	自动下拉刷新/上拉加载

onResult

使用onResult可以更加灵活方便的处理队列请求. 使用Kotlin的空安全函数可以区分处理请求结果

Net.post("api").onResult<String> {

    getOrNull()?.let { // 如果成功就不为Null
        Log.d("日志", "请求成功")
        tvFragment.text = it
    }

    exceptionOrNull()?.apply {
        Log.d("日志", "请求失败")
        Net.printStackTrace(this) // 如果发生错误就不为Null
    }

    Log.d("日志", "完成请求")
}

onResult也是在主线程中执行

请求函数	描述
Net.get	标准Http请求方法
Net.post	标准Http请求方法
Net.head	标准Http请求方法
Net.options	标准Http请求方法
Net.trace	标准Http请求方法
Net.delete	标准Http请求方法
Net.put	标准Http请求方法
Net.patch	标准Http请求方法