Java Spring-3

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

비지니스 요구 사항 정리

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

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

• 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;
    }
}//간단하게 이름과 id만 다룬다.

• repository라는 패키지를 추가로 만들고 MemberRepository 인터페이스 파일을 생성

public interface MemberRepository {
    Member save(Member member);
    Optional<Member> findById(Long id);
    Optional<Member> findByName(String name);
    List<Member> findAll();
}

• 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.setId(++sequence);
        store.put(member.getId(), member);
        return member;
    }

    @Override
    public Optional<Member> findById(Long id) {
        return Optional.ofNullable(store.get(id));
        //return 값이 null인 경우도 있기 때문에 Optional.ofNullable을 사용하면 null이 반환되더라도 클라이언트에서 처리할 수 있다.
    }

    @Override
    public Optional<Member> findByName(String name) {
        return store.values().stream()
                .filter(member -> member.getName().equals(name))
                .findAny();//stream과 filter를 이용하여 저장되어 있는 데이터에 같은 이름이 있는지 찾는다.
    }

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

• 작성된 코드가 제대로 작동하는지 테스트 케이스를 만들어서 확인한다.
• MemoryMemberRepository를 테스트하고 싶다면 test 폴더 아래에 똑같이 repository 패키지를 만들고 만들어진 패키지에 MemoryMemberRepositoryTest.java 파일을 만든다.

class MemoryMemberRepositoryTest {
    MemoryMemberRepository repository = new MemoryMemberRepository();

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

        repository.save(member);

        Member result = repository.findById(member.getId()).get();
        Assertions.assertEquals(member, result);
        //member와 result가 같다면 아무런 문제가 발생하지 않음
        //다르다면 에러가 발생한다.
    }
}

• 인텔리제이에서 변수명을 한번에 바꾸는 방법: fn+shift+f6
• 이제는 MemoryMemberRepository 파일에 있는 전반적인 메소드를 한 번에 테스트해본다.

package hello.hellospring.repository;

import hello.hellospring.domain.Member;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.Test;

import java.util.List;

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

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("spring1");
        repository.save(member2);

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

        assertThat(member1).isEqualTo(result);
    }

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

• 위의 코드에서 afterEach() 메소드가 작동하려면 MemoryMemberRepository 파일에 clearStore() 메소드를 선언해야 한다. 따라서 MemoryMemberRepository 파일에 다음 코드를 추가한다.

    public void clearStore() {
        //Test 파일에서 메소드 하나하나를 테스트할 때 하나의 메소드가 종료되면 저장되어 있는 데이터를 지우는 역할
        store.clear();
    }

회원 서비스 개발

• 인텔리제이 메소드 선언 단축키 팁(ctrl + t)

public class MemberService {
    private final MemberRepository memberRepository = new MemoryMemberRepository();

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

• 위의 코드에서 findByName 로직을 단축키를 이용하여 메소드를 자동으로 생성할 수 있다. 해당 부분을 드래그하여 ctrl + t를 누르고 Extract Method 메뉴를 클릭 후 메소드명을 설정하면 된다. 그러면 다음과 같이 코드가 변경된다.

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("이미 존재하는 회원입니다.");
                });
    }
}

• MemberService 파일의 전체 코드는 다음과 같다.

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

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

MemberService의 메소드 테스트하기

• MemberService 파일에서 command + shift + t를 누르고 Create New Test를 클릭 후 파일 이름 설정 및 테스트를 하고 싶은 메소드를 체크해주면 인텔리제이에서 알아서 테스트 파일을 생성한다.
• 변수 추출하기 단축키: cmd + option + v
• 테스트를 하는 과정에서 한가지 신경쓰이는 부분이 있다.

class MemberServiceTest {

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

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

• 위의 코드는 MemberServiceTest 파일의 제일 상단 부분 코드이면서 각각의 테스트 메소드들이 종료되면 db를 다 날리는 기능을 하는 메소드이다. 여기서 신경쓰이는 부분은 코드의 첫 두줄이다. MemberService 객체를 생성하면 자동으로 MemoryMemberRepository 객체가 하나 생성되는데 위의 코드는 또 다른 MemoryMemberRepository 객체를 더 생성한다. MemoryMemberRepository 객체를 두 개를 사용할 이유가 전혀 없기 때문에 이를 통합해줘야 한다. 따라서 다음과 같이 코드를 변경한다. 우선 MemberService 파일의 코드.

public class MemberService {

    private final MemberRepository memberRepository;

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

• 다음은 MemberServiceTest 파일의 코드.

class MemberServiceTest {

    MemberService memberService;
    MemoryMemberRepository memberRepository;

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

• 이렇게 두 파일의 코드를 변경하면 이제는 의미없이 두개의 MemoryMemberRepository 객체가 작동하는 것이 아니라 하나의 객체만을 사용하여 테스트할 수 있게 된다.
• 이를 MemberService 입장에서 보면 MemoryMemberRepository 객체를 직접 선언하지 않고 외부에서 넣어주는 것인데 이를 dependency injection이라 한다. 흔히 DI라고 부름.