📚 목차

🧩 @ExceptionHandler

@Controller, @RestController가 적용된 Bean에서 발생된 예외를 잡아서 하나의 메서드에서 처리해주는 기능입니다.

(@Service나 @Repository 등 다른 Bean에서는 사용할 수 없습니다.)

@Target({ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface ExceptionHandler {
    Class<? extends Throwable>[] value() default {};
}

value 설정을 통해서 어떤 예외를 처리할지 설정할 수 있습니다. (주의사항은 value를 지정하지 않으면 모든 예외를 처리하기 때문에 설정을 해주어야 합니다!)

@ExceptionHandler({Exception.class, RuntimeException.class})

와 같이 2개 이상도 등록 가능합니다.

하지만 이를 @Controller단에 정의하게 된다면, 다른 Controller의 예외는 처리할 수 없으므로 각각의 Controller에 정의해줘야 합니다.

그렇게 되면 같은 예외처리임에도 불구하고 각각의 Controller의 정의해줘야 하는 코드의 중복이 발생하게 됩니다.

이를 한번에 처리할 수 있게 해주는 것이 @ControllerAdvice 입니다.

🔖 @ControllerAdvice

@Controller 애노테이션이 있는 모든 곳에서의 예외를 잡을 수 있도록 해줍니다.

@ControllerAdvice 안에 있는 @ExceptionHandler는 모든 컨트롤러에서 발생하는 예외상황을 잡을 수 있습니다.

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Component
public @interface ControllerAdvice {
    @AliasFor("basePackages")
    String[] value() default {};

    @AliasFor("value")
    String[] basePackages() default {};

    Class<?>[] basePackageClasses() default {};

    Class<?>[] assignableTypes() default {};

    Class<? extends Annotation>[] annotations() default {};
}

속성 설정을 통해서 원하는 컨트롤러나 패키지만 선택 할 수 있고, 선택하지 않는다면 모든 패키지에 있는 컨트롤러를 담당하게 됩니다.

👀 @RestControllerAdvice