[Spring] Spring 회원 관리 예제

2025-03-14 6 분 소요

[김영한 스프링 입문]을 듣고 정리한 글입니다.

1. 백엔드 개발

1.1 비즈니스 요구사항 정리

비즈니스 요구사항

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

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

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

클래스 의존관계

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

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

회원 객체

domain 패키지 생성 > Member 클래스 만들기

package hello.project.hello.domain;

import lombok.Getter;
import lombok.Setter;

@Getter @Setter
public class Member {
    private Long id;
    private String name;

    public Member(String name) {
        this.name = name;
    }

}

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

repository 패키지 생성 > MemberRepository 인터페이스 생성
MemberRepository는 회원 데이터를 저장하거나 조회하는데 필요한 메서드들의 설계도 역할을 한다.

package hello.project.hello.repository;

public interface MemberRepository {
    // 회원이 저장소에 저장
    Member save(Member member);

    // findById이나 findByName으로 찾아오기
    Optional<Member> findById(Long id);
    Optional<Member> findByName(String name);

    // 지금까지 저장된 모든 저장소 반환
    List<Member> findAll();
}

반환 타입	차이점	장점	단점
`Member findById(Long id);`	값이 없으면 `Optional.empty()` 또는 `Optional.ofNullable(value)` 반환	사용이 간단함	`NullPointerException` 발생 가능
`Optional<Member> findById(Long id);`	값이 없으면 `Optional.empty()` 반환	`null` 처리 안전	`Optional` 사용법을 알아야 함

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

repository > MemoryMemberRepository 클래스 생성
MemoryMemberRepository 클래스는 MemberRepository 인터페이스를 구현하여, 메모리 기반의 회원 저장소를 제공한다.

MemberRepository 더블 클릭 후, 오른쪽 마우스를 눌러 쉽게 Implement methods 생성 가능

package hello.project.hello.repository;

@Repository // 스프링 빈 등록
public class MemoryMemberRepository implements MemberRepository {
    /* 동시성 문제가 고려되어 있지 않음, 실무에서는 ConcurrentHashMap, AtomicLong 사용 고려 */
    private static final 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
    // Optional.ofNullable을 통해 null이 반환되도 사용 가능
    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());
    }

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

반환 방식	설명	예제
`Optional.empty()`	항상 빈 `Optional`을 반환	`return Optional.empty();`
`Optional.ofNullable(value)`	값이 `null`이면 `Optional.empty()` 반환, 값이 있으면 `Optional.of(value)` 반환	`return Optional.ofNullable(value);`

개념	설명
`stream()`	컬렉션(`List`, `Set`, `Map` 등) 데이터를 쉽게 필터링, 변환, 검색 가능
`.filter(조건)`	특정 조건에 맞는 값만 남김
`.findAny()`	조건을 만족하는 요소 중 아무거나 하나 반환
`.findFirst()`	조건을 만족하는 요소 중 첫 번째 값 반환 (순서 보장)

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

개발한 기능을 실행해서 테스트 할 때 자바의 main 메서드를 통해서 실행하거나, 웹 애플리케이션의 컨트롤러를 통해 서 해당 기능을 실행한다.
이러한 방법은 준비하고 실행하는데 오래 걸리고, 반복 실행하기 어렵고 여러 테스트를 한번에 실행하기 어렵다는 단점이 있다. 자바는 JUnit이라는 프레임워크로 테스트를 실행해서 이러한 문제를 해결한다.

(참고) Alt + Insert (Mac은 Cmd + N) 사용하면, 테스트 메서드를 자동으로 생성할 수 있다.

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

test > java > 생성한 프로젝트 하위에 repository 패키지 생성 > MemoryMemberRepositoryTest 클래스 생성
아래처럼 작성하면 위 MemoryMemberRepository에서 작성한 save 메서드가 실행된다.

package hello.project_hello.repository;

class MemoryMemberRepositroyTest {
     @Test
     public void save(){

     }
}

전체 코드

package hello.project.hello.repository;

public class MemoryMemberRepositoryTest {
    MemoryMemberRepository repository = new MemoryMemberRepository();

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

    @Test
    public void save() {
        Member member = new Member("시은");

        repository.save(member);
        Member result = repository.findById(member.getId()).get();
        // System.out.println("result = "+(result == member));
        Assertions.assertThat(member).isEqualTo(result);
    }

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

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

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

        Assertions.assertThat(result).isEqualTo(member1);
    }

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

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

        List<Member> result = repository.findAll();

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

.get()

Optional<T> 안에 저장된 값을 꺼내는 메서드이다.
일반 객체에서는 .get()을 사용할 수 없고, Optional을 사용해야 .get()을 호출할 수 있다.

@AfterEach

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

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

1.4 회원 서비스 개발

회원 Repository와 domain을 활용하여 비즈니스 로직을 작성해보자

hello.project.hello.service에 MemberService 클래스 생성

package hello.project.hello.service;


@Service // 스프링 빈 등록
public class MemberService {
    private final MemberRepository memberRepository;

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

    // 회원 가입
    public Long join(Member member){

        validateDuplicateMember(member);// 중복 회원 검증

        memberRepository.save(member);
        return member.getId();
    }


