[Feat] 전역적 예외 및 핸들러 추가

src/main/java/com/evenly/blok/global/exception/BlokException.java

@@ -0,0 +1,11 @@
+package com.evenly.blok.global.exception;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+@Getter
+@AllArgsConstructor
+public class BlokException extends RuntimeException { // TODO: 서비스명에 맞게 변경
+
+    private final ErrorCode errorCode;
+}

src/main/java/com/evenly/blok/global/exception/CommonErrorCode.java

@@ -0,0 +1,18 @@
+package com.evenly.blok.global.exception;
+
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
+
+@Getter
+@RequiredArgsConstructor
+public enum CommonErrorCode implements ErrorCode {
+
+    INTERNAL_SERVER_ERROR(HttpStatus.INTERNAL_SERVER_ERROR, "서버 관리자에게 문의하세요."),
+    INVALID_REQUEST_VALUE(HttpStatus.BAD_REQUEST, "유효하지 않은 요청값입니다."),
+    INVALID_REQUEST_URL(HttpStatus.BAD_REQUEST, "유효하지 않은 경로입니다."),
+    ;
+
+    private final HttpStatus status;
+    private final String message;
+}

src/main/java/com/evenly/blok/global/exception/ErrorCode.java

@@ -0,0 +1,10 @@
+package com.evenly.blok.global.exception;
+
+import org.springframework.http.HttpStatus;
+
+public interface ErrorCode {
+
+    HttpStatus getStatus();
+
+    String getMessage();
+}

src/main/java/com/evenly/blok/global/exception/GlobalExceptionHandler.java

@@ -0,0 +1,39 @@
+package com.evenly.blok.global.exception;
+
+import com.evenly.blok.global.exception.dto.ErrorResponse;
+import com.evenly.blok.global.exception.dto.ServerErrorResponse;
+import com.evenly.blok.global.exception.dto.ValidationErrorResponse;
+import org.springframework.web.bind.MethodArgumentNotValidException;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+import org.springframework.web.servlet.resource.NoResourceFoundException;
+
+@RestControllerAdvice
+public class GlobalExceptionHandler {
+
+    @ExceptionHandler
+    public ErrorResponse handle(BlokException ex) {
+        ErrorCode errorCode = ex.getErrorCode();
+        return ErrorResponse.of(errorCode);
+    }
+
+    @ExceptionHandler
+    public ErrorResponse handle(NoResourceFoundException ex) {
+        ErrorCode errorCode = CommonErrorCode.INVALID_REQUEST_URL;
+        return ErrorResponse.of(errorCode);
+    }
+
+    @ExceptionHandler
+    public ErrorResponse handle(MethodArgumentNotValidException ex) {
+        ErrorCode errorCode = CommonErrorCode.INVALID_REQUEST_VALUE;
+        return ValidationErrorResponse.of(errorCode, ex);
+    }
+
+    @ExceptionHandler
+    public ErrorResponse handle(Exception ex) {
+        // TODO: 로그 추가
+        ex.printStackTrace();
+        ErrorCode errorCode = CommonErrorCode.INTERNAL_SERVER_ERROR;
+        return ServerErrorResponse.of(errorCode, ex);
+    }
+}

src/main/java/com/evenly/blok/global/exception/dto/ErrorResponse.java

@@ -0,0 +1,24 @@
+package com.evenly.blok.global.exception.dto;
+
+import com.evenly.blok.global.exception.ErrorCode;
+import java.time.LocalDateTime;
+import lombok.Getter;
+import org.springframework.http.HttpStatus;
+
+@Getter
+public class ErrorResponse {
+
+    private final HttpStatus status;
+    private final String message;
+    private final LocalDateTime timestamp;
+
+    protected ErrorResponse(ErrorCode errorCode) {
+        this.status = errorCode.getStatus();
+        this.message = errorCode.getMessage();
+        this.timestamp = LocalDateTime.now();
+    }
+
+    public static ErrorResponse of(ErrorCode errorCode) {
+        return new ErrorResponse(errorCode);
+    }
+}

src/main/java/com/evenly/blok/global/exception/dto/ServerErrorResponse.java

