🧩 Spring Bean 등록 어노테이션 정리: @Component부터 @Repository까지

1. Spring Bean

Spring Bean은 Spring의 IoC 컨테이너에 의해 생성되고 관리되는 자바 객체를 의미한다. 자바 클래스가 Spring 컨테이너의 관리 대상으로 등록되는 순간 해당 객체는 Bean이라고 불린다.

일반적인 Java 객체는 개발자가 new 연산자를 사용해 직접 객체를 생성하고 객체 간의 의존 관계도 코드에서 명시적으로 설정한다. 반면 Spring에서는 객체의 생성과 생명주기 관리가 컨테이너에 의해 이루어진다.

Spring 컨테이너는 애플리케이션 실행 시 필요한 객체를 생성하고 의존성을 주입하며 애플리케이션 종료 시 객체의 소멸까지 관리한다. 이를 통해 개발자는 객체 생성과 의존 관계 관리 대신 핵심 비즈니스 로직 구현에 집중할 수 있다.

2. Spring Bean 등록 방법

Spring에서 객체를 Bean으로 등록하는 방법은 크게 두 가지가 있다.

- 컴포넌트 스캔 (Component Scan)

Spring이 특정 패키지를 스캔하여 어노테이션이 붙은 클래스를 자동으로 Bean으로 등록하는 방식이다.

대표적으로 다음과 같은 어노테이션이 사용된다.

• @Component
• @Service
• @Repository
• @Controller
• @RestController

Spring Boot에서는 기본적으로 메인 클래스가 위치한 패키지를 기준으로 하위 패키지를 자동 스캔한다. 이는 @SpringBootApplication 내부에 @ComponentScan이 포함되어 있기 때문이다.

- Java Config 방식 (@Bean)

개발자가 직접 설정 클래스에서 Bean을 등록하는 방식이다.

@Configuration
public class AppConfig {

    @Bean
    public MemberService memberService() {
        return new MemberService();
    }
}

이 방식은 외부 라이브러리 객체를 Bean으로 등록하거나 객체 생성 과정을 직접 제어해야 할 때 주로 사용된다.

3. Spring Bean 등록 어노테이션

1) @Component

@Component
public class UserService {
}

@Component는 Spring에서 가장 기본이 되는 Bean 등록 어노테이션이다. 클래스에 이 어노테이션을 붙이면 컴포넌트 스캔 대상이 되어 Spring 컨테이너에 Bean으로 등록된다.

이후에 등장하는 어노테이션들(@Controller, @Service, @Repository 등)은 모두 내부적으로 @Component를 포함하고 있는 특수화된 어노테이션이다.

즉 이러한 어노테이션을 사용한 클래스 역시 @Component와 동일하게 Spring이 자동으로 Bean으로 등록하고 생명 주기를 관리한다.

아래는 @Service 어노테이션의 실제 코드 일부이다. 

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Component
public @interface Service {
    /**
     * Alias for {@link Component#value}.
     */
    @AliasFor(annotation = Component.class)
    String value() default "";
}

@Component 하나만 사용하지 않고 어노테이션을 구분해서 사용하는 이유는 애플리케이션의 계층 구조를 명확하게 구분하고 각 클래스의 역할을 분명하게 표현하기 위해서이다.

계층에 따라 어노테이션을 다르게 적용하면 코드의 가독성이 좋아지고 역할에 따른 관심사 분리가 가능해진다. 이러한 구조는 AOP를 적용하거나 테스트 코드를 작성 할 때도 유리하게 작용된다.

2) @Controller & @RestController

@Controller는 전통적인 Spring MVC 패턴에서 웹 요청을 처리하고 View를 반환하는 데 사용되는 어노테이션이다. 

이 어노테이션이 붙은 클래스는 클라이언트의 요청을 받아 비즈니스 로직을 호출하고 그 결과를 Model에 담아 View로 전달하는 역할을 한다. 

@Controller
public class MainController {
  
    @GetMapping("/")
    public String home(Model model) {
        model.addAttribute("msg", "Hello World");
        return "home"; // home.html 혹은 home.jsp View 렌더링
    }
}

반면 @RestController는 @Controller와 유사하지만 내부적으로 @ResponseBody가 함께 적용된 어노테이션이다.

따라서 메서드의 반환 값이 View 이름이 아니라 JSON이나 XML과 같은 데이터 형태로 HTTP 응답 본문에 직접 전달된다.

@RestController
public class ApiController {
  
    @GetMapping("/api/hello")
    public String hello() {
        return "Hello I'm BlueCool"; // 문자열이 그대로 HTTP 응답 본문으로 전송
    }
}

정리하면 @Controller는 템플릿 기반의 웹 애플리케이션에서 View를 반환할 때 주로 사용되며 @RestController는 RESTful API 서버에서 클라이언트와 데이터를 주고받을 때 사용된다.

3) @Service

@Service는 비즈니스 로직을 담당하는 클래스에 사용되는 어노테이션이다.

예를 들어 컨트롤러에서 요청을 받아 처리해야 하는 로직(회원 가입, 알림 발송 등)이 있다면 실제 비즈니스 로직은 @Service가 붙은 클래스에서 구현된다.

@Service
public class MemberService {
  
    public void registerMember(Member member) {
        // 회원가입 처리 로직
    }
}

@Service 자체가 특별한 기능을 제공하는 것은 아니지만 해당 클래스가 비즈니스 계층에 속한다는 것을 명확하게 표현하는 역할을 한다. 이를 통해 코드의 구조를 이해하기 쉬워지고 유지보수에도 도움이 된다.

또한 AOP를 적용할 때 @Service가 붙은 클래스만을 대상으로 지정할 수 있기 때문에 로깅이나 트랜잭션 관리와 같은 공통 기능을 적용할 때도 유용하게 활용된다.

4) @Repository

@Repository는 데이터베이스 접근을 담당하는 DAO 계층에 사용하는 어노테이션이다.

이 어노테이션의 중요한 특징 중 하나는 Spring의 예외 변환 기능을 지원한다는 점이다. 예를 들어 JDBC, JPA, Hibernate 등에서 발생하는 데이터 접근 예외는 기술마다 서로 다른 예외 타입을 사용한다.

Spring은 이러한 예외를 DataAccessException 계열의 공통 예외로 변환하여 던지는 기능을 제공한다. 이를 통해 특정 데이터 접근 기술이나 DB 벤더에 종속되지 않는 일관된 예외 처리가 가능해진다.

이 예외 변환 기능은 PersistenceExceptionTranslationPostProcessor에 의해 AOP 프록시 형태로 적용되며 @Repository가 붙은 클래스에 자동으로 적용된다.

@Repository
public class MemberRepository {

    @PersistenceContext
    private EntityManager em;
    
    public Member findById(Long id) {
        return em.find(Member.class, id);
    }
}

참고로 JdbcTemplate은 내부적으로 SQLException을 DataAccessException으로 변환하는 로직을 이미 포함하고 있기 때문에 @Repository가 없어도 동일한 예외 변환이 발생한다.

따라서 @Repository의 예외 변환 기능은 JPA, Hibernate 또는 순수 JDBC API를 직접 사용할 때 더 의미 있게 작용한다.