🧪

The Java Application Test - 백기선

1. JUnit

가. JUnit 5 시작

나. 기본 주석(basic annotation)

사. Custom Annotation 만들기

나. Mocking Test도 단위테스트인가?

다. Mock 객체를 생성하는 방법은?

라. Mock 객체의 행동을 정의하는 방법은?

1. JUnit

가. JUnit 5 시작

•

java 클래스에 대한 테스트 클래스 생성

→ ctrl + shift + t

•

특정 테스트 메소드 실행 단축키

→ ctrl + shift + f10(fn 포함)

•

자동 줄맞춤

→ ctrl + alt + l

나. 기본 주석(basic annotation)

•

@BeforeAll: 본 테스트 시작 전, 한 번만 실행하는 메소드

→ static void type만 가능

@BeforeAll
static void beforeAll(){
    System.out.println("before all");
}
Java
복사

•

@AfterAll: 테스트 후, 마지막에 한 번만 실행하는 메소드

→ 마찬가지로 static void type만 사용

•

@BeforeEach: 각각의 테스트 시작 전, 실행하는 메소드

→ static일 필요 없음

@BeforeEach
void beforeEach(){
    System.out.println("BeforeEach");
}
Java
복사

•

@AfterEach: 각각의 테스트 실행 후, 실행하는 메소드

•

@Disabled: 해당 테스트 실행 X, 깨진 테스트에 대해 처리, 정리되지 않은 테스트의 경우 등에 사용

@Test
@Disabled
void createSecond() {
    Study study = new Study();
    assertNotNull(study);
    System.out.println("createSecond");
}
Java
복사

다. 테스트 이름 표기

•

TestCase의 이름을 Given, When, Then의 구조로 가지면 테스트 가독성이 좋음

•

각 테스트 케이스에서 실 비교 대상에 대해 expected, actual 이름을 붙여서 가독성을 높일 것

@Test 
public void givenRadius_whenCalculateArea_thenReturnArea() {
    double actualArea = Circle.calculateArea(2d);
    double expectedArea = 3.141592653589793 * 2 * 2;
    Assert.assertEquals(expectedArea, actualArea); 
}
Java
복사
code from https://www.baeldung.com/java-unit-testing-best-practices

•

@DisplayNameGeneration(DisplayNameGenerator.ReplaceUnderscores.class)

→ 해당 주석이 붙은 클래스 내 모든 메소드에 대해 실행창 메소드 표기 방식에 변화

→ underscore → blank

@DisplayNameGeneration(DisplayNameGenerator.ReplaceUnderscores.class)
class StudyTest {}
Java
복사

•

@DisplayName(""); : 큰 따옴표 안의 이름으로 메소드 이름 표기

@Test
@DisplayName("Origin")
void create() {
    Study study = new Study();
    assertNotNull(study);
    System.out.println("create");
}
Java
복사

라. Assertion

•

assertEqulas(expected, actual, option: message): 기대되는 값과 실제 값을 비교함. 에러 발생 시 message의 내용이 출력됨

→ message의 내용이 길다면 람다를 사용하여 에러 발생할 경우에만 message를 계산하여 출력하도록 함

void create() {
    Study study = new Study();
    assertEquals(StudyStatus.DRAFT, study.getStatus(), "스터디 생성 시 status는 DRAFT가 되어야 함");
}
Java
복사

// 람다 사용
void create() {
    Study study = new Study();
    assertEquals(StudyStatus.DRAFT, study.getStatus(), () -> "스터디 생성 시 status는 DRAFT가 되어야 함");
}
Java
복사

•

assertTrue(boolean condition, message): condition의 결과가 false일 경우, message가 출력됨

void create() {
  Study study = new Study(10);
	assertTrue(study.getLimit() > 0, "스터디 최대 인원은 1명 이상이어야 함");
}
Java
복사

•

assertAll(executables...): 람다식으로 여러개의 assert문을 추가하여 각각의 assert문의 이상유무를 확인할 수 있음

→ assertAll을 사용하지 않고 순차적으로 assert문을 사용할 경우, 만약 맨 위의 assert문에 에러가 발생하면 이하 모든 assert문의 이상유무 메세지를 확인할 수 없음

void create() {
  Study study = new Study(10);

  assertAll(
    () -> assertNotNull(study),
    () -> assertTrue(study.getLimit() > 0, "스터디 최대 인원은 1명 이상이어야 함"),
    () -> assertEquals(StudyStatus.DRAFT, study.getStatus(), () -> "스터디 생성 시 status는 DRAFT가 되어야 함")
  );
}
Java
복사

•

assertThrows(executable, expectedType): 예외 발생 확인

•

assertTimeout(duration, executable): 특정 시간 안에 실행이 완료되는지 확인

•

assertNotNull(actual): 값이 null이 아닌지 확인

마. 조건에 따라 테스트 실행하기

•

환경변수의 조건에 따라 특정 테스트 실행

→ OnOS, OnJre, IfSystemProperty, IfEnvironmentVariable 등