@@ -0,0 +1,29 @@
+package com.evenly.blok.global.exception.dto;
+
+import com.evenly.blok.global.exception.ErrorCode;
+import lombok.Getter;
+
+@Getter
+public class ServerErrorResponse extends ErrorResponse {
+
+    private final ErrorDetail error;
+
+    private ServerErrorResponse(ErrorCode errorCode, ErrorDetail error) {
+        super(errorCode);
+        this.error = error;
+    }
+
+    public static ServerErrorResponse of(ErrorCode errorCode, Exception ex) {
+        ErrorDetail errorDetail = new ErrorDetail(ex);
+        return new ServerErrorResponse(errorCode, errorDetail);
+    }
+
+    private record ErrorDetail(String exception,
+                               String message,
+                               String stackTrace) {
+
+        private ErrorDetail(Exception ex) {
+            this(ex.getClass().getSimpleName(), ex.getMessage(), ex.getStackTrace()[0].getClassName());
+        }
+    }
+}

src/main/java/com/evenly/blok/global/exception/dto/ValidationErrorResponse.java

@@ -0,0 +1,35 @@
+package com.evenly.blok.global.exception.dto;
+
+import com.evenly.blok.global.exception.ErrorCode;
+import java.util.List;
+import lombok.Getter;
+import org.springframework.validation.FieldError;
+import org.springframework.web.bind.MethodArgumentNotValidException;
+
+@Getter
+public class ValidationErrorResponse extends ErrorResponse {
+
+    private final List<FieldErrorDetail> errors;
+
+    private ValidationErrorResponse(ErrorCode errorCode, List<FieldErrorDetail> errors) {
+        super(errorCode);
+        this.errors = errors;
+    }
+
+    public static ValidationErrorResponse of(ErrorCode errorCode, MethodArgumentNotValidException ex) {
+        List<FieldError> fieldErrors = ex.getBindingResult().getFieldErrors();
+        List<FieldErrorDetail> fieldErrorDetails = fieldErrors.stream()
+                .map(FieldErrorDetail::new)
+                .toList();
+        return new ValidationErrorResponse(errorCode, fieldErrorDetails);
+    }
+
+    private record FieldErrorDetail(String field,
+                                    String message,
+                                    Object value) {
+
+        private FieldErrorDetail(FieldError fieldError) {
+            this(fieldError.getField(), fieldError.getDefaultMessage(), fieldError.getRejectedValue());
+        }
+    }
+}

src/main/java/com/evenly/blok/global/response/GlobalResponseHandler.java

@@ -0,0 +1,37 @@
+package com.evenly.blok.global.response;
+
+import com.evenly.blok.global.exception.dto.ErrorResponse;
+import org.springframework.core.MethodParameter;
+import org.springframework.http.MediaType;
+import org.springframework.http.converter.HttpMessageConverter;
+import org.springframework.http.server.ServerHttpRequest;
+import org.springframework.http.server.ServerHttpResponse;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+import org.springframework.web.servlet.mvc.method.annotation.ResponseBodyAdvice;
+
+@RestControllerAdvice
+public class GlobalResponseHandler implements ResponseBodyAdvice<Object> {
+
+    @Override
+    public boolean supports(MethodParameter returnType,
+                            Class<? extends HttpMessageConverter<?>> converterType) {
+        return true;
+    }
+
+    @Override
+    public Object beforeBodyWrite(Object body,
+                                  MethodParameter returnType,
+                                  MediaType selectedContentType,
+                                  Class<? extends HttpMessageConverter<?>> selectedConverterType,
+                                  ServerHttpRequest request,
+                                  ServerHttpResponse response) {
+
+        if (body instanceof ErrorResponse errorResponse) {
+            response.setStatusCode(errorResponse.getStatus());
+        }
+        if (body instanceof SuccessResponse successResponse) {
+            response.setStatusCode(successResponse.getStatus());
+        }
+        return body;
+    }
+}

src/main/java/com/evenly/blok/global/response/SuccessResponse.java

@@ -0,0 +1,28 @@
+package com.evenly.blok.global.response;
+
+import java.time.LocalDateTime;
+import lombok.AccessLevel;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
+
+@Getter
+@RequiredArgsConstructor(access = AccessLevel.PRIVATE)
+public class SuccessResponse {
+
+    private static final HttpStatus DEFAULT_HTTP_STATUS = HttpStatus.OK;
+    private static final String DEFAULT_MESSAGE = "요청이 성공적으로 처리되었습니다.";
+
+    private final HttpStatus status;
+    private final String message;
+    private final LocalDateTime timestamp;
+    private final Object data;
+
+    public static SuccessResponse of(Object data) {
+        return new SuccessResponse(DEFAULT_HTTP_STATUS, DEFAULT_MESSAGE, LocalDateTime.now(), data);
+    }
+
+    public static SuccessResponse of(HttpStatus status, Object data) {
+        return new SuccessResponse(status, DEFAULT_MESSAGE, LocalDateTime.now(), data);
+    }
+}