[Spring 입문] 03. 회원 관리 예제 - 백엔드 개발(1)

Jiwoo Jung·2024년 10월 6일

김영한 Spring 입문

목록 보기
2/6
  1. 비즈니스 요구사항 정리
  2. 회원 도메인과 리포지토리 만들기
  3. 회원 리포지토리 테스트 케이스 작성

비즈니스 요구사항 정리

  • 데이터: 회원 id, 이름
  • 기능: 회원 등록, 조회
  • 아직 데이터 저장소가 선정되지 않은 시나리오

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

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

클래스 의존관계

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


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

회원 객체

src/main/java/hello/hellospring/domain/Member

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;
  }
}
  • Windows generate 단축키: Alt + Insert

회원 리포지토리 인터페이스

src/main/java/hello/hellospring/repository/MemberRepository

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();
}
  • 인터페이스 메서드의 기본 접근 지정자는 public abstract. 따라서 추상 메서드임

  • Optional: 자바 8부터 제공되는 null 처리 클래스
    전통적으로 자바는 값이 없을때 null을 반환했는데, Optional은 null 반환 대신 값을 안전하게 처리

    Optional<Member> result = memberRepository.findByName("John");
    
    if (result.isPresent()) {
        Member member = result.get();
        System.out.println(member.getName());
    } else {
        System.out.println("Member not found");
    }

    Optional 클래스의 메서드
    is.Present(): 값 있으면 true, 없으면 false 반환
    get(): 값이 존재하면 값 반환, 없으면 NoSuchElementException 던짐


회원 리포지토리 메모리 구현체

간단한 메모리 구현
src/main/java/hello/hellospring/repository/MemoryMemberRepository

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;
  
  @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 List<Member> findAll() {
    return new ArrayList<>(store.values());
  }
  
  @Override
  public Optional<Member> findByName(String name) {
    return store.values().stream()
    .filter(member -> member.getName().equals(name))
    .findAny();
  }

  // 테스트를 위한 메서드
  // 테스트 전후에 리포지토리 clear하기 위해
  public void clearStore() {
    store.clear();
  }
}
  • Map<Long, Member> : 제네릭 타입

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

자바의 JUnit 프레임워크 -> 테스트 용이

회원 리포지토리 메모리 구현체 테스트

src/test/java/hello/hellospring/repository
주로 같은 이름의 패키지를 만들어서 작성

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 {
	// clearStore()는 MemberRepository 인터페이스에 없는 메서드
    // 인터페이스 구현체인 MemoryMemberRepository 클래스에서 따로 정의된 함수인 clearStore()를 사용하기 위해 MemoryMemberRepository타입으로 선언
    MemoryMemberRepository repository = new MemoryMemberRepository();

	// @AfterEach 어노테이션
    // 모든 test이후 실행
    @AfterEach
    public void afterEach() {
        repository.clearStore();
    }
	
    // @Test 어노테이션
    // 테스트할 메서드 이름으로 정의
    // give-when-then 문법
    @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);
    }
}
  • 테스트 시 매번 System.out.println()으로 출력하기 불편함
    ->assertThat() 사용

    AssertJ 라이브러리 import
    import static.org.assertj.core.api.Assertions.*;

    assertThat 활용
    assertThat(테스트 타켓).메소드1().메소드2().메소드3();

  • @AfterEach : 한번에 여러 테스트를 실행하면 메모리 DB에 직전 테스트의 결과가 남을 수 있다. 이렇게 되면 다음 이전 테스트 때문에 다음 테스트가 실패할 가능성이 있다. @AfterEach 를 사용하면 각 테스트가 종료될 때 마다 이 기능을 실행한다. 여기서는 메모리 DB에 저장된 데이터를 삭제한다.

  • 테스트는 각각 독립적으로 실행되어야 한다. 테스트 순서에 의존관계가 있는 것은 좋은 테스트가 아니다.

0개의 댓글