[스프링 입문] 4. JUnit5 테스트 코드 작성

1. JUnit 테스트의 필요성

전통적인 테스트 방식인 main 메서드 실행이나 웹 컨트롤러를 통한 확인은 다음과 같은 단점이 있습니다.

• 준비 및 실행 시간: 서버를 띄우고 화면을 조작하는 등 준비 과정이 오래 걸립니다.
• 반복의 어려움: 한 번 실행한 후 다시 테스트하기 위해 데이터를 수동으로 지우는 등 번거로움이 있습니다.
• 일괄 실행 불가: 수십 가지 기능을 한 번에 검증하기 어렵습니다.

JUnit 프레임워크는 이러한 문제를 해결하여 빠르고 반복 가능한 테스트 환경을 제공합니다.

---

2. 회원 리포지토리 테스트 (MemoryMemberRepositoryTest)

src/test/java 하위에 생성하며, 각 기능을 독립적으로 검증합니다.

테스트 코드 구성

package com.example.spring_study.domain.repository;

import com.example.spring_study.domain.Member;
import static org.assertj.core.api.Assertions.*;

import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.Test;

import java.util.List;

public class MemoryMemberRepositoryTest {

    MemoryMemberRepository memoryMemberRepository = new MemoryMemberRepository();

    // 각 메서드가 끝나면 콜백되는 메서드
    @AfterEach
    public void afterEach() {
        // 테스트 시에는 각 테스트 간의 테스트 순서가 보장이 안되니 때문에, 다른 테스트에 영향이 가지 않게 데이터 초기화 필요
        memoryMemberRepository.clearStore(); // 각 테스트 후에 저장소 초기화
    }

    @Test
    public void testSave() {
        Member member = new Member();
        member.setName("spring");

        memoryMemberRepository.save(member);

        Member result = memoryMemberRepository.findById(member.getId()).get();
        // Assertions.assertEquals(member, result);
        assertThat(member).isEqualTo(result);
    }

    @Test
    public void testFindByName() {
        Member member1 = new Member();
        member1.setName("spring1");
        memoryMemberRepository.save(member1);

        Member member2 = new Member();
        member2.setName("spring2");
        memoryMemberRepository.save(member2);

        Member result = memoryMemberRepository.findByName("spring1").get();

        assertThat(result).isEqualTo(member1);
    }

    @Test
    public void testFindAll() {
        Member member1 = new Member();
        member1.setName("spring1");
        memoryMemberRepository.save(member1);

        Member member2 = new Member();
        member2.setName("spring2");
        memoryMemberRepository.save(member2);

        List<Member> result = memoryMemberRepository.findAll();

        assertThat(result.size()).isEqualTo(2);
    }
}

핵심 어노테이션: @AfterEach

• 역할: 각 테스트 메서드(@Test)가 끝날 때마다 실행되는 콜백 메서드입니다.
• 필요성: 테스트는 순서와 상관없이 독립적으로 실행되어야 합니다. 만약 데이터를 지우지 않으면 이전 테스트의 결과가 메모리에 남아 다음 테스트가 실패할 수 있습니다.

---

3. 회원 서비스 개발 및 DI(의존관계 주입) 적용

서비스 계층은 실제 비즈니스 로직(예: 중복 회원 검증)을 담당합니다.

MemberService 코드

package com.example.spring_study.domain.service;

import com.example.spring_study.domain.Member;
import com.example.spring_study.domain.repository.MemberRepository;
import com.example.spring_study.domain.repository.MemoryMemberRepository;

import java.util.List;
import java.util.Optional;

public class MemberService {

    private final MemberRepository memberRepository = new MemoryMemberRepository();

    /**
     * 회원가입
     */
    public Long join(Member member) {
        // 같은 이름이 있는 중복 회원 X
        validateDuplicateMember(member);

        memberRepository.save(member); // 중복 회원 검증
        return member.getId();
    }

    private void validateDuplicateMember(Member member) {
        memberRepository.findByName(member.getName())
                .ifPresent(m ->{
                    throw new IllegalStateException("이미 존재하는 회원입니다");
                });
    }

    /**
     * 전체 회원 조회
     */
    public List<Member> findAll() {
        return memberRepository.findAll();
    }

    public Optional<Member> findOne(Long memberId) {
        return memberRepository.findById(memberId);
    }
}

---

4. 회원 서비스 테스트 (MemberServiceTest)

서비스 테스트에서는 **의존관계 주입(DI)**을 통해 테스트의 일관성을 유지합니다.

테스트 코드 구성

package hello.hellospring.service;
import hello.hellospring.domain.Member;
import hello.hellospring.repository.MemoryMemberRepository;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import static org.assertj.core.api.Assertions.*;
import static org.junit.jupiter.api.Assertions.*;

class MemberServiceTest {
    MemberService memberService;
    MemoryMemberRepository memberRepository;

    @BeforeEach
    public void beforeEach() {
        // 테스트마다 새로운 리포지토리를 생성하고 서비스에 주입하여 독립성 보장
        memberRepository = new MemoryMemberRepository();
        memberService = new MemberService(memberRepository);
    }

    @AfterEach
    public void afterEach() {
        memberRepository.clearStore();
    }

    @Test
    public void 회원가입() throws Exception {
        //Given
        Member member = new Member();
        member.setName("hello");

        //When
        Long saveId = memberService.join(member);

        //Then: 가입한 회원의 이름이 정상적으로 조회되는지 확인
        Member findMember = memberRepository.findById(saveId).get();
        assertEquals(member.getName(), findMember.getName());
    }

    @Test
    public void 중복_회원_예외() throws Exception {
        //Given: 동일한 이름의 회원 두 명 준비
        Member member1 = new Member();
        member1.setName("spring");
        Member member2 = new Member();
        member2.setName("spring");

        //When
        memberService.join(member1);
        
        //Then: 두 번째 가입 시 IllegalStateException 예외가 발생해야 함
        IllegalStateException e = assertThrows(IllegalStateException.class,
                () -> memberService.join(member2));
        
        assertThat(e.getMessage()).isEqualTo("이미 존재하는 회원입니다.");
    }
}

핵심 어노테이션: @BeforeEach

• 역할: 각 테스트 실행 전에 호출되어 테스트 환경을 초기화합니다.
• DI 적용: 테스트 코드에서 직접 리포지토리를 생성하여 서비스에 넣어줌으로써, 서비스가 사용하는 리포지토리와 테스트 코드에서 사용하는 리포지토리가 동일한 인스턴스임을 보장합니다.

---

요약: 좋은 테스트는 각각 독립적으로 실행되어야 하며 순서에 의존해서는 안 됩니다. @BeforeEach를 통해 의존관계를 새로 맺어주고, @AfterEach를 통해 공용 데이터를 삭제하는 습관이 매우 중요