OpenIMApiClient

src/main/java/com/tailbet/common/exception/BusinessException.java

@@ -0,0 +1,113 @@
+package com.tailbet.common.exception;
+
+import com.tailbet.common.enums.ErrorCodeEnum;
+import lombok.Getter;
+
+/**
+ * 业务异常
+ * <p>
+ * 封装业务逻辑层面的异常，区别于系统运行时异常。
+ * 业务异常通常有明确的错误码和提示信息，可直接返回给前端展示。
+ * 使用时优先使用预定义的错误码枚举，也支持自定义消息。
+ * </p>
+ *
+ * @author socialapp团队
+ * @since 1.0.0
+ */
+@Getter
+public class BusinessException extends RuntimeException {
+
+    /**
+     * 错误码
+     */
+    private final int code;
+
+    /**
+     * 附加数据（如当前场次信息等）
+     */
+    private final Object data;
+
+    /**
+     * 基于错误码枚举构造业务异常
+     *
+     * @param errorCode 错误码枚举
+     */
+    public BusinessException(ErrorCodeEnum errorCode) {
+        super(errorCode.getMessage());
+        this.code = errorCode.getCode();
+        this.data = null;
+    }
+
+    /**
+     * 基于错误码枚举和自定义消息构造业务异常
+     *
+     * @param errorCode 错误码枚举
+     * @param message   自定义错误消息
+     */
+    public BusinessException(ErrorCodeEnum errorCode, String message) {
+        super(message);
+        this.code = errorCode.getCode();
+        this.data = null;
+    }
+
+    /**
+     * 基于错误码枚举、自定义消息和原因构造业务异常
+     *
+     * @param errorCode 错误码枚举
+     * @param message   自定义错误消息
+     * @param cause     原始异常
+     */
+    public BusinessException(ErrorCodeEnum errorCode, String message, Throwable cause) {
+        super(message, cause);
+        this.code = errorCode.getCode();
+        this.data = null;
+    }
+
+    /**
+     * 基于状态码和自定义消息构造业务异常
+     *
+     * @param code    状态码
+     * @param message 错误消息
+     */
+    public BusinessException(int code, String message) {
+        super(message);
+        this.code = code;
+        this.data = null;
+    }
+
+    /**
+     * 基于自定义消息构造业务异常（默认错误码 INTERNAL_ERROR）
+     *
+     * @param message 错误消息
+     */
+    public BusinessException(String message) {
+        super(message);
+        this.code = ErrorCodeEnum.INTERNAL_ERROR.getCode();
+        this.data = null;
+    }
+
+    /**
+     * 基于错误码枚举和附加数据构造业务异常
+     * <p>
+     * 用于需要向前端返回额外数据的异常场景，
+     * 如 LIVE_ALREADY_ACTIVE 时携带已有场次信息。
+     * </p>
+     *
+     * @param errorCode 错误码枚举
+     * @param data      附加数据
+     */
+    public BusinessException(ErrorCodeEnum errorCode, Object data) {
+        super(errorCode.getMessage());
+        this.code = errorCode.getCode();
+        this.data = data;
+    }
+
+    /**
+     * 获取对应的错误码枚举
+     *
+     * @return 错误码枚举
+     */
+    public ErrorCodeEnum getErrorCodeEnum() {
+        return ErrorCodeEnum.of(this.code);
+    }
+}