自动加载框

Net支持发起请求的时候自动弹出和关闭对话框(Loading Dialog)

自动显示加载框¶

只需要使用scopeDialog作用域即可.

scopeDialog {
    tvFragment.text = Post<String>("dialog") {
        param("u_name", "drake") // 请求参数
        param("pwd", "123456")
    }.await()
}

加载框默认使用的是Android原生加载框(MaterialDesign Dialog), 当然也提供参数传入指定每个请求的对话框

指定单例加载框¶

就是仅针对当前网络请求指定加载框

val dialog = BubbleDialog(requireActivity(), "加载中")

scopeDialog(dialog) {
    binding.tvFragment.text = Post<String>("dialog") {
        param("u_name", "drake")
        param("pwd", "123456")
    }.await()
}

这里使用的iOS风格对话框: BubbleDialog

指定全局加载框¶

在Application中配置Net时就可以设置默认的Dialog

初始配置全局加载框

NetConfig.init("http://github.com/") {
        setDialogFactory { // 全局加载对话框
            ProgressDialog(it).apply {
                setMessage("我是全局自定义的加载对话框...")
            }
        }
}

修改全局加载框

NetConfig.dialogFactory = NetDialogFactory {
    ProgressDialog(it).apply {
        setMessage("我是全局自定义的加载对话框...")
    }
}

如果不想修改全局加载框样式只是修改加载框文本, 可以覆盖文本(国际化同理)

在当前项目下的values目录下的strings.xml添加以下一行可以修改文本

<!--对话框-->
<string name="net_dialog_msg">加载中</string>

生命周期¶

使用scopeDialog发起请求后, Dialog分为以下三个生命周期

生命周期	描述
Dialog 显示	执行`scopeDialog`时显示加载框
Dialog 自动结束	作用域内任务结束时关闭加载框
Dialog 手动结束	加载框被手动取消时取消作用域内网络请求

自定义加载对话框¶

我想要自定义加载框视图

Dialog属于布局容器, 你可以继承Dialog然后创建属于自己的显示内容(类似Activity/Fragment), 比如该iOS风格对话框

我的加载框不是Dialog

虽然我们指定scopeDialog的加载框或者setNetDialogFactory时只允许传入一个Dialog对象, 但即使你使用的不是Dialog你也可以创建一个类继承Dialog, 然后在其生命周期函数中处理自己特殊对话框的展示和隐藏