Net/docs/callback.md

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("日志", "请求失败")
        printStackTrace() // 如果发生错误就不为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请求方法|