Spring / 지금까지 사용한 어노테이션 정리 @

어노테이션을 사용하는 이유

사전적 의미로 주석을 뜻하는 어노테이션을 주석과는 역할이 다르지만, 주석처럼 달아 특수한 의미부여가 가능하고, 기능 주입이 가능합니다. 어노테이션을 사용하는 가장 큰 이유는 프로그램에게 추가 정보를 제공하는 메타 데이터를 위해서 사용합니다.

 

@Controller

컨트롤러 로직임을 알려주는 어노테이션

 

@Service 

서비스 로직임을 알려주는 어노테이션

 

@Repository

리포지토리 로직임을 알려주는 어노테이션 

 

@Test

JUnit에서 사용하는 어노테이션.

테스트 코드임을 알려주는 어노테이션으로 이 어노테이션이 붙은 코드는 독립적으로 실행할 수 있습니다.

 

@Responsebody

객체를 HTTP요청의 body내용으로 mapping하여 클라이언트로 전송 

@Responsebody가 붙은 파라미터가 있으면 HTTP 요청의 미디어 타입과 파라미터의 타입을 먼저 확인한다.

즉,  @Responsebody 어노테이션을 사용하면 http 요청 body를 자바 객체나 string으로 전달 받을 수 있다.

 

@GetMapping

주어진 URI 표현식과 일치하는 HTTP GET 요청처리 해주는 어노테이션

ex) localhost:8080/hello 요청이 들어오면 @GetMapping("hello")이 붙은 함수를 실행합니다.

ex) @GetMapping("/")인 경우 홈 화면에 매핑됨.

 

@PostMapping 

: 주어진 URI 표현식과 일치하는 HTTP POST 요청처리 해주는 어노테이션

 

@RequestMapping

주어진 URI표현식과 일치하는 HTTP Request 를 요청처리 해주는 어노테이션

 

 

@Override

부모나 인터페이스 구현 클래스에서 메소드 구현할 때 사용하는 어노테이션

 

@BeforeEach

각 테스트 실행 전에 호출되도록 해주는 어노테이션.

테스트가 서로 영향이 없도록 하기 위해ㅔ 항상 새로운 객체를 생성하거나 의존관계를 새로 맺어주는 데 사용됩니다.

 

@AfterEach  

테스트 코드에서 사용하는 어노테이션.

한 번에 여러 메소드의 테스트를 실행하면 메모리 DB에 직전 테스트의 결과가 남아 이전 테스트가 다음 테스트에 영향을 끼쳐 테스트 코드가 독립적으로 실행되지 않는 문제가 발생합니다.

@AfterEach를 사용해서 각 테스트가 끝나면 메모리를 비우는 작업을 구현하면 이전 테스트가 다음 테스트에 영향을 주지 않게 할 수 있습니다.

 

@Autowired 

자동 의존관계 주입(DI) 어노테이션.

스프링 컨테이너에 등록된 빈을 찾아서 의존관계 주입(Dependency Injection, DI) 해줍니다.

생성자가 하나일 경우 생략해도 됩니다.

 

@Configuration

수동 빈 관리 클래스임을 알려주는 어노테이션.

CGLIB 라이브러리로 바이트코드 조작을 통해 빈들의 싱글톤을 보장해줍니다.

 

@Bean

수동 빈 관리 클래스에서 수동으로 빈으로 등록하기 위해 사용하는 어노테이션.

 

@ComponentScan

@Component 어노테이션이 붙은 클래스를 스캔해서 스프링 빈으로 등록합니다.

 

@Configuration
@ComponentScan(
        excludeFilters = @ComponentScan.Filter(type= FilterType.ANNOTATION, classes = Configuration.class)
)
public class AutoAppConfig {

}

파라미터 exlucdeFilters, includeFilters, basePackages 로 제외, 포함, 시작위치 지정 가능 

기본 적용 대상 : @Controller, @Service, @Repository, @Configuration

 

@Component

자동 스프링 빈 등록 어노테이션.

해당 어노테이션이 붙은 클래스는 자동으로 스프링 컨테이너에 등록됩니다. 

 

@Transaction

테스트 진행 전에 DB에 대한 트랜잭션을 시작하고, 테스트 완료 후에는 항상 롤백을 진행하여 DB에 데이터가 남지 않도록 해서 다음 테스트에 영향을 주지 않도록 합니다.

 

@SpringBootTest

통합 테스트를 위한 환경을 준비해줍니다. 모든 빈들을 스캔하고 스프링 컨테이너와 테스트를 함께 실행하도록 해줍니다.

 

@Displayname

JUnit에서 사용하는 어노테이션으로 @Test의 함수명을 변경해서 볼 수 있습니다.

@Test
@DisplayName("구체 타입으로 조회")
void findBeanByName2()
{
    MemberService memberService = ac.getBean("memberService", MemberServiceImp.class);
    Assertions.assertThat(memberService).isInstanceOf(MemberServiceImp.class);
}

 

@RequiredArgsConstructor

final이 붙은 필드를 모아 생성자를 자동으로 만들어 준다. ( 코드에는 보이지 않음 )

@Component
@RequiredArgsConstructor
public class OrderServiceImp implements OrderService {
    private final MemberRepository memberRepository;
    private final DiscountPolicy discountPolicy;

 

@Qualifier

같은 타입으로 등록된 빈이 두 개 이상일 때, 추가 구분자를 통해 의존관계를 주입해주는 어노테이션.

@Component
@Qualifier("mainDp")
public class FixDiscountPolicy implements DiscountPolicy{

@Component
@Qualifier("secondDp")
public class RateDiscountPolicy implements DiscountPolicy{

@Component
public class OrderServiceImp implements OrderService {
    private final MemberRepository memberRepository;
    private final DiscountPolicy discountPolicy;

    @Autowired
    public OrderServiceImp(MemberRepository memberRepository, @Qualifier("mainDp") DiscountPolicy discountPolicy) {
        this.memberRepository = memberRepository;
        this.discountPolicy = discountPolicy;
    }

@Qualifier 끼리 매칭 -> 만약 없다 ? -> 빈이름 매칭 -> 등록된 빈에도 없다? -> NoSuchBeanDefinitionException 예외 발생

 

 

@Primary

우선순위를 지정해주는 지정자로 우선 의존권을 갖는 빈에게 @Primary를 붙혀주기만 하면 됩니다.

 

@Component
@Primary
@Qualifier("mainDp")
public class FixDiscountPolicy implements DiscountPolicy{

 

@Primary와 @Qualifier중에서는 @Qualifier가 우선권이 높습니다.

 

 

@PostConstructor

생성자가 실행된 이후에 객체를 초기화하는 작업을 할 때 사용하는 어노테이션.

 

@PreDestroy

소멸자가 실행되기 이전에 실행하는 메소드임을 알려주는 어노테이션. 

 

@Scope

빈 생명주기를 설정하는 어노테이션으로 빈 스코프로는 singleton과 prototype이 있다.

singleton의 경우 애플리케이션 종료직전까지 유지되지만,

prototype의 경우 빈의 생성-> 의존관계 주입 까지만 유지된다. (클라이언트에 리턴되고 소멸됨)

웹 스코프로는 request, session 등이 있음.