程序包 cn.isliu.core.exception

类 FsHelperException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
cn.isliu.core.exception.FsHelperException
所有已实现的接口:
Serializable
直接已知子类:
TokenManagementException
public class FsHelperException extends RuntimeException implements Serializable
飞书助手异常类 增强的异常类，支持错误代码、上下文信息、异常链分析和序列化
作者:
isliu
另请参阅:

  • 构造器详细资料

    • FsHelperException

      public FsHelperException(ErrorCode errorCode)
      构造函数 - 仅包含错误代码
      参数:
      errorCode - 错误代码

    • FsHelperException

      public FsHelperException(ErrorCode errorCode, String message)
      构造函数 - 包含错误代码和自定义消息
      参数:
      errorCode - 错误代码
      message - 自定义错误消息

    • FsHelperException

      public FsHelperException(ErrorCode errorCode, String message, Map<String,Object> context)
      构造函数 - 包含错误代码、消息和上下文
      参数:
      errorCode - 错误代码
      message - 错误消息
      context - 上下文信息

    • FsHelperException

      public FsHelperException(ErrorCode errorCode, String message, Throwable cause)
      构造函数 - 包含错误代码、消息和原因
      参数:
      errorCode - 错误代码
      message - 错误消息
      cause - 原因异常

    • FsHelperException

      public FsHelperException(ErrorCode errorCode, String message, Map<String,Object> context, Throwable cause)
      完整构造函数
      参数:
      errorCode - 错误代码
      message - 错误消息
      context - 上下文信息
      cause - 原因异常

    • FsHelperException

      public FsHelperException(String message)
      兼容性构造函数 - 保持向后兼容
      参数:
      message - 错误消息

    • FsHelperException

      public FsHelperException(String message, Throwable cause)
      兼容性构造函数 - 保持向后兼容
      参数:
      message - 错误消息
      cause - 原因异常

  • 方法详细资料

    • getErrorCode

      public ErrorCode getErrorCode()
      获取错误代码
      返回:
      错误代码

    • getContext

      public Map<String,Object> getContext()
      获取上下文信息
      返回:
      上下文信息的副本

    • getExceptionId

      public String getExceptionId()
      获取异常唯一标识
      返回:
      异常唯一标识

    • getTimestamp

      public LocalDateTime getTimestamp()
      获取异常发生时间
      返回:
      异常发生时间

    • getUserFriendlyMessage

      public String getUserFriendlyMessage()
      获取用户友好的错误消息
      返回:
      用户友好的错误消息

    • addContext

      public FsHelperException addContext(String key, Object value)
      添加上下文信息
      参数:
      key - 键
      value - 值
      返回:
      当前异常实例（支持链式调用）

    • addContext

      public FsHelperException addContext(Map<String,Object> contextMap)
      添加多个上下文信息
      参数:
      contextMap - 上下文信息映射
      返回:
      当前异常实例（支持链式调用）

    • getContextValue

      public Object getContextValue(String key)
      获取指定键的上下文值
      参数:
      key - 键
      返回:
      上下文值，如果不存在返回null

    • hasContextKey

      public boolean hasContextKey(String key)
      检查是否包含指定的上下文键
      参数:
      key - 键
      返回:
      如果包含返回true

    • getRootCause

      public Throwable getRootCause()
      获取根因异常
      返回:
      根因异常，如果没有返回当前异常

    • getExceptionChain

      public String getExceptionChain()
      获取异常链信息
      返回:
      异常链描述

    • isRetryable

      public boolean isRetryable()
      检查是否为可重试的异常
      返回:
      如果可重试返回true

    • isFatal

      public boolean isFatal()
      检查是否为致命异常
      返回:
      如果是致命异常返回true

    • isClientError

      public boolean isClientError()
      检查是否为客户端异常
      返回:
      如果是客户端异常返回true

    • isServerError

      public boolean isServerError()
      检查是否为服务器异常
      返回:
      如果是服务器异常返回true

    • getDetailedInfo

      public String getDetailedInfo()
      获取异常的详细信息（用于日志记录）
      返回:
      详细信息字符串

    • builder

      public static FsHelperException.Builder builder(ErrorCode errorCode)
      创建构建器
      参数:
      errorCode - 错误代码
      返回:
      异常构建器