Yumin/Net @ e227034cd4044c0497f791c88c70186c9f2523f6

Net具备完善的全局错误处理机制

默认情况下不需要去定义错误处理, 因为NetConfig默认实现适用于大部分情况的错误处理.

但是如果你想要自定义或者监听错误, 你可以覆盖默认的错误处理. 在initNet回调函数里面自定义全局错误处理

示例

initNet("http://localhost:80/") {

    onError {
        // this 即异常对象
    }

    onStateError {
        // this 即异常对象
    }
}

缺省页不需要所有的错误信息都吐司(toast)提示, 因为错误页可能已经展示错误信息, 所以这里两者处理的函数区分.

但是所有的错误信息和错误码都会在LogCat控制台看到, 具体查看异常追踪.

本章末尾有默认实现的源码, 可供参考或者理解: 默认处理

手动错误处理

假设不需要全局错误处理, 我们可以catch作用域来自己处理异常

scopeNetLife {
    val data = Get<String>("http://www.thisiserror.com/").await()
}.catch {
    // 这里进行错误处理, it即为错误的异常对象
}

catch里面的it属于异常对象, 这里列举可能存在的异常

scope/scopeLife不会触发任何全局错误onError/onStateError, 请使用单例错误处理方式catch, 因为scope用于处理异步任务,不应当用于网络请求

假设你重写DefaultConvert可以改变异常发生的条件, 当然你在转换器或者拦截器中抛出任何异常都会被捕获或者全局处理, 这里你可以自定义你的异常

覆盖默认错误处理

覆盖默认错误处理有两种方式

1) 参考源码完全自定义

源码位于: NetConfig

2) 仅覆盖错误信息

默认错误处理的文本被定义在strings.xml中, 我们可以在项目中使用同名覆盖或者多语言

<!--网络请求异常-->
<string name="net_network_error">当前网络不可用</string>
<string name="net_url_error">请求资源地址错误</string>
<string name="net_host_error">无法找到指定服务器主机</string>
<string name="net_connect_timeout_error">连接服务器超时，请重试</string>
<string name="net_connect_exception">请检查网络连接</string>
<string name="net_read_exception">读取数据错误</string>
<string name="net_write_exception">发送数据错误</string>
<string name="net_read_timeout_error">读取服务器数据超时，请检查网络</string>
<string name="net_download_error">下载过程发生错误</string>
<string name="net_no_cache_error">读取缓存错误</string>
<string name="net_parse_error">解析数据时发生异常</string>
<string name="net_request_error">请求参数错误</string>
<string name="net_server_error">服务响应错误</string>
<string name="net_image_error">图片下载错误</string>
<string name="net_null_error">数据为空</string>
<string name="net_error">未知网络错误</string>
<string name="net_other_error">未知错误</string>

global-error-handle.md 4.1 KB Histórico Raw

手动错误处理

覆盖默认错误处理

1) 参考源码完全自定义

2) 仅覆盖错误信息

global-error-handle.md 4.1 KB

Histórico Raw