[3주차-2] JUnit 5 기초/ 테스트 코드의 구성 - 2jigoo

[2jigoo]

Chapter 5. JUnit 5 기초 / Chapter 6. 테스트 코드의 구성

스터디 일시 2023.08.29

목표

• [x] ~ p. 138 까지

[2jigoo]

Chapter 5. JUnit 5 기초

JUnit 5 모듈 구성

• JUnit Platform : 테스팅 프레임워크를 구동하기 런처와 테스트 엔진을 위한 API 제공
• Junit Jupiter
  : JUnit 5를 위한 테스트 API와 실행 엔진 제공
• JUnit Vintage
  : JUnit 3, 4로 작성된 테스트를 JUnit 5 플랫폼에서 실행하기 위한 모듈을 제공

dependencies {
    testImplementation 'org.junit.jupiter:junit-jupiter'
}

// task test: JUnit 5 플랫폼을 사용하도록 설정
test {
    useJUnitPlatform()
}

• junit-jupiter 모듈은 Junit 5.4부터 제공
  그 이하의 버전에선 org.junit.jupiter:junit-jupiter-api, junit-jupiter-engine 모듈 사용

@Test 어노테이션과 테스트 메서드

• 테스트 클래스와 @Test가 붙은 메서드는 private이면 안 된다.
• Assertions.assertEquals

주요 단언 메서드

// 값 비교
assertEquals(expected, actual);
assertNotEquals(unexpected, actual);

// 레퍼런스 비교
assertSame(Object expected, Object actual);
assertNotSame(Object unexpected, Object actual);

assertTrue(boolean condition);
assertFalse(boolean condition);
assertNull(Object actual);
assertNotNull(Object actual);

// 테스트를 실패 처리
fail();

Exception 발생 유무 검사

// executable을 실행한 결과, 지정한 타입의 Exception이 발생하는지 검사
assertThrows(Class<T> expectedType, Executable excutable);

// Exception이 발생하지 않는지 검사
assertDoesNotThrow(Executable executable);

// 발생한 Exception 객체를 리턴
IllegalArgumentException thrown = assertThrows(IllegalArgumentException.class, () -> {
    AuthService authService = new AuthService();
    authService.authenticate(null, null);
});

// 발생한 Exception을 이용하여 *추가적인 검증*
assertTrue(thrown.getMessage().contains("id"));

Executable

package org.junit.jupiter.api.function;

public interface Executable {
    void execute() throws Throwable;
}

• assertThrows(), assertDoesNotThrow()에서 사용하는 함수형 인터페이스

모든 검증을 실행한 후 실패 여부 확인

assertAll(
    () -> assertEquals(3, 5/2),
    () -> assertEquals(4, 2*2),
    () -> assertEquals(6, 11/2)
);

• Executable 목록을 가변 인자로 전달받아 실행한다.
• 검증에 실패한 코드가 있으면 그 목록을 모아 에러 메시지를 보여준다.

라이프사이클

@BeforeEach, @AfterEach

1. 테스트 메서드를 포함한 객체 생성 (생성자 호출
   • 테스트 메서드를 실행할 때마다 객체를 새로 생성함
2. @BeforeEach 메서드 실행
3. @Test가 붙은 메서드 실행
4. @AfterEach 메서드 실행

@BeforeAll, @AfterAll

• 한 클래스의 모든 테스트 메서드가 실행되기 전 특정 작업을 수행해야하면
• Target: 정적 메서드
• When: 클래스의 모든 테스트 메서드를 실행하기 전에 한 번 실행

테스트 메서드 간 실행 순서 의존과 필드 공유하지 않기

• 각 테스트 메서드는 서로 독립적으로 동작해야 한다.
• 한 테스트 메서드의 결과에 따라 다른 테스트 메서드의 실행 결과가 달라지면 안 된다.
• 따라서, 테스트 메서드가 서로 필드를 공유하거나, 실행 순서를 가정하고 테스트를 작성하면 안 된다.

기타

• @DisplayName: 테스트 이름 표현
• @Disabled: 테스트 실행 대상에서 제외

모든 테스트 실행하기

• mvn test (mvnw test)
• gradle test (gradlew test)

[2jigoo]

Chapter 6. 테스트 코드의 구성

기능에서의 상황

• 기능은 주어진 상황에 따라 다르게 동작한다.

테스트 코드의 구성 요소: 상황, 실행, 결과 확인

given, when, then

• 상황
  • 각 테스트마다 상황을 설정
  • @BeforEach와 같은 공통 처리단에서 상황을 설정
  • 상황이 없는 경우도 있음
• 결과
  • 리턴 값
  • Exception

외부 상황과 외부 결과

• 테스트는 실행할 때마다 동일한 결과를 보장해야 한다.
• 상황에는 외부 요인도 있다. 외부 요인에 의해 테스트의 결과가 달라지면 안 된다.
  • 올바른 상황에서 동작한다는 것을 보장하는 코드 작성
  • 테스트 코드 내에서 상황을 구성
• 실행 결과를 외부에서 확인해야 하는 경우도 있다.

외부 상태가 테스트 결과에 영향을 주지 않게 하기

• 테스트 실행 전에 외부를 원하는 상태로 만들거나, 테스트 실행 후에 외부 상태를 원래대로 돌려놔야 한다.
  예) 생성 후 삭제, 롤백 등

외부 상태와 테스트 어려움

예) 금융 회사에서 제공하는 REST API 사용 시, 자동이체 등록 기능

• 유효한 계좌번호
• 유효하지 않은 계좌번호
• API 서버에 연결할 수 없는 상황
• 응답을 5초 이내에 받지 못하는 상황

• 테스트 대상이 아닌 외부 요인은 테스트 코드에서 다루기 힘들고, 제어할 수 없는 경우가 있다.
• 테스트 대상의 상황가 결과에 외부 요인이 있는 경우, 대역을 사용하여 테스트한다.
• 대역: 테스트 대상이 의존하는 대상의 실제 구현을 대신하는 구현