재학습_회원 관리 예제, 테스트 케이스 작성

# 회원 관리 예제, 테스트 케이스 작성

## 비즈니스 요구사항

• 데이터 : 회원 ID, 이름
• 기능 : 회원 등록, 조회 기능.
• 가상의 시나리오 : 아직 데이터 저장소가 선정되지 않은 상태.

일반적인 웹 애플리케이션 계층 구조

• 컨트롤러 : 웹 MVC의 컨트롤러 역할
• 서비스 : 핵심 비즈니스 로직 구현
• 리포지토리 : 데이터베이스에 접근, 도메인 객체를 DB에 저장하고 관리.
• 도메인 : 비즈니스 도메인 객체 (예)회원, 주문, 쿠폰 등 주로 데이터베이스에 저장하고 관리됨)

클래스 의존관계

• MemberService -> MemberRepository (interface : 아직 데이터 저장소 선정 전 이므로.) <- Memory MemberRepository (구현체)
• 아직 데이터 저장소 선정되지 않아서 인터페이스로 구현 클래스를 변경할 수 있도록 설계.
• 데이터 저장소는 RDB, NoSQL 등 다양한 저장소 고민중인 상황 (가정)
• 개발 진행을 위해 초기 개발 단계에서는 구현체로 가벼운 메모리 기반의 데이터 저장소 사용.

## 회원 도메인과 리포지토리 생성

• Member

package hello.hellospring.domain;

public class Member {

    private Long id;
    private String name;

    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

• MemberRepository (interface)

package hello.hellospring.repository;

import hello.hellospring.domain.Member;

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

public interface MemberRepository {
    Member save(Member member);
    Optional<Member> findById(Long id);
    Optional<Member> findByName(String name);
    List<Member> findAll();
}

• MemoryMemberRepository

package hello.hellospring.repository;

import hello.hellospring.domain.Member;

import java.util.*;

public class MemoryMemberRepository implements MemberRepository {

    private static Map<Long, Member> store = new HashMap<>();
    private static long sequence = 0L;

    @Override
    public Member save(Member member) {
        member.setId(++sequence);
        store.put(member.getId(), member );
        return member;
    }

    @Override
    public Optional<Member> findById(Long id) {
        return Optional.ofNullable(store.get(id));
    }

    @Override
    public Optional<Member> findByName(String name) {
        return store.values().stream()
                .filter(member -> member.getName().equals(name))
                .findAny();
    }

    @Override
    public List<Member> findAll() {
        return new ArrayList<>(store.values());
    }

    public void clearStore() {
        store.clear();
    }
}

 

## 회원 리포지토리 테스트 케이스 작성

• 테스트 케이스 작성 : 작업 내역에 대한 정상 동작 여부 등 확인을 위해 필수로 작성. (자바의 경우 JUnit이란 프레임워크로 테스트를 실행)

테스트 케이스 생성 관례

• 테스트 하고자 하는 클래스명 뒤에 Test 붙여서 생성.

테스트 케이스 생성

• MemoryMemberRepositoryTest

package hello.hellospring.repository;

import hello.hellospring.domain.Member;
import org.assertj.core.api.Assertions;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.Test;

import java.util.List;

public class MemoryMemberRepositoryTest {
    MemoryMemberRepository repository = new MemoryMemberRepository();

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

        repository.save(member);

        Member result = repository.findById(member.getId()).get();

        // 위에서 저장한 member, DB에서 가져온 member가 동일한 경우 -> 참
        // 방식1. Assertions.assertEquals 사용.
        // Assertions.assertEquals(member, result); // 동일.
        // Assertions.assertEquals(member, null); // 다른경우 test.

        // 방식2. Assertions.assertThat 사용.
        Assertions.assertThat(member).isEqualTo(result);
    }

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

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

        Member result1 = repository.findByName("spring1").get();    // 참
        //Member result1 = repository.findByName("spring1").get();    // 거짓
        Assertions.assertThat(member1).isEqualTo(result1);

        Member result2 = repository.findByName("spring2").get();    // 참
        //Member result2 = repository.findByName("spring1").get();    // 거짓
        Assertions.assertThat(member2).isEqualTo(result2);
    }

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

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

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

        Assertions.assertThat(result.size()).isEqualTo(2);  // 참
        //Assertions.assertThat(result.size()).isEqualTo(3);  // 거짓

    }
}

@AfterEach

