[입문] 회원 관리 예제(1) - domain, repository, test case

<목차>

01. 비즈니스 요구사항 정리

02. 회원 도메인과 레포지토리 만들기

03. 회원 레포지토리 테스트 케이스 작성

04. 회원 서비스 개발

05. 회원 서비스 테스트

 

01. 비즈니스 요구사항 정리

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

 

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

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

 

클래스 의존관계

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

 

02. 회원 도메인과 레포지토리 생성

회원 객체와 회원 레포지토리 인터페이스, 레포티로이 메모리 구현체를 생성한다. 

회원 객체(domain)

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

 

회원 레포지토리 인터페이스(repository)

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); // null값 있을 경우 optional로 감싸서 반환
	Optional<Member> findByName(String name);
	List<Member> findAll();
}

 

 

 

반환값으로 null값이 가능한 경우 Optional로 감싸주면 좋다.

 

회원 레포지토리 메모리 구현체(repository) 

package hello.hellospring.repository;

import hello.hellospring.domain.Member;

import java.util.*;

public class MemoryMemberRepository implements MemberRepository{
	// 동시성 문제 고려 X
	private static Map<Long, Member> store = new HashMap<>();
	private static long sequence = 0L; // 시퀀스 값 생성(1, 2, 3...)

	@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)); // null값 나올 수 있는 경우 Optional.ofNullable로 감싸기
	}

	@Override
	public Optional<Member> findByName(String name) {
		return store.values().stream()
			.filter(member -> member.getName().equals(name))
			.findAny(); // 하나라도 찾기(Optional로 반환
	}

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

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

• Optional.ofNullable()을 사용하면 null값이 나올 수 있는 객체를 오류없이 반환할 수 있다.
• 현재 HashMap과 Long을 사용했는데, 실무에서는 동시성 문제 때문에 ConcurrentHashMap과 AtomicLong을 사용한다.

+ 람다식 까먹어서 급하게 정리 https://dev-minji.tistory.com/19

[JAVA] 람다식과 Stream API(filter, map, limit, sorted, peek 등)

03. 회원 레포지토리 테스트 케이스 작성

개발한 기능을 실행해서 테스트 할 때 자바의 main 메서드를 통해서 실행하거나, 웹 애플리케이션의 컨트롤러를 통해서 해당 기능을 실행한다. 이러한 방법은 준비하고 실행하는데 오래 걸리고, 반복 실행하기 어렵고 여러 테스트를 한번에 실행하기 어렵다는 단점이 있다. 자바는 JUnit이라는 프레임워크로 테스트를 실행해서 이러한 문제를 해결한다.

https://dev-minji.tistory.com/66

[JUnit] 테스트 케이스 작성(Assertions, assertEquals, assertThat)

• 테스트 케이스의 장점은 클래스 단위(레벨)에서 실행가능하다는 점이다.
• hello.hellospring 패키지에서 실행하면 전체 클래스 테스트 가능
• test는 외부에서 접근할 필요가 없으므로, public이 아니어도 괜찮다.

회원 레포지토리 메모리 구현체 테스트

src/test/java 하위 폴더에 생성한다.

package hello.hellospring.repository;

import hello.hellospring.domain.Member;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.Test;
import java.util.List;
import java.util.Optional;
import static org.assertj.core.api.Assertions.*;

class MemoryMemberRepositoryTest {
   MemoryMemberRepository repository = new MemoryMemberRepository();
   
   @AfterEach
   public void afterEach() {
   	repository.clearStore();
   }
   
   @Test
   public void save() {
     //given
     Member member = new Member();
     member.setName("spring");
     //when
     repository.save(member);
     //then
     Member result = repository.findById(member.getId()).get();
     assertThat(result).isEqualTo(member);
   }
   
   @Test
   public void findByName() {
     //given
     Member member1 = new Member();
     member1.setName("spring1");
     repository.save(member1);
     Member member2 = new Member();
     member2.setName("spring2");
     repository.save(member2);
     //when
     Member result = repository.findByName("spring1").get();
     //then
     assertThat(result).isEqualTo(member1);
   }
   
   @Test
   public void findAll() {
     //given
     Member member1 = new Member();
     member1.setName("spring1");
     repository.save(member1);
     Member member2 = new Member();
     member2.setName("spring2");
     repository.save(member2);
     //when
     List<Member> result = repository.findAll();
     //then
     assertThat(result.size()).isEqualTo(2);
   }
}

 

01. 테스트를 할 때 GIVEN / WHEN / THEN 세 부분으로 나누어 진행한다

• given : 주어진 데이터가 무엇인지
• when : 검증 조건이 무엇인지
• then : 나와야 하는 결과가 무엇인지

@Test
 public void save() {
   //given
   Member member = new Member();
   member.setName("spring");
   
   //when
   repository.save(member);
   
   //then
   Member result = repository.findById(member.getId()).get();
   assertThat(result).isEqualTo(member);
 }

 

02. @AfterEach(콜백 메소드)

/* main/java/repository/MemoryMemberRepository.java */
public void clearStore(){
	store.clear();
}

/* test/java/repository/MemoryMemberRepositoryTest.java */
MemoryMemberRepository repository = new MemoryMemberRepository();
 @AfterEach
 public void afterEach() {
 	repository.clearStore();
 }

한번에 여러 테스트를 실행하면 메모리 DB에 직전 테스트의 결과가 남을 수 있다. 이렇게 되면 다음 이전 테스트 때문에 다음 테스트가 실패할 가능성이 있다. @AfterEach 를 사용하면 각 테스트가 종료될 때 마다 이 기능을 실행한다. 여기서는 메모리 DB에 저장된 데이터를 삭제한다

 

03. 테스트는 각각 독립적으로 실행되어야 한다. 

테스트 순서에 의존관계가 있는 것은 좋은 테스트가 아니다.