本文介绍使用 TOS SDK 时的异常处理。
TOS 服务端遵循 HTTP 规范,对于请求失败的场景定义了详细的 HTTP 状态码和业务错误码。详细内容,请参见TOS 服务端状态码和错误码定义。
TOS Java SDK 包含两类异常,分别是客户端异常 TosClientException 和服务端异常 TosServerException,均继承自 TosException,而 TosException 继承自 RuntimeException。
TosClientException 一般在 SDK 向 TOS 服务端发送请求前抛出,可能抛出该异常的场景如下。
如遇到 TosClientException,建议先检查输入参数是否符合规范,TosClientException 会在 message 中记录异常原因,可通过 TosClientException.getMessage() 方法获取并排查。
TosServerException 是 SDK 从 TOS 服务端请求返回的结果中解析抛出,包括 HTTP 状态码,异常原因等信息。如遇到 TosServerException,可参考 TOS 服务端状态码和错误码定义进行处理。
对于 SDK 抛出的 TosClientException 和 TosServerException 的处理,详情请参见客户端通用示例。