3.2 에러 코드와 예외 구현

public enum ErrorCategory {
    // 입력값이나 요청이 유효하지 않은 경우
    VALIDATION,

    // 요청한 리소스를 찾을 수 없는 경우
    NOT_FOUND,

    // 비즈니스 규칙에 위배되는 경우
    BUSINESS_RULE,

    // 인증 실패 (기술적 처리)
    AUTHENTICATION,

    // 권한 부여 규칙 위반 (도메인 규칙)
    AUTHORIZATION,

    // 시스템이나 외부 서비스 관련 오류
    SYSTEM
}

public interface ErrorCode {
    /**
     * 오류를 식별하는 고유한 코드를 반환합니다.
     * 예: "BOOK_NOT_FOUND", "INVALID_ISBN"
     */
    String code();

    /**
     * 오류를 설명하는 메시지를 반환합니다.
     * MessageFormat 패턴을 포함할 수 있습니다.
     * 예: "도서 {0}을(를) 찾을 수 없습니다."
     */
    String message();

    /**
     * 오류의 카테고리를 반환합니다.
     * 이는 오류의 성격과 처리 방식을 결정합니다.
     */
    ErrorCategory category();
}

/**
 * ErrorCode의 기본 구현체입니다.
 * record로 구현되어 불변성을 보장하고 값 기반 동등성을 제공합니다.
 */
public record DefaultErrorCode(
    String code,
    String message,
    ErrorType type
) implements ErrorCode {

    /**
     * 컴팩트 생성자를 통해 유효성을 검증합니다.
     * 모든 필수 필드가 null이 아님을 보장합니다.
     */
    public DefaultErrorCode {
        Objects.requireNonNull(code, "Error code cannot be null");
        Objects.requireNonNull(message, "Error message cannot be null");
        Objects.requireNonNull(type, "Error type cannot be null");

        // 코드 형식 검증
        if (!code.matches("^[A-Z][A-Z0-9_]*$")) {
            throw new IllegalArgumentException(
                    "Error code must be uppercase letters, numbers and underscores, starting with a letter"
            );
        }
    }

    /**
     * SYSTEM 타입을 기본값으로 사용하는 편의 생성자입니다.
     */
    public DefaultErrorCode(String code, String message) {
        this(code, message, ErrorType.SYSTEM);
    }
}

@Slf4j
public class ErrorMessageFormatter {
    private static final Map<String, MessageFormat> formatCache = new ConcurrentHashMap<>();

    public static String format(String message, Object... args) {
        if (message == null) return "";
        if (args == null || args.length == 0) return message;

        MessageFormat format = getOrCreateFormat(message);
        return formatMessage(format, args);
    }
}

/**
 * 에러의 세부 정보를 캡슐화하는 불변 클래스입니다.
 * 에러 코드와 해당 에러 메시지를 포매팅하는데 필요한 인자들을 포함합니다.
 */
public record ErrorDetails(
                ErrorCode errorCode,
                Object... args
        ) {
    public ErrorDetails {
        if (errorCode == null) {
            throw new IllegalArgumentException("errorCode can't be null.");
        }
    }

    /**
     * 포매팅된 에러 메시지를 반환합니다.
     */
    public String getFormattedMessage() {
        return ErrorMessageFormatter.format(errorCode.message(), args);
    }
}

public class ErrorCodes {
    /**
     * 시스템 관련 에러 코드
     */
    public static final ErrorCode NOT_IMPLEMENTED = 
        new DefaultErrorCode("NOT_IMPLEMENTED", "Not implemented yet", ErrorType.SYSTEM);
    
    public static final ErrorCode INTERNAL_SERVER_ERROR = 
        new DefaultErrorCode("INTERNAL_SERVER_ERROR", "Internal server error", ErrorType.SYSTEM);

    /**
     * 검증 관련 에러 코드
     * {0}, {1} 등의 플레이스홀더를 사용하여 동적 메시지 생성이 가능합니다.
     */
    public static final ErrorCode VALUE_NULL = 
        new DefaultErrorCode("VALUE_NULL", "{0} must not be null", ErrorType.VALIDATION);
    
    public static final ErrorCode VALUE_BLANK = 
        new DefaultErrorCode("VALUE_BLANK", "{0} must not be blank", ErrorType.VALIDATION);
}

@Getter
/**
 * 애플리케이션의 모든 예외들의 기본이 되는 추상 클래스입니다.
 * 이 클래스는 예외 처리에 필요한 공통 기능을 제공합니다.
 */
@Getter
public abstract class BaseException extends RuntimeException {
    private final ErrorCode errorCode;
    private final Object[] args;

    protected BaseException(ErrorCode errorCode, Object... args) {
        super(ErrorMessageFormatter.format(errorCode.message(), args));
        this.errorCode = errorCode;
        this.args = args;
    }

    protected BaseException(Throwable cause, ErrorCode errorCode, Object... args) {
        super(ErrorMessageFormatter.format(errorCode.message(), args), cause);
        this.errorCode = errorCode;
        this.args = args;
    }

    /**
     * 현재 예외의 상세 정보를 반환합니다.
     * 이 메서드는 예외 처리 시 로깅이나 클라이언트 응답 생성에 활용됩니다.
     */
    public ErrorDetails getErrorDetails() {
        return new ErrorDetails(errorCode, args);
    }

}

public class ExceptionFactory {
    public static BaseException create(ErrorCode errorCode, Object... args) {
        return switch (errorCode.type()) {
            case VALIDATION -> new ValidationException(errorCode, args);
            case NOT_FOUND -> new ResourceNotFoundException(errorCode, args);
            case BUSINESS_RULE -> new BusinessRuleViolationException(errorCode, args);
            case AUTHENTICATION -> new AuthenticationException(errorCode, args);
            case AUTHORIZATION -> new AuthorizationException(errorCode, args);
            case SYSTEM -> new SystemException(errorCode, args);
        };
    }
}