Errors & Error Codes#

public static String getMessage(Integer code) {
    for (BaseErrorCode errorCode : values()) {
        if (errorCode.code.equals(code)) {
            return errorCode.desc;
        }
    }
    return "未知错误";
}

public static BaseException of(int code, String message)
public static BaseException of(int code, String message, Throwable cause)
public static BaseException of(int code, String message, Map<String, Object> errorData)
public static BaseException of(int code, String message, Map<String, Object> errorData, Throwable cause)
public static BaseException of(int code)

private StackTraceElement findCaller(StackTraceElement[] stackTrace) {
    for (StackTraceElement element : stackTrace) {
        if (!element.getClassName().equals(BaseException.class.getName()) &&
            !element.getClassName().equals("java.lang.Thread")) {
            return element;
        }
    }
    return stackTrace[0];
}

// Most common: wrap it in the repository
try {
    return scodaProducerMapper.insert(scodaProducer) > 0;
} catch (Exception e) {
    throw new BaseException(BaseErrorCode.DATABASE_ERROR.getCode(), e.getMessage());
}

// With the original exception
throw new BaseException(BaseErrorCode.NETWORK_ERROR.getCode(), "Failed to call downstream", e);

// With extra data
Map<String, Object> errorData = new HashMap<>();
errorData.put("uid", uid);
throw new BaseException(BaseErrorCode.NOT_FOUND.getCode(), "Production workshop does not exist", errorData);

public interface IErrorCode {
    int getCode();

    default String getMessage() {
        return BaseErrorCode.getMessage(this.getCode());
    }

    default Map<String, Object> getErrorData() {
        return null;
    }
}

@Getter
public enum OrderErrorCode implements IErrorCode {
    ORDER_NOT_EXIST(20001, "Order does not exist"),
    ORDER_ALREADY_PAID(20002, "Order already paid"),
    ORDER_AMOUNT_MISMATCH(20003, "Order amount mismatch");

    private final int code;
    private final String message;

    OrderErrorCode(int code, String message) {
        this.code = code;
        this.message = message;
    }

    @Override
    public int getCode() {
        return code;
    }

    @Override
    public String getMessage() {
        return message;
    }
}

return Result.fail(OrderErrorCode.ORDER_NOT_EXIST);

public static <T extends Comparable<T>> T inRange(T value, T min, T max, String message)

private void commandValidate(CreateProducerCommand command) throws BaseException {
    ParamChecker.notNull(command, "command");
    ParamChecker.notBlank(command.getName(), "Name must not be blank");
    ParamChecker.lengthInRange(command.getName(), 1, 64, "Name length must be between 1 and 64");
}

ParamChecker.notNull(command, BaseErrorCode.PARAM_ERROR.getCode(), "command must not be blank");

ParamChecker.notNull(command, () -> new OrderException("Order does not exist"));
ParamChecker.isTrue(amount > 0, () -> new OrderException("Amount must be positive"));

Result.success(dto).setRequestId(requestId);

private Long calculatePages(Long total, Integer pageSize) {
    if (total == null || total <= 0) {
        return 0L;
    }
    return total % pageSize == 0 ? total / pageSize : total / pageSize + 1;
}

private Long calculateStartIndex(Integer pageNo, Integer pageSize) {
    return (long) (pageNo - 1) * pageSize + 1;
}

private Long calculateEndIndex(Long startIndex, Integer pageSize, Long total) {
    Long endIndex = startIndex + pageSize - 1;
    return Math.min(endIndex, total);
}

@ExceptionHandler(Exception.class)
public Result<Object> handleException(Exception e) {
    logger.error("Unexpected Exception: {}", e.getMessage(), e);
    return Result.fail(BaseErrorCode.SYSTEM_ERROR.getCode(), "Internal server error, please try again later");
}