[Spring] JUnit과 AssertJ로 테스트 코드 작성하기

✅ 들어가기 전에

• 개발 과정에서 문제를 미리 예측 및 발견할 수 있다.

• 애플리케이션을 직접 가동해서 테스트하는 것보다 테스트를 빠르게 진행할 수 있다.

• 단위 테스트를 통해 각각의 기능 별 테스트가 가능하다.

• 코드가 작성된 목적을 명확하게 표현할 수 있으며, 불필요한 내용이 추가되는 것을 방지한다.

• 버그를 미리 발견하여 리팩토링의 리스크가 줄어든다.

• JUnit
• 자바 프로그래밍 언어용 단위 테스트 프레임워크

• Spring Test & Spring Boot Test
• 스프링 부트 애플리케이션을 위한 통합 테스트 지원

• AssertJ
• 검증문인 어설션을 작성하는 데 사용

• Hamcrest
• 표현식을 보다 이해하기 쉽게 만드는 데 사용되는 Matcher 라이브러리

• Mockito
• 테스트에 사용할 가짜 객체인 mock 객체를 쉽게 만들고, 관리하고, 검증할 수 있게 지원하는 테스트 프레임워크

• JSONassert
• JSON 용 어설션 라이브러리

• JsonPath
• JSON 데이터에서 특정 데이터를 선택하고 검색하기 위한 라이브러리

✅ JUnit이란?

JUnit의 특징

• @Test 어노테이션으로 메소드를 호출할 때마다 새로운 인스턴스를 생성한다.

• 예상 결과를 검증하는 Assertion 메소드를 제공한다.

• 사용법이 단순하다.

• 자동으로 실행하고, 자체적으로 결과를 확인해 피드백을 제공한다.

코드 예시

@Test
@DisplayName("상품 1개 등록하기 - TestRestTemplate 기반")
void createProduct() {
    // given
    Long adminId = 1L;
    String name = "보조배터리";
    Long price = 10000L;
    String category = "전자기기";
    String thumbnailUrl = "http://abc.com";

    ProductRequestMvc productRequestMvc = ProductRequestMvc.builder()
        .adminId(adminId)
        .name(name)
        .price(price)
        .category(category)
        .thumbnailUrl(thumbnailUrl)
        .build();
		
    String url = "http://localhost:" + port + "/mvc/product/create"; // API url 주소 

    // when
    ResponseEntity<ProductResponseMvc> responseEntity = testRestTemplate.postForEntity(url, productRequestMvc, ProductResponseMvc.class);

    // then
    assertThat(responseEntity.getStatusCode()).isEqualTo(HttpStatus.OK);

    ProductEntityMvc savedProduct = productServiceMvc.findById(responseEntity.getBody().getId());
    Assertions.assertEquals(savedProduct.getAdminId(), adminId);
    Assertions.assertEquals(savedProduct.getName(), name);
    Assertions.assertEquals(savedProduct.getPrice(), price);
    Assertions.assertEquals(savedProduct.getCategory(), category);
    Assertions.assertEquals(savedProduct.getThumbnailUrl(), thumbnailUrl);
}

Given-When-Then Pattern

• given: 테스트 하기 위해 기본적으로 세팅하는 절차이다.

• when: 테스트를 하기 위한 조건을 지정한다.

• then: 테스트 하기 위한 행위와 결과값이 우리가 예상하는대로 잘 수행되는지 검증한다.

• given
• 상품 객체를 하나 생성한다.

• when
• testRestTemplate을 통해 상품 등록 API를 실행한다.

• then
• 상품이 잘 저장되었는지 서비스를 통해 가져와서 속성을 비교하며 확인한다.
• Assertions.assertEquals(savedProduct.getAdminId(), adminId);에서 savedProduct.getAdminId()는 검증하고 싶은 값을 의미하고, adminId는 실제 비교할 값을 의미한다.

✅ AssertJ로 검증문 수정하기

Assertions.assertEquals(savedProduct.getAdminId(), adminId);

assertThat(savedProduct.getAdminId()).isEqualTo(adminId);

@Test
@DisplayName("상품 1개 등록 - TestRestTemplate 기반")
void createProduct() {
    // given
    Long adminId = 1L;
    String name = "보조배터리";
    Long price = 10000L;
    String category = "전자기기";
    String thumbnailUrl = "http://abc.com";

    ProductRequestMvc productRequestMvc = ProductRequestMvc.builder()
        .adminId(adminId)
        .name(name)
        .price(price)
        .category(category)
        .thumbnailUrl(thumbnailUrl)
        .build();

    String url = "http://localhost:" + port + "/mvc/product/create";

    // when
    ResponseEntity<ProductResponseMvc> responseEntity = testRestTemplate.postForEntity(url, productRequestMvc, ProductResponseMvc.class);

    // then
    assertThat(responseEntity.getStatusCode()).isEqualTo(HttpStatus.OK);

    ProductEntityMvc savedProduct = productServiceMvc.findById(responseEntity.getBody().getId());
    assertThat(savedProduct.getAdminId()).isEqualTo(adminId);
    assertThat(savedProduct.getName()).isEqualTo(name);
    assertThat(savedProduct.getPrice()).isEqualTo(price);
    assertThat(savedProduct.getCategory()).isEqualTo(category);
    assertThat(savedProduct.getThumbnailUrl()).isEqualTo(thumbnailUrl);


}