3장 회원 관리 예제 - 백엔드 개발

Updated: March 19, 2024

비지니스 요구사항 정리

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

일반적인 웹 애플리케이션의 계층 구조는 다음과 같다.

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

클래스 의존관계는 다음과 같다.

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

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

src/main/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;
    }
}

이후 hello.hellospring에 repository 패키지를 생성한뒤, MemberRepository.java 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); // Id나 Name이 없으면 Null 반환
    Optional<Member> findByName(String name);
    List<Member> findAll();
}

같은 위치에 MemoryMemberRepository.java를 작성한다.

package hello.hellospring.repository;

import hello.hellospring.domain.Member;

import java.util.*;

/*
동시성 문제가 고려되어 있지 않음, 실무에서는 ConcurrentHashMap, AtomicLong 사용 고려
 */
public class MemoryMemberRepository implements MemberRepository{

    private static Map<Long,Member> store = new HashMap<>();
    private static long sequence = 0L; // sequence는 0, 1, 2 등 key 값을 생성

    @Override
    public Member save(Member member) {
        member.setId(++sequence);
        store.put(member.getId(), member);
        return member;
    } // member의 Id를 셋팅을 하고 store에 저장

    @Override
    public Optional<Member> findById(Long id) {
        return Optional.ofNullable(store.get(id)); // ofNullable은 Null이 반환될 가능성이 있을 때 사용
    } // store에서 가져옴

    @Override
    public Optional<Member> findByName(String name) {
        return store.values().stream() 
                .filter(member -> member.getName().equals(name)) // getName으로 받아온 name이 파라미터로 넘어온 name과 같은지 비교
                .findAny(); // name이 같고 찾으면 반환, 만약 없으면 Null 반환
    }

    @Override
    public List<Member> findAll() {
        return new ArrayList<>(store.values()); // store에 있는 value들을 반환
    }
}

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

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

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;
import java.util.Optional;

import static org.assertj.core.api.Assertions.*;

class MemoryMemberRepositoryTest {

    MemoryMemberRepository repository = new MemoryMemberRepository();

    @AfterEach
    public void afterEach() {
        repository.clearStore();
    } // 각 Test가 끝날 때마다 지워줌
    // Test는 순서에 상관 없이, 의존관계 없이 설계가 되어야 한다. 그래서 하나의 Test가 끝날 때마다 저장소나 공용 데이터를 지워주어야 함.


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

        repository.save(member);

        Member result = repository.findById(member.getId()).get();
        // System.out.println("result = " + (result == member));
        // Assertions.assertEquals(result, member); // 출력이 되는 것은 없지만 빌드가 됨, member을 null로 수정시 컴파일 되지 않음
        assertThat(member).isEqualTo((result)); // member가 result와 같을 때, 이것을 자주 씀
        // Alt + enter에서 static import로 하면 Assertions.assertThat을 assertThat으로 할 수 있음
    }

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

        Member member2 = new Member(); // 위의 내용을 복사한 뒤 Shift + F6을 하면 변수를 변경할 수 있음
        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);
    }
}

위 코드에서 repository.clearStore()을 하기위해 MemorymemberRepository에 cearStore() 메소드를 만들어 준다.

package hello.hellospring.repository;

import hello.hellospring.domain.Member;

import java.util.*;

/*
동시성 문제가 고려되어 있지 않음, 실무에서는 ConcurrentHashMap, AtomicLong 사용 고려
 */
public class MemoryMemberRepository implements MemberRepository{

    private static Map<Long,Member> store = new HashMap<>();
    private static long sequence = 0L; // sequence는 0, 1, 2 등 key 값을 생성

    @Override
    public Member save(Member member) {
        member.setId(++sequence);
        store.put(member.getId(), member);
        return member;
    } // member의 Id를 셋팅을 하고 store에 저장

    @Override
    public Optional<Member> findById(Long id) {
        return Optional.ofNullable(store.get(id)); // ofNullable은 Null이 반환될 가능성이 있을 때 사용
    } // store에서 가져옴

    @Override
    public Optional<Member> findByName(String name) {
        return store.values().stream() 
                .filter(member -> member.getName().equals(name)) // getName으로 받아온 name이 파라미터로 넘어온 name과 같은지 비교
                .findAny(); // name이 같고 찾으면 반환, 만약 없으면 Null 반환
    }

    @Override
    public List<Member> findAll() {
        return new ArrayList<>(store.values()); // store에 있는 value들을 반환
    }

    public void clearStore() {
        store.clear(); // store을 비워줌
    }
}

화원 서비스 개발

src/main/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) {
        // 같은 이름이 있는 중복 회원 X
        /*
        Optional<Member> result = memberRepository.findByName(member.getName());
        // ctrl + alt + v 단축키를 통해 Optional<Member> result를 자동으로 생성
        result.ifPresent(m -> {
            throw new IllegalStateException("이미 존재하는 회원입니다.");
        }); // 아래와 동일한 코드
        */

        validateDuplicateMember(member); // 중복 회원 검증
        // Shift + ctrl + alt + T 단축키를 통해 아래 적은 memberRepositort.findByName을 함수로 만들어 줌
        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);
    }
}

회원 서비스 테스트

Shift + Ctrl + T단축키를 통해 test 패키지에 MemberServiceTest.java를 생성한다.

package hello.hellospring.service;
// Shift + Ctrl + T를 통해 모든 항목을 체크한 후 자동으로 생성
import hello.hellospring.domain.Member;
import hello.hellospring.repository.MemberRepository;
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 = new MemberService();
//    MemoryMemberRepository memberRepository = new MemoryMemberRepository();
//    이를 다음과 같이 @BeforeEach까지 해서 바꿀 수 있다.

    MemberService memberService;
    MemoryMemberRepository memberRepository;

    @BeforeEach // 각 테스트 실행 전에 호출된다. 테스트가 서로 영향이 없도록 항상 새로운 객체를 생성하고, 의존관계도 새로 맺어준다.
    public void beforeEach() {
        memberRepository = new MemoryMemberRepository();
        memberService = new MemberService(memberRepository);
    }

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

    @Test
    void 회원가입() { // Test는 한글로 적어도 됨
        //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 중복_회원_예외() {
        //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("이미 존재하는 회원입니다.");

//        try {
//            memberService.join(member2);
//            fail();
//        } catch (IllegalStateException e) {
//            assertThat(e.getMessage()).isEqualTo("이미 존재하는 회원입니다.");
//        }

        //then
    }

    @Test
    void findMembers() {
    }

    @Test
    void findOne() {
    }
}

Twitter Facebook LinkedIn

MyeongWoo

3장 회원 관리 예제 - 백엔드 개발

비지니스 요구사항 정리

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

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

화원 서비스 개발

회원 서비스 테스트

공유하기

댓글남기기

참고

8장 인터페이스

7장 상속

6장 클래스

5장 참조 타입