스프링 입문 강의 정리 #3

인프런 김영한 강사님의 '스프링 입문 - 코드로 배우는 스프링 부트, 웹 MVC, DB 접근 기술' 듣고 정리한 내용입니다.

 

[무료] 스프링 입문 - 코드로 배우는 스프링 부트, 웹 MVC, DB 접근 기술 - 인프런 | 강의

 

섹션 3. 회원 관리 예제 - 백엔드 개발

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

• 컨트롤러: 웹 MVC의 컨트롤러
• 서비스: 비지니스 로직 구현 (ex 회원은 중복 가입이 안된다)
• 리포지토리: 데이터베이스에 접근, 도메인 객체를 DB에 저장하고 관리
• 도메인: 비지니스 도메인 객체 (ex 회원, 주문, 쿠폰 등 DB에 저장되고 관리됨)

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

회원관리 예제

데이터: 회원ID, 이름

기능: 회원 등록 및 조회

시나리오

- 데이터 저장소가 선정되지 않아서 우선 인터페이스로 구현 클래스를 변경할 수 있도록 설계

- 가벼운 메모리 기반의 데이터 저장소 사용

클래스 의존관계

 

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

회원 객체 - Member.java

package com.example.hellospring.domain;

public class Member {

    private Long id; // 데이터를 구분하기 위한 시스템이 정하는 고객의 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.java

package com.example.hellospring.repository;

import com.example.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();
}

 

Optional이란?

Java8에 들어간 기능으로 NULL로 반환이 되는 값을 감싸주는 wrapper 클래스이다. Optional<T>를 사용하여 NPE가 발생하지 않도록 도와준다.

 

회원 리포지토리 메모리 구현체 - MemoryMemberRepository.java

package com.example.hellospring.repository;

import com.example.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;
    }

    // id로 회원을 찾는 메소드
    @Override
    public Optional<Member> findById(Long id) {
        return Optional.ofNullable(store.get(id));
    }

    // name으로 회원을 찾는 메소드
    @Override
    public Optional<Member> findByName(String name) {
        // 람다 사용 (loop를 돌려서 Map에 있는지 확인)
        return store.values().stream()
                .filter(member -> member.getName().equals(name))
                .findAny();
    }

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

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

 

HashMap이란?

Map 인터페이스에 속해있는 컬렉션으로 데이터가 키와 값으로 구성된 Entry 객체를 저장하는 자료구조이다.

 

Stream이란?

람다를 활용할 수 있는 기술 중 하나로 배열이나 컬렉션 인스턴스에 함수 여러 개를 조합하여 원하는 결과를 필터링하고 가공된 결과를 얻을 수 있다.

 

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

Java에서는 JUnit이라는 프레임워크로 테스트를 실행해서 문제 해결

 

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

MemoryMemberRepositoryTest.java

package com.example.hellospring.repository;

import com.example.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;

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();
        // 저장을 하게 되면 id가 세팅이 되기 때문
        // Optional에서 값을 꺼낼 때는 get을 사용!

        // 검증 방법: member로 저장한 것과 DB에서 꺼낸 것과 같으면 참
        Assertions.assertThat(member).isEqualTo(result);
    }

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

        Member member2 = new Member();
        member2.setName("spring2");
        repository.save(member2);

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

        Assertions.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();

        Assertions.assertThat(result.size()).isEqualTo(2);
    }

    // 테스트 메소드들은 순서와 상관없이 동작
}

 

@AfterEach

테스트 하나가 끝났을 때 데이터나 공용 저장소를 clear 해주기 위한 목적으로 테스트 메소드들이 하나씩 끝날 때마다 동작한다.

 

회원을 저장하는 메소드에서 검증 방법

[방법1]

System.out.println("result = " + (result == member));

[방법2] JUnit 사용

Assertions.assertEquals(member, result);

assertEquals(기대값, 실제값)

[방법3] Assertj 사용

Assertions.assertThat(member).isEqualTo(result);

 

4. 회원 서비스 개발

회원 서비스 - MemberService.java

package com.example.hellospring.service;

import com.example.hellospring.domain.Member;
import com.example.hellospring.repository.MemoryMemberRepository;

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

public class MemberService {

    private final MemberRepository MemorymemberRepository;

    // 회원가입 메소드
    public Long join(Member member) {
        // 비지니스 로직1: 같은 이름이 있는 중복 회원 X
        
        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();
    }

    // id로 회원을 찾는 메소드
    public Optional<Member> findOne(Long memberId) {
        return memberRepository.findById(memberId);
    }
}

회원가입 메소드에서 중복 회원 검증 방법

[방법1]

Optional<Member> result = memberRepository.findByName(member.getName());
result.ifPresent(m -> { // ifPresent: result가 null이 아니라 값이 있으면 밑의 로직이 동작
    throw new IllegalStateException("이미 존재하는 회원입니다.");
});

[방법2] 메소드로 만들기

validateDuplicateMember(member);

private void validateDuplicateMember(Member member) {
    memberRepository.findByName(member.getName())
                    .ifPresent(m -> {
                        throw new IllegalStateException("이미 존재하는 회원입니다.");
                    });
}

 

5. 회원 서비스 테스트

(기존) 회원 서비스가 회원 리포지토리 직접 생성

private final MemberRepository MemorymemberRepository;

(변경) 회원 서비스를 DI 가능하도록 변경

private final MemberRepository memberRepository;

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

▶️ DI 중 setter를 통한 주입 (생성자 주입)

 

회원 서비스 테스트 - MemberServiceTest.java

package com.example.hellospring.service;

import com.example.hellospring.domain.Member;
import com.example.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 java.util.Optional;

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

class MemberServiceTest {

    MemberService memberService;
    MemoryMemberRepository memoryMemberRepository;

    @BeforeEach
    public void beforeEach() {
        memoryMemberRepository = new MemoryMemberRepository();
        memberService = new MemberService(memoryMemberRepository);
    } // 같은 MemoryMemberRepository 사용

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

    @Test
    void 회원가입() {
        // given: 어떠한 상황이 주어졌을 때
        Member member = new Member();
        member.setName("hello");

        // when: 이것을 실행했을 때
        Long saveId = memberService.join(member);

        // then: 결과가 이것이 나온다!
        Member result = memberService.findOne(saveId).get();
        Assertions.assertThat(member.getName()).isEqualTo(result.getName());
    }

    @Test
    public void 중복_회원_예외() {
        // given
        Member member1 = new Member();
        member1.setName("spring1");

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

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

    @Test
    void findMembers() {
    }

    @Test
    void findOne() {
    }
}

 

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

➡️ 이렇게 실행하면 같은 테스트를 다른 Repository로 테스트 한 것

그럼 같은 인스턴스를 쓰도록 바꾸려면?

MemberService에 Constructor 생성

 

@BeforeEach

테스트 실행 전에 호출되는 것으로 테스트가 서로 영향을 끼치지 않도록 항상 새로운 객체를 생성하고 의존관계도 새롭게 맺어준다.