ECC/Spring 입문

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

jiheechoi 2025. 5. 10. 12:23

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

  1. 데이터: 회원 ID, 이름
  2. 기능: 회원 등록, 조회
  3. 아직 DB는 선정되지 않았다는 시나리오
  4. 클래스 의존관계는 다음과 같다. 

 

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

-회원 객체(Member 클래스)

package hello.hello_spring.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;
    }
}

 

- 회원 리포지토리 인터페이스(MemberRepository 인터페이스)

package hello.hello_spring.repository;

import hello.hello_spring.domain.Member;

import java.util.List;
import java.util.Optional;

public interface MemberRepository {

    Member save(Member member); //회원을 저장소에 저장
    Optional<Member> findById(Long id); //저장소에서 id로 회원찾기
    Optional<Member> findByName(String name);   //저장소에서 name으로 회원찾기
    List<Member> findAll(); //지금까지 저장된 모든 회원 리스트를 반환
    
}

 

-회원 리포지토리 메모리 구현체(MemoryMemberRepository 클래스)

package hello.hello_spring.repository;

import hello.hello_spring.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));
    }

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

 

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

-개발한 기능을 실행하여 테스트 -> main 메소드를 통한 실행 OR 컨트롤러를 통한 실행으로 테스트 가능 

-그러나 이러한 방법은 오래 걸리고 반복 실행하기 어렵고 여러 테스트를 한번에 실행하기 어려움 -> JUnit 프레임워크를 이용

-src/test/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 java.util.Optional;
import static org.assertj.core.api.Assertions.*;

class MemoryMemberRepositoryTest {
	MemoryMemberRepository repository = new MemoryMemberRepository();
	@AfterEach
	public void afterEach() {
		repository.clearStore();
	}
	@Test
	public void save() {
		//given
		Member member = new Member();
		member.setName("spring");
		
        //when
		repository.save(member);
		
        //then
		Member result = repository.findById(member.getId()).get();
		assertThat(result).isEqualTo(member);
	}
	@Test
	public void findByName() {
		//given
		Member member1 = new Member();
		member1.setName("spring1");
		repository.save(member1);
		
        Member member2 = new Member();
		member2.setName("spring2");
		repository.save(member2);
		
        //when
		Member result = repository.findByName("spring1").get();
		
        //then
		assertThat(result).isEqualTo(member1);
	}
	@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);
	}
}
  • @AfterEach
    각 테스트 실행 후 저장소(repository)를 비워주는 메소드. 테스트 간 데이터 충돌 방지용.
  • save() 테스트
     save() 메소드로 회원을 저장한 뒤, findById()로 잘 저장됐는지 확인.
  • findByName() 테스트
    → 이름으로 회원을 검색했을 때, 올바른 회원 객체가 반환되는지 검증.
  • findAll() 테스트
    → 저장된 모든 회원 목록을 조회했을 때, 기대한 개수와 일치하는지 확인.

4. 회원 서비스 개발

package hello.hello_spring.service;

import hello.hello_spring.domain.Member;
import hello.hello_spring.repository.MemberRepository;
import hello.hello_spring.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);
    }
}
  • memberRepository:
    → 회원 데이터를 저장하고 조회하는 리포지토리로, 현재는 MemoryMemberRepository로 구현됨.
  • join(Member member):
    → 회원 가입 로직을 담당.
    → 내부적으로 중복 회원 검증을 먼저 수행한 후, 검증을 통과하면 저장.
  • validateDuplicatemember(Member member):
    → 저장된 회원 중 같은 이름이 있는지 확인.
    → 존재할 경우 IllegalStateException 예외 발생

5. 회원 서비스 테스트

package hello.hello_spring.service;

import hello.hello_spring.domain.Member;
import hello.hello_spring.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
    public void 회원가입() throws Exception {
        //Given
        Member member = new Member();
        member.setName("hello");
        
        //When
        Long saveId = memberService.join(member);
        
        //Then
        Member findMember = memberRepository.findById(saveId).get();
        assertEquals(member.getName(), 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("이미 존재하는 회원입니다.");
    }
}