스프링 입문 (4) - 회원 관리 예제 - 백엔드 개발

비즈니스 요구사항 정리

- 데이터 : 회원ID, 이름

- 기능 : 회원 등록, 조회

- DB는 어떤 걸 쓸 지 정해지지 않음

 

일반적인 웹 어플리케이션 구조

- 컨트롤러 : 웹 MVC의 컨트롤러 역할 (지난 차시 학습)

- 서비스 : (도메인 객체를 가지고 동작하는) 핵심 비즈니스 로직 구현 

- 리포지토리 : DB접근, 도메인 객체를 DB에 저장 및 관리

- 도메인 : 비즈니스 도메인 객체. 예) 회원, 주문, 쿠폰 등등 주로 DB에 저장하고 관리

 

클래스 의존관계

- 초기 개발 단계에서는 구현체로 가벼운 메모리 기반의 데이터 저장소 사용

- DB가 선정되지 않았으므로 인터페이스로 구현 클래스를 변경할 수 있도록 설계 (추후 변경 용이)

 

회원 객체 : 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

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은 null 처리 시 Optional로 감싸서 반환
    Optional<Member> findById(Long id);
    Optional<Member> findByName(String name);
    List<Member> findAll();
}

 

Map을 가지는 리포지터리 메모리 구현체 : hello/hellospring/repository/MemoryMemberRepository.java

DB 대용으로 메모리에 데이터를 가지고 있다고 보면 된다.

package hello.hellospring.repository;

import hello.hellospring.domain.Member;

import java.util.*;

public class MemoryMemberRepository implements MemberRepository{

    // 실무에서는 동시성 문제로 인하여 ConcurrentHashMap, AtomicLong 사용
    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;
    }

    // null이 반환될 가능성이 있는 경우 Optional로 감싸줌
    @Override
    public Optional<Member> findById(Long id) {
        return Optional.ofNullable(store.get(id));
    }

    // findAny()가 Optional이라서 따로 감싸주지 않아도 됨
    @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());
    }
} 

 

findAny 참고

여기까지 잘 따라왔다면 아래와 같이 프로젝트의 파일들이 있을것이다.

 

테스트 케이스 작성

테스트 시 main 메소드를 통해 실행하거나 웹 애플리케이션의 컨트롤러를 통해 기능을 실행하게 되는데, 이러한 방법은 준비 시간 및 실행 시간이 오래걸리며 반복 실행하기 어렵고 여러 테스트를 한번에 실행하기 어렵다. 자바는 JUnit이라는 프레임워크로 테스트를 실행하여 위 문제를 해결한다.

 

회원 리포지터리 메모리 구현체(MemoryMemberRepository)테스트

 

src/test/java/hello/hellospring에 repository 패키지를 만들고, MemoryMemberRepositoryTest 클래스를 만들어준다. 관례상 테스트하려는 클래스의 이름 뒤에 Test를 붙여 테스트케이스 파일을 작성한다.

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.*;

// 다른데서 가져다 쓸 게 아니니 굳이 public으로 하지 않아도 된다.
class MemoryMemberRepositoryTest {
    MemoryMemberRepository repository = new MemoryMemberRepository();


    // aftereach()는 callBack Method임
    @AfterEach
    public void afterEach() {
        repository.clearStore();
    }
    @Test
    public void save() {
        // given (어떤 데이터가 주어졌을 때)
        Member member = new Member();
        member.setName("spring");

        // when (어떤 동작을 했을 때)
        repository.save(member);

        // then (원하는 결과값)
        // Optional에서 get()으로 값을 꺼낼 수 있음 (Optional으로 반환되기 때문에)
        // 다만 적절한 방법은 아님
        Member result = repository.findById(member.getId()).get();
        // 기대값, 실제값 순서
        // jUnit보다 assertj가 조금 더 편함
        assertThat(member).isEqualTo(result);
    }

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