    // 같은 이름이 있는 중복 회원 x
    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);
    }
}

(참고) 생성자에 @Autowired를 사용하면 객체 생성 시점에 스프링 컨테이너에서 해당 스프링 빈을 찾아서 주입한다. 생성자가 1개만 있으면 @Autowired는 생략할 수 있다.

1.5 회원 서비스 테스트

Alt + Insert (Mac은 Cmd + N) 사용하면, 테스트 메서드를 자동으로 생성할 수 있다.

회원 서비스 테스트

test > java > service > MemberServiceTest

package hello.project.hello.service;

import static org.assertj.core.api.Assertions.assertThat;
import static org.junit.jupiter.api.Assertions.assertThrows;

class MemberServiceTest {

    MemberService memberService;
    MemoryMemberRepository memberRepository;

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

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

    @Test
    void 회원가입() {
        // given
        Member member = new Member("hello");

        // when
        Long saveId = memberService.join(member);

        // then
        Member findMember = memberService.findOne(saveId).get();
        assertThat(member.getName()).isEqualTo(findMember.getName());
    }

    @Test
    void 중복_회원_예외() {
        // given
        Member member1 = new Member("spring");
        Member member2 = new Member("spring");

        // when
        memberService.join(member1);
        IllegalStateException e = assertThrows(IllegalStateException.class, () -> memberService.join(member2));

        // then
        assertThat(e.getMessage()).isEqualTo("이미 존재하는 회원입니다.");
    }
}

@BeforeEach
- 각 테스트 실행 전에 호출된다. 테스트가 서로 영향이 없도록 항상 새로운 객체를 생성하고, 의존관계도 새로 맺어준다.
- 이렇게 하면 같은 memberRepository를 사용하게 된다.

2. 웹 MVC 개발

2.1 회원 웹 기능 - 홈 화면 추가

2.1.1 뷰 템플릿

templates > home.html 생성 후, 아래 코드 입력

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
  <body>
    <div class="container">
      <div>
        <h1>Hello Spring</h1>
        <p>회원 기능</p>
        <p>
          <a href="/members/new">회원 가입</a>
          <a href="/members">회원 목록</a>
        </p>
      </div>
    </div>
    <!-- /container -->
  </body>
</html>

2.1.2 컨트롤러

controller > HomeController 생성

package hello.hello_project.controller;

@Controller
public class HomeController {
    @GetMapping("/")
    public String home(){
        return "home";
    }
}

2.2 회원 웹 기능 - 등록

2.3.1 DTO(폼 객체) 생성

package hello.item_service.domain;

import lombok.Getter;
import lombok.Setter;

@Getter @Setter
public class Member {
    private Long id;
    private String name;

    public Member(String name) {
        this.name = name;
    }

    public Member() {

    }
}

2.3.2 뷰 템플릿

회원 등록 폼 HTML

resources/templates/members/createMemberForm.html

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
  <body>
    <div class="container">
      <form action="/members/new" method="post">
        <div class="form-group">
          <label for="name">이름</label>
          <input
            type="text"
            id="name"
            name="name"
            placeholder="이름을 입력하세요"
          />
        </div>
        <button type="submit">등록</button>
      </form>
    </div>
    <!-- /container -->
  </body>
</html>

2.3.3 컨트롤러

controller > MemberController

package hello.hello_project.controller;

@Controller
public class MemberController {

    private final MemberService memberService;

    @Autowired
    public MemberController(MemberService memberService){
        this.memberService = memberService;
    }

    @GetMapping("/members/new")
    public String createForm(){
        return "members/createMemberForm";
    }

    @PostMapping("/members/new")
    public String create(MemberForm form){
        Member member = new Member();
        member.setName(form.getName());

        memberService.join(member);

        return "redirect:/";
    }
}

3. 회원 웹 기능 - 조회

3.1.1 뷰 템플릿

resources/templates/members/memberList.html

회원 리스트

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
  <body>
    <div class="container">
      <div>
        <table>
          <thead>
            <tr>
              <th>#</th>
              <th>이름</th>
            </tr>
          </thead>
          <tbody>
            <tr th:each="member : ${members}">
              <td th:text="${member.id}"></td>
              <td th:text="${member.name}"></td>
            </tr>
          </tbody>
        </table>
      </div>
    </div>
  </body>
</html>

3.1.2 컨트롤러

package hello.hello_project.controller;

@Controller
public class MemberController {

    private final MemberService memberService;

    @Autowired
    public MemberController(MemberService memberService){
        this.memberService = memberService;
    }

    @GetMapping("/members/new")
    public String createForm(){
        return "members/createMemberForm";
    }

    @PostMapping("/members/new")
    public String create(MemberForm form){
        Member member = new Member();
        member.setName(form.getName());

        memberService.join(member);

        return "redirect:/";
    }

    // 아래 코드 추가
    @GetMapping("/members")
    public String list(Model model){
        List<Member> members = memberService.findMembers();
        model.addAttribute("members", members);
        return "members/memberList";
    }
}

메모리에 저장되어있기 때문에 서버 재시작시 데이터가 사라지게 된다.

박시은