• 위 테스트 코드에서 전체 테스트 진행 시 오류 발생 함.
• 테스트의 경우 테스트 순서에 대한 보장이 안됨 그렇기 때문에 spring1, spring2 이라는 이름의 member 중복으로 인해 오류 발생.
• 오류를 해결하기 위해 하나의 테스트(메서드)가 종료된 경우 테스트 데이터를 clear 해줘야 한다.

package hello.hellospring.repository;

import hello.hellospring.domain.Member;
import org.assertj.core.api.Assertions;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.Test;

import java.util.List;

public class MemoryMemberRepositoryTest {
    MemoryMemberRepository repository = new MemoryMemberRepository();

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

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

        repository.save(member);

        Member result = repository.findById(member.getId()).get();

        // 위에서 저장한 member, DB에서 가져온 member가 동일한 경우 -> 참
        // 방식1. Assertions.assertEquals 사용.
        // Assertions.assertEquals(member, result); // 동일.
        // Assertions.assertEquals(member, null); // 다른경우 test.

        // 방식2. Assertions.assertThat 사용.
        Assertions.assertThat(member).isEqualTo(result);
    }

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

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

        Member result1 = repository.findByName("spring1").get();    // 참
        //Member result1 = repository.findByName("spring1").get();    // 거짓
        Assertions.assertThat(member1).isEqualTo(result1);

        Member result2 = repository.findByName("spring2").get();    // 참
        //Member result2 = repository.findByName("spring1").get();    // 거짓
        Assertions.assertThat(member2).isEqualTo(result2);
    }

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

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

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

        Assertions.assertThat(result.size()).isEqualTo(2);  // 참
        //Assertions.assertThat(result.size()).isEqualTo(3);  // 거짓

    }
}

 

TDD (테스트 주도 개발)

• 테스트 케이스를 먼저 생성 하고 구현 클래스를 만들어서 작동시키는 것. (위에서 작업한건 TDD가 아님, 단지 이런 것도 있다는 정도만 알고가기)

## 회원 서비스 개발

• 서비스 클래스의 메서드명은 비즈니스에 알맞은 용어를 사용하는것을 권장. (서비스는 비즈니스 의존적으로 설계, 리포지토리는 서비스 보다는 기계적으로 개발스럽게 용어 사용)
• MemberService (DI 미적용)

package hello.hellospring.service;

import hello.hellospring.domain.Member;
import hello.hellospring.repository.MemberRepository;
import hello.hellospring.repository.MemoryMemberRepository;

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

public class MemberService {

    private final MemberRepository memberRepository = new MemoryMemberRepository();

    /**
    * 회원 가입
    */
    public Long join(Member member) {
        validateDuplicateMember(member);    // 중복 회원 검증.
        memberRepository.save(member);
        return member.getId();
    }

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

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

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

• MemberService (DI 적용)

package hello.hellospring.service;

import hello.hellospring.domain.Member;
import hello.hellospring.repository.MemberRepository;
import hello.hellospring.repository.MemoryMemberRepository;

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

public class MemberService {

    private final MemberRepository memberRepository;

    public MemberService(MemberRepository memberRepository) {
        this.memberRepository = memberRepository;
    }

    /**
    * 회원 가입
    */
    public Long join(Member member) {
        validateDuplicateMember(member);    // 중복 회원 검증.
        memberRepository.save(member);
        return member.getId();
    }

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

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

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

## 회원 서비스 테스트

• 위에서 작업한 회원 서비스 테스트 진행.

테스트 케이스 생성 단축키 (윈도우)

• 윈도우의 경우 클래스명에 Alt + Enter 입력 시 Create Test 항목 선택해서 테스트 케이스 바로 생성가능. 

테스트 케이스 생성

• 테스트 케이스 메서드 명의 경우 한글로도 작성 가능.
• MemberServiceTest

package hello.hellospring.service;

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

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
    void 회원가입() {
        // given
        Member member = new Member();
        member.setName("hello");

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

        // then
        Member findMember = memberService.findOne(saveId).get();
        Assertions.assertThat(member.getName()).isEqualTo(findMember.getName());
    }

    @Test
    public void 중복_회원_예외() {
        // given
        Member member1 = new Member();
        member1.setName("spring1");
        Member member2 = new Member();
        member2.setName("spring1");

        // when
        memberService.join(member1);
        IllegalStateException e = assertThrows(IllegalStateException.class, () -> memberService.join(member2));
        Assertions.assertThat(e.getMessage()).isEqualTo("이미 존재하는 회원 입니다.");

        // then
    }

    @Test
    void 회원전체검색() {
    }

    @Test
    void findMember() {
    }
}