비즈니스 요구사항

• 데이터: 회원ID, 이름
• 기능: 회원 등록, 조회
• 아직 DB가 정해지지 않았다는 가상의 시나리오를 부여

✋ 웹 애플리케이션 계층구조

• 컨트롤러: 웹 MVC의 컨트롤러 역할
• 서비스: 핵심 비즈니스 로직 구현
• 리포지토리: 데이터베이스에 접근, 도메인 객체를 DB에 저장하고 관리
• 도메인: 비즈니스 도메인 객체

✋ 클래스 의존관계

• 아직 DB가 정해지지 않았다는 가상의 시나리오를 부여했기 때문에, 우선 인터페이스로 구현 클래스를 변경할 수 있도록 설계하였습니다.
• 개발을 진행하기 위해서 초기 개발 단계에서는 구현체로 가벼운 메모리 기반의 DB를 사용했습니다.

---

회원 도메인과 리포지토리

💻 회원 객체 작성

회원, 주문, 쿠폰과 같이 비즈니스 도메인 객체들이 저장되는 도메인 패키지를 /java/hello.hellospring 하위에 새로 만들어줍니다.
그리고 Member.java 파일을 생성하고 다음과 같이 작성해 회원 객체를 만들어줍니다.

public class Member {

    private Long id; 		//시스템이 저장하는 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;
    }
}

• Long형 변수 id 는 사용자가 입력하는 아이디가 아니라 시스템이 임의로 지정해 저장하는 아이디를 뜻합니다.

💻 회원 리포지토리 인터페이스 작성

무슨 DB를 사용할지 아직 정해지지 않았다는 가상의 시나리오를 부여했기 때문에 인터페이스로 구현 클래스를 변경할 수 있도록 설계하겠습니다.
우선 /java/hello.hellospring 하위에 repository 패키지를 생성하고 MemberRepository 인터페이스를 다음과 같이 작성해줍니다.

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

• findById() 와 findByName() 메소드를 호출하고 반환받은 값이 null 값일 경우 NPE(NullPointerException) 이 발생할 수 있기 때문에 Optional 로 감싸서 이를 방지해줍니다.

💻 회원 리포지토리 메모리 구현체 작성

이제 작성할 MemoryMemberRepository 라는 구현체는 MemberRepository 를 implements 한 구현체로 아직 DB가 없는 상태에서 프로젝트가 실행되었을때, 메모리를 이용해 회원정보를 임시로 저장하는 임시 DB라고 보시면됩니다.
/repository 패키지 하위에 MemoryMemberRepository.java 라는 파일을 생성하고 다음과 같이 작성해줍니다.

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();
    }
}

• 동시성 문제는 고려하지 않은 설계로 실무에서는 ConcurrentHashMap<> 과 AtomicLong 형을 사용합니다.
• HashMap<> 으로 선언된 store 가 임시DB라고 보시면 됩니다.
• 시스템이 임의로 아이디를 지정해 저장하기위해 sequence 변수를 사용합니다.
• findById() 메소드에서 store.get(id) 의 값이 null 인 경우 Optional.empty() 가 반환됩니다.
• findByName() 메소드에서는 store.values() 를 통해 store 에 저장된 value값들만 가져오고, 이를 stream().filter() 로 파라미터로 받아온 name 과 일치하는 멤버를 찾아 반환합니다.

---

회원 리포지토리 테스트

✋ 단위테스트란?
개발을 하다보면 여러 기능들이 추가되고 라이브러리들이 변경되면서 개발자의 의도와는 다르게 코드가 잘 작동하지 않는 경우가 있습니다.
이 때문에 작성된 소스코드의 특정 모듈(메소드)이 의도한대로 정확히 작동하는지 검증하는 절차가 필요하며 이를 단위테스트라고 부릅니다.

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

테스트 케이스 작성을 위해 /test/java/hello.hellospring 하위에 repository 패키지를 생성하고 MemoryMemberRepository.java 파일을 만들어 다음과 같이 작성해줍니다.

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();
        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 result = repository.findByName("spring1").get();
        
        assertThat(result).isEqualTo(member1);
    }

    @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();
        
        assertThat(result.size()).isEqualTo(2);
    }
}

• 각각의 메소드는 @Test 어노테이션을 통해 해당 메소드가 단위 테스트 메소드임을 지정합니다.
• @AfterEach 어노테이션을 붙인 메소드는 각각의 단위 테스드 메소드 실행 이후에 실행됩니다. 주로 위의 코드와 같이 단위 테스트 중 사용되었던 리소스를 처리하는 용도로 사용됩니다.
• save() 메소드는 생성한 회원객체를 통해 "spring" 이라는 이름을 가진 회원을 repository 에 저장합니다. 이후 findById() 로 저장된 회원객체를 다시 가져와, 저장한 회원객체/불러온 회원객체가 서로 일치하는지 확인합니다.
• findByName() 와 findAll() 도 마찬가지로 save() 메소드와 비슷한 방식의 검증절차를 거칩니다.

👉 회원 리포지토리 테스트

단위 테스트를 진행하면 다음과 같이 테스트를 통과해 검증이 완료된 것을 확인할 수 있습니다.

🙏 이 포스트는 김영한 개발자님의 <스프링 입문 강의> 를 듣고 공부한 내용을 바탕으로 작성되었습니다.