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

비즈니스 요구사항 정리

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

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

출처: 인프런 스프링 입문 강의 (김영한님)

일반적인 웹 애플리케이션은 컨트롤러, 서비스, 리포지토리, 도메인 객체, DB로 구성된다.

• 컨트롤러: 웹 MVC나 API의 컨트롤러 역할
• 도메인: 주로 DB에 저장/관리되는 비즈니스 도메인 객체 (ex. 회원, 주문, 쿠폰 등)
• 서비스: 비즈니스 도메인 객체를 이용해 핵심 비즈니스 로직 구현 (ex. 중복 회원가입 방지)
• 리포지토리: DB에 접근, 도메인 객체를 DB에 저장하고 관리

클래스 의존관계

출처: 인프런 스프링 입문 강의 (김영한님)

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

---

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

아래와 같이 Member, MemberRepository, MemoryMemberRepository 파일을 생성해 준다.

 

회원 객체 (java/hello/hellospring/domain/Member.java)

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

 

회원 리포지토리 인터페이스 (java/hello/hellospring/repository/MemberRepository.java)

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

 

회원 리포지토리 메모리 구현체 (java/hello/hellospring/repository/MemoryMemberRepository.java)

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는 매개변수로 받아온 상태
        member.setId(++sequence);	// id 자동으로 세팅
        store.put(member.getId(), member);	// store에 저장
        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());
    }
}

• null값이 반환될 가능성이 있으면 Optional.ofNullable을 사용한다.
• 실무에서는 공유되는 변수의 경우 동시성 문제를 고려하여 ConcurrentHashMap이나 AtomicLong을 사용하지만, 지금은 단순한 예제이므로 HashMap을 사용한다.
• 자바에서는 카운트 등의 편의성 때문에 List 형태를 많이 사용한다.

---

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

개발한 기능을 테스트할 때 자바의 main 메서드나 웹 애플리케이션의 컨트롤러를 통해서 해당 기능을 실행한다.

이러한 방법은 오래 걸리고, 반복 실행하거나 여러 테스트를 한 번에 실행하기 어렵다.

자바는 JUnit이라는 프레임워크로 테스트를 실행해서 이러한 문제를 해결한다.

 

회원 리포지토리 메모리 구현체 테스트 (java/hello/hellospring/repository/MemoryMemberRepositoryTest.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 static org.assertj.core.api.Assertions.*;

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

}

 

MemoryMemberRepository.java에 아래 코드 추가

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

 

• 한번에 여러 개의 테스트를 실행하면 메모리 DB에 직전 테스트 결과가 남아서 다음 테스트가 정상적으로 실행되지 않을 수 있다.
• @AfterEach를 사용하면 각 테스트가 종료될 때 마다 이 기능을 실행한다. (여기서는 메모리 DB에 저장된 데이터를 삭제)

---

회원 서비스 개발

java/hello/hellospring/service/MemberService.java

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

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

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

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

Optinal을 이용해 null 값을 다룰 수 있다. (ex. ifPresent)

---

회원 서비스 테스트

MemberServiceTest 클래스에 커서를 두고 command+shift+t를 누르면 Create Test 창이 뜬다.

위와 같이 설정하고 OK를 누르면, 아래처럼 자동으로 테스트 클래스가 만들어진다.

 

MemberService.java에 public MemberService()를 추가한다.

public class MemberService {

    private final MemberRepository memberRepository;

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

 

MemberServiceTest.java

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

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

        // then
        Member findMember = memberService.findOne(saveId).get();
        assertThat(member.getName()).isEqualTo(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);
        IllegalStateException e = assertThrows(IllegalStateException.class,
                () -> memberService.join(member2));

        assertThat(e.getMessage()).isEqualTo("이미 존재하는 회원입니다.");

    }

}

테스트를 할 때, 새로운 객체를 생성하면 기존 DB에 있는 객체와 다른 객체가 생성되어 테스트에 영향이 생긴다. (static이 아닌 경우)

따라서 @BeforeEach를 이용해 서로 영향이 없도록 항상 새로운 객체를 생성하고, 의존관계도 새로 맺어주어야 한다.

@BeforeEach는 각 테스트 실행 전에 호출된다.