@Test
@EnabledOnOs({OS.MAC, OS.LINUX})
void create() {
    Study study = new Study(10);

    System.out.println("create");
    assertNotNull(study);
    assertTrue(study.getLimit() > 0, "스터디 최대 인원은 1명 이상이어야 함");
    assertEquals(StudyStatus.DRAFT, study.getStatus(), () -> "스터디 생성 시 status는 DRAFT가 되어야 함");
}
Java
복사

•

assumeTrue(조건), assumingThat(조건, 테스트)

바. 태깅과 필터링

•

Tag: 여러 테스트 케이스 그룹화

→ @Tag로 지정한 테스트케이스에 대해 하나의 그룹으로 묶임

•

Filter: 특정 Tag의 테스트 케이스만 실행

→ Edit Configuration에서 특정 태그에 따라 테스트케이스 실행할 수 있도록 설정

@Test
@DisplayName("스터디 만들기")
@EnabledOnOs({OS.MAC, OS.LINUX, OS.WINDOWS})
@Tag("fast")
void create() {
    Study study = new Study(10);

    System.out.println("create");
    assertNotNull(study);
    assertTrue(study.getLimit() > 0, "스터디 최대 인원은 1명 이상이어야 함");
    assertEquals(StudyStatus.DRAFT, study.getStatus(), () -> "스터디 생성 시 status는 DRAFT가 되어야 함");
}
Java
복사

사. Custom Annotation 만들기

•

여러 주석(Annotation)을 포함한 하나의 주석으로 만들 수 있음

// FastTest.java
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Test
@Tag("fast")
@EnabledOnOs({OS.WINDOWS})
public @interface FastTest {
}

// StudyTest.java
@FastTest
@DisplayName("스터디 만들기 빠른버전")
void create() {
    Study study = new Study(10);

    System.out.println("create");
    assertNotNull(study);
    assertTrue(study.getLimit() > 0, "스터디 최대 인원은 1명 이상이어야 함");
    assertEquals(StudyStatus.DRAFT, study.getStatus(), () -> "스터디 생성 시 status는 DRAFT가 되어야 함");
}
Java
복사

아. 테스트 반복하기

•

RepeatedTest(int value, string name): value값만큼 특정 테스트를 반복실행

@RepeatedTest(value = 10, name = "repetition {currentRepetition} of {totalRepetitions}")
void repeatTest(RepetitionInfo repetitionInfo){
    System.out.println("test " + repetitionInfo.getCurrentRepetition() + "/" + repetitionInfo.getTotalRepetitions());
}
Java
복사

•

ParameterizedTest(String name): 전달한 매개변수를 토대로 테스트 반복 실행

→ 매개변수의 소스로 다양한 annotation 사용 가능

→ @NullSource, @EmptySource, @NullAndEmptySource 등

@ValueSource(strings = {"날씨가", "많이", "추워졌다"})
@ParameterizedTest(name = "{index} message={0}")
void parameterizedTest(String message){
    System.out.println(message);
}
Java
복사

•

custom Object type에 대해 하나의 매개변수로 전달할 때, ArgumentConvert 해야 함

→ 다음의 순서로 converting 됨

int(10) → Study(10)

Study(10) → String(10)

String(10)→ Integer(10)

@ValueSource(ints = {10, 20, 30})
@ParameterizedTest(name = "{index} message={0}")
void parameterizedTest(@ConvertWith(StudyConverter.class) Study study){
    System.out.println(study.getLimit());
}

static class StudyConverter extends SimpleArgumentConverter {
    @Override
    protected Object convert(Object source, Class<?> targetType) throws ArgumentConversionException {
        assertEquals(Study.class, targetType, "can only convert to Study");
        return new Study(Integer.parseInt(source.toString()));
    }
}
Java
복사

•

두 개 이상의 매개변수를 전달할 때, ArgumentsAccessor를 사용함

→ 매개변수의 sorce는 @CsvSource 사용

→ 하나의 문자열 내 공백을 추가할 때, 작은 따옴표로 해당 문자열을 감싼다

//StudyTest.java
@ParameterizedTest(name = "{index} message={1}")
@CsvSource({"10, '자바 스터디'", "20, '자바 스프링'"})
void parameterizedTest(ArgumentsAccessor argumentsAccessor) {
    Study study = new Study(argumentsAccessor.getInteger(0), argumentsAccessor.getString(1));
    System.out.println(study);
}

//Study.java
public Study(int limit, String name) {
    this.limit = limit;
    this.name = name;

    System.out.println(getLimit() + " " + getName() + " " + getStatus());
}
Java
복사

•

Aggregator 사용하여 두 개 이상의 매개변수 전달 가능

@ParameterizedTest(name = "{index} message={1}")
@DisplayName("스터디 만들기")
@CsvSource({"10, '자바 스터디'", "20, '자바 스프링'"})
void parameterizedTest(@AggregateWith(StudyAggregator.class) Study study) {
}

static class StudyAggregator implements ArgumentsAggregator {
    @Override
    public Object aggregateArguments(ArgumentsAccessor argumentsAccessor, ParameterContext parameterContext) throws ArgumentsAggregationException {
        return new Study(argumentsAccessor.getInteger(0), argumentsAccessor.getString(1));
    }
}
Java
복사