You need to enable JavaScript to run this app.
导航

异常处理(Java SDK)

最近更新时间2024.02.04 18:30:53

首次发布时间2021.11.27 17:58:44

本文介绍使用 TOS SDK 时的异常处理。

TOS 服务端错误

TOS 服务端遵循 HTTP 规范,对于请求失败的场景定义了详细的 HTTP 状态码和业务错误码。详细内容,请参见TOS 服务端状态码和错误码定义

SDK 自定义异常

TOS Java SDK 包含两类异常,分别是客户端异常 TosClientException 和服务端异常 TosServerException,均继承自 TosException,而 TosException 继承自 RuntimeException。

客户端异常 TosClientException

TosClientException 一般在 SDK 向 TOS 服务端发送请求前抛出,可能抛出该异常的场景如下。

  • 参数校验不通过。如 XXInput 类参数为空、桶名不规范(如桶名超过63字符)等。
  • 上传下载过程中网络异常,或程序被中断等,导致传输失败。

如遇到 TosClientException,建议先检查输入参数是否符合规范,TosClientException 会在 message 中记录异常原因,可通过 TosClientException.getMessage() 方法获取并排查。

服务端异常 TosServerException

TosServerException 是 SDK 从 TOS 服务端请求返回的结果中解析抛出,包括 HTTP 状态码,异常原因等信息。如遇到 TosServerException,可参考 TOS 服务端状态码和错误码定义进行处理。

异常处理示例

对于 SDK 抛出的 TosClientException 和 TosServerException 的处理,详情请参见客户端通用示例