[Spring 입문] 3. 회원 관리 예제 - 백엔드 개발

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

• 데이터
  • 회원 ID
  • 이름
• 기능
  • 회원 등록
  • 조회
• 아직 DB 선정하지 않은 상황 ← 이라는 설정

• 컨트롤러 : 웹 MVC의 컨트롤러 (API 생성 등)
• 서비스 : 핵심 비즈니스 로직
• 도메인 : 데이터베이스에 저장 / 관리되는 것
• 리포지토리 : 데이터 베이스 접근 / 도메인 객체를 DB에 저장 및 관리

• 인터페이스로 구현 클래스 변경 가능하게 설계(DB 선정 안 함)
  • 구현체로 메모리 기반의 가벼운 데이터 저장소로 개발 진행

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

1. Member 클래스 생성

package hello.hellospring.domain;

public class Member {
    private Long id; // database index에 가까움
    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;
    }
}

2. Member 관리 repository 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 = nullable, 없을 수 있음
    Optional<Member> findByName(String name);
    List<Member> findAll();
}

3. Member 관리 repository 구현체

package hello.hellospring.repository;
import hello.hellospring.domain.Member;
import java.util.*;
public class MemoryMemberRepository implements MemberRepository{
    // id, object
    private static Map<Long, Member> store = new HashMap<>();
    // key 값 생성
    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)); // nullable, 없을 수 있음. 
    }

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

    @Override
    public Optional<Member> findByName(String name) {
        return store.values().stream() // store의 내용들 중에서
                .filter(member -> member.getName().equals(name)) // name이 같으면
                .findAny();
    }
	// = select * from store where name = {name};

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

 

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

• 코드를 코드로 검증!
• Java에서는 JUnit 프레임워크로 테스트를 실행하도록 함.

package hello.hellospring.repository;

import hello.hellospring.domain.Member;
//import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.Test;
import static org.assertj.core.api.Assertions.assertThat;

class MemoryMemberRepositoryTest {

    MemberRepository repository = new MemoryMemberRepository();

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

        repository.save(member);

        Member result = repository.findById(member.getId()).get();
//        System.out.println("result = " + (result == member));
//        Assertions.assertEquals(result, member);
        assertThat(member).isEqualTo(result);
    }

}

• assertion That이 junit 의 Assertion으로는 호환되지 않음
• import static org.assertj.core.api.Assertions.assertThat; 으로 해결 가능

@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의 method 실행 순서는 랜덤 → 모두 독립적으로 실행되도록 하기 위해서는 테스트 후 repository(든 뭐든)를 클리어해줘야함.

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

• 저장된 객체를 싹 비워주는 코드

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

TDD ⇒ Test 주도 개발, 테스트 케이스를 먼저 만들고 나서 구현체를 만드는 것.

 

4. 회원 서비스 개발

public Long join(Member member) {
      // 멤버 이름 중복 방지
      memberRepository.findByName(member.getName())
                .ifPresent(m -> {
                    throw new IllegalStateException("이미 존재하는 회원입니다.");
                });;
      memberRepository.save(member);
      return member.getId();
  }

• ifPresent = 존재한다면 이후 function 실행
• 좀 더 간결하게 메소드로 빼내면

public Long join(Member member) {
    // 멤버 이름 중복 방지
    validateDuplicateMember(member);
    memberRepository.save(member);
    return member.getId();
}
private void validateDuplicateMember(Member member) {
    memberRepository.findByName(member.getName())
            .ifPresent(m -> {
                throw new IllegalStateException("이미 존재하는 회원입니다.");
            });
}

• 나머지 find 관련 서비스 구현

// select all members
public List<Member> findMembers() {
    return memberRepository.findAll();
}

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

 

5. 회원 서비스 테스트

• 클래스 이름 → Control + Shift + T 하면 자동으로 테스트 생성

• !? 테스트 코드의 함수 이름 한글로 써도 됨
• given / when / then 구문으로 테스트 작성
  • 주어진 input을 받았을 때 → when 이라는 케이스에 대해서 → then이라는 결과가 나오도록

class MemberServiceTest {

    MemberService memberService = new MemberService(memberRepository);
    MemoryMemberRepository memberRepository = new MemoryMemberRepository();

...

• member service에서 new MemberService() 만으로 생성을 하면 위에서 만든 memberRepository 와는 다른 repository를 사용하는 것이 됨.
  • 당장은 MemoryMemberRepository의 store 가 static이라 괜찮지만 아니면 문제됨
• Member Service에서 새로 MemberRepository를 생성하지 않고 받아와서 service를 구동하게 되면 같은 repository를 사용하게 되겠죠?

public class MemberService {

		// 기존 
		// private final MemberRepository memberRepository = new MemoryMemberRepository();

		// 변경
    private final MemberRepository memberRepository;

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

• 아래와 같이 외부에서 넣어주도록 설계하는 것을 Dependency Injection(의존성 주입) 이라고 부름

class MemberServiceTest {

    MemberService memberService;
    MemoryMemberRepository memberRepository;

    @BeforeEach
    public void beforeEach() {
        memberRepository = new MemoryMemberRepository();
        memberService = new MemberService(memberRepository);
    }

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