        // 복사 후 변수명 한번에 바꾸기 Alt + Shift + R
        Member member2 = new Member();
        member2.setName("spring2");
        repository.save(member2);

        // when
        Member result = repository.findByName("spring1").get();

        // then
        assertThat(result).isEqualTo(member1);
        result = repository.findByName("spring2").get();
        assertThat(result).isEqualTo(member2);
    }

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

    /*
      findAll을 만들고 클래스 테스트를 해보니 findByName이 에러가 남!
      findAll이 먼저 실행되고 findByName이 실행되어(순서는 보장X, 순서의존하게 설정하면 절대안됨) repository 변수에서 간섭이 된것.
      테스트케이스별로 독립적으로 실행되어야 하므로 afterEach를 통해 매 테스트케이스 실행 후 초기화되도록 설정함
     */
}

 

MemoryMemberRepository에 초기화 코드를 추가해준다.

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

 

 

테스트는 정말 중요한 내용이며, 대규모 협업 시스템에서 테스트없이 개발할 수 없으므로 추후 깊이있게 배워봐야겠다.

 

회원 서비스 개발

회원 서비스란? 회원 리포지토리와 도메인을 활용하여 비즈니스 로직을 작성하는 것

 

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
        // 오른쪽 식만 작성하고 Ctrl + Alt + V 하면 자동으로 반환식을 작성해줌
        
    /*    ver 1
        Optional<Member> result = memberRepository.findByName(member.getName());
        Optional이기에 가능한 ifPresent 메소드
        result.ifPresent(m -> {
            throw new IllegalStateException("이미 존재하는 회원입니다");
        });*/
        
    /*    ver 2
        아래 코드를 전체 선택하고 Ctrl + T를 눌러 메소드로 확장 선택
        memberRepository.findByName(member.getName())
                .ifPresent(m -> {
                    throw new IllegalStateException("이미 존재하는 회원입니다.");
                });*/
        
//        ver 3 - 메소드로 확장
        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);
    }

}

 

 

해당 클래스 이름에 커서를 두고 Alt + Enter > Create test 누르면 간편하게 테스트코드 클래스를 만들 수 있다.

패키지 경로도 main에서 test로 바뀌었을 뿐 동일한 경로로 생성된다.

 

그전에 MemberService를 DI 받을 수 있게 변경한다

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 static org.assertj.core.api.Assertions.*;

import hello.hellospring.repository.MemoryMemberRepository;
import org.assertj.core.api.Assertions;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;

import static org.junit.jupiter.api.Assertions.*;

class MemberServiceTest {

    MemberService memberService;
    // afterEach를 위해 가져옴. *중요* 여기서 이건 다른 객체가 아니냐? 할 수 있는데, MemoryMemberRepository에 들어가보면
	// store는 static이기때문에 MemberService가 누구든 공유됨.
    
/*
    ver 1
    그렇지만 헷갈리게 두개를 할 필요는 없으므로...
    MemoryMemberRepository memberRepository = new MemoryMemberRepository();
*/

//    ver 2
    MemoryMemberRepository memberRepository;

    // 여기서 MemberService에 리포지터리를 넣어 독립적으로 동작하게 해주기 위하여
    // MeberService의 구성자를 리포지터리를 받을 수 있도록 수정함
    @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
    void 중복회원예외() {
        //given
        Member member = new Member();
        member.setName("hello");

        Member member2 = new Member();
        member2.setName("hello");

        //when
        memberService.join(member);
        // 예외가 터질것을 단언!
        assertThrows(IllegalStateException.class, () -> memberService.join(member2));

//        IllegalStateException e = assertThrows(IllegalStateException.class, () -> memberService.join(member2));
//        assertThat(e.getMessage()).isEqualTo("이미 존재하는 회원입니다.");

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

    }

    @Test
    void findMembers() {
    }

    @Test
    void findOne() {
    }
}

 

사진, 코드 출처 - https://inf.run/hivx6