自定义异常抛出

以下为Net内部抛出的异常对象

异常	描述
NetException	未知的网络异常, 一般情况应当继承他来创建自定义的网络异常
HttpFailureException	Http请求错误, Http请求失败(onFailure)
HttpResponseException	Http请求成功后发生的错误, Http请求成功但发生异常(onResponse)
URLParseException	地址错误
NetUnknownHostException	域名错误
NetSocketTimeoutException	连接超时
NetConnectException	连接网络失败, 设备未开启网络
NetworkingException	当前网络不可用, Net并未实现
DownloadFileException	下载文件异常
ConvertException	解析错误, NetConvert中发生的未捕获异常都算解析错误
RequestParamsException	请求参数错误 400 - 499 范围内错误码
ServerResponseException	服务器错误 500 - 599 范围内错误码
ResponseException	错误码异常, 一般应用于后端返回的错误码和其定义的成功码不匹配
NullPointerException	空指针, 一般是在作用域内操作一个空的对象

NetworkingException

由于谷歌限制Net无法判断网络是否可用, 请开发者自己抛出

自定义异常

在转换器(NetConverter)或拦截器(Interceptor)中抛出任何异常 该异常对象都会被单例或全局错误处理接收, 可用于判断异常信息做特殊处理 (例如Token失效则跳转到登录页面)

转换发生异常

NetConverter中的所有异常除非是NetException子类否则都将被ConvertException包裹
即捕获的是ConvertException, cause才为实际抛出异常

异常传递字段

Net自带异常会有类型为Any的字段tag, 可用传递对象用于判断错误处理

例如ResponseException常用于作为请求服务器成功但后端业务错误, 然后tag为传递的错误码

示例代码

转换器抛出异常全局错误处理异常

class SerializationConverter(
    val success: String = "0",
    val code: String = "code",
    val message: String = "msg"
) : NetConverter {

    override fun <R> onConvert(succeed: Type, response: Response): R? {
        try {
            return NetConverter.onConvert<R>(succeed, response)
        } catch (e: ConvertException) {
            val code = response.code
            when {
                code in 200..299 -> { // 请求成功
                // ... 假设Token失效. 后端返回业务错误码 srvCode = 401
                    throw ResponseException(response, errorMessage, tag = srvCode) // 将业务错误码作为tag传递
                }
                code in 400..499 -> throw RequestParamsException(response, code.toString()) // 请求参数错误
                code >= 500 -> throw ServerResponseException(response, code.toString()) // 服务器异常错误
                else -> throw ConvertException(response)
            }
        }
    }
}

class NetworkingErrorHandler : NetErrorHandler {
    override fun onError(e: Throwable) {
    // .... 其他错误
        if (e is ResponseException && e.tag == 401) { // 判断异常为token失效
           // 打开登录界面或者弹登录失效对话框
        }
    }
}