도메인 : 비즈니스 도메인 객체 (예) 회원, 주문, 쿠폰 등 주로 데이터베이스에 저장하고 관리 됨)
클래스 의존관계
MemberService -> MemberRepository (interface 로 생성, 가상 시나리오 상 아직 데이터 저장소가 선정되지 않았으므로)
MemberRepository 에 대한 구현체를 MemoryMemberRepository 로 생성.
- 아직 데이터베이스 저장소가 선정되지 않았으므로, 우선 인터페이스로 구현 클래스를 변경할 수 있도록 설계.
- 데이터 저장소는 RDB, NoSQL 등 다양한 저장소 고민중인 상황으로 가정.
- 개발을 진행하기 위해 초기 개발 단계는 구현체로 가벼운 메모리 기반의 데이터 저장소 사용.
## 회원도메인과 리포지토리 생성
회원 객체.
package hello.hellospring.domain;
public class Member {
private Long id;
private String name;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public Long getId() {
return id;
}
public void setId(Long id) {
this.id = id;
}
}
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));
}
@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());
}
}
## 회원 리포지토리 검증을 위한 테스트 케이스 작성.
테스트 시 main 메서드를 통해 실행하거나, 웹 애플리케이션 컨트롤러를 통해서 해당 기능을 실행하는 방법이 있는데, 해당 방법들은 준비 및 실행하는데 오래걸리고, 반복 실행하기 어렵고, 여러 테스트를 한 번에 실행하기 어려운 단점이 있다.
위의 문제들을 해결하기 위해 자바에서는 JUnit 이라는 프레임워크로 테스트를 실행하여 해결 함.
test 쪽에 main에 생성한 패키지와 동일한 패키지 생성.
그리고 테스트하고자하는 클래스의 동일한 클래스명 + test 붙여서 생성.
아래는 Assertions.assertEquals() 사용한 예.
package hello.hellospring.repository;
import hello.hellospring.domain.Member;
import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.Test;
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);
}
}
아래는 Assertions.assertThat() 사용한 예.
package hello.hellospring.repository;
import hello.hellospring.domain.Member;
import org.assertj.core.api.Assertions;
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();
@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);
//Assertions.assertThat(member).isEqualTo(result);
assertThat(member).isEqualTo(result);
}
@Test
public void findByName() {
Member member1 = new Member();
member1.setName("spring1");
repository.save(member1);
Member member2 = new Member(); // 변수 클릭 후 shift + f6 입력 시 rename.
member2.setName("spring2");
repository.save(member2);
Member result = repository.findByName("spring1").get();
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();
assertThat(result.size()).isEqualTo(2);
}
}
ctrl + enter 로 static import 시 아래와 같이 더욱 간편하게 사용가능.
// 기본
Assertions.assertThat(member).isEqualTo(result);
// static import 시.
assertThat(member).isEqualTo(result);
테스트 코드 작성 후 실행하여, 실행창 쪽 보고 성공/실패 여부 파악.
위에서 작성한 코드를 이용하여 클래스 테스트 실행 시 오류 발생, 이를 해결하기 위해 아래와 같이 테스트 끝날때 마다 repository를 지워주는 코드를 추가해주면 됨. (@AfterEach 사용 -> 콜백메서드와 같음)
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));
}
@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());
}
// AfterEach 에서 사용할 클리어 추가.
public void clearStore() {
store.clear();
}
}
package hello.hellospring.repository;
import hello.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;
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() {
Member member = new Member();
member.setName("Spring");
repository.save(member);
Member result = repository.findById(member.getId()).get();
//Assertions.assertEquals(member, result);
//Assertions.assertThat(member).isEqualTo(result);
assertThat(member).isEqualTo(result);
}
@Test
public void findByName() {
Member member1 = new Member();
member1.setName("spring1");
repository.save(member1);
Member member2 = new Member(); // 변수 클릭 후 shift + f6 입력 시 rename.
member2.setName("spring2");
repository.save(member2);
Member result = repository.findByName("spring1").get();
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();
assertThat(result.size()).isEqualTo(2);
}
}
## 회원 서비스 개발
package hello.hellospring.service;
import hello.hellospring.domain.Member;
import hello.hellospring.repository.MemberRepository;
import hello.hellospring.repository.MemoryMemberRepository;
import java.util.List;
import java.util.Optional;
public class MemberService {
private final MemberRepository memberRepository = new MemoryMemberRepository();
/*
* 회원가입
* */
public Long Join(Member member) {
// 동일 이름 중복회원 방지
//Optional<Member> result = memberRepository.findByName(member.getName());
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);
}
}
## 회원 서비스 테스트 케이스 작성.
기존에는 test 에 직접 클래스 생성하여 진행 했는데, 단축키를 이용하면 손 쉽게 test 관련 로직 생성 가능.
해당하는 클래스에서 Ctrl + Shift + T 클릭하여 Create New Test 생성.
테스트 코드의 경우 한글로 작성해서 무방하다.
package hello.hellospring.service;
import hello.hellospring.domain.Member;
import hello.hellospring.repository.MemberRepository;
import hello.hellospring.repository.MemoryMemberRepository;
import java.util.List;
import java.util.Optional;
public class MemberService {
private final MemberRepository memberRepository;
public MemberService(MemberRepository memberRepository) {
this.memberRepository = memberRepository;
}
/*
* 회원가입
* */
public Long join(Member member) {
// 동일 이름 중복회원 방지
//Optional<Member> result = memberRepository.findByName(member.getName());
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);
}
}
package hello.hellospring.service;
import hello.hellospring.domain.Member;
import hello.hellospring.repository.MemoryMemberRepository;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;
import static org.assertj.core.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
void 회원가입() {
// given
Member member = new Member();
member.setName("hello");
// when
Long saveId = memberService.join(member);
// then
Member findMember = memberService.findOne(saveId).get();
assertThat(member.getName()).isEqualTo(findMember.getName());
}
@Test
public void 중복_회원_예외() {
// 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("이미 존재하는 회원입니다.");
/*
try {
memberService.join(member2);
fail();
} catch (IllegalStateException e) {
assertThat(e.getMessage()).isEqualTo("이미 존재하는 회원 입니다.");
}
*/
// then
}
@Test
void findMembers() {
}
@Test
void findOne() {
}
}
@Responsebody 문자 반환 : 뷰 리졸버(viewResolver)를 사용하지 않음, 대신 HTTP의 BODY에 문자 내용을 직접 반환.(HTML TAG를 말하는것 아님)
@Controller
public class HelloController {
@GetMapping("hello-string")
@ResponseBody // 응답 바디에 직접 넣어주겠다는 것.
public String helloString(@RequestParam("name") String name) {
return "hello " + name;
}
}
@Responsebody 객체 반환 : 객체를 반환하면 객체가 JSON 형식으로 변환 됨.
package hello.hellospring.controller;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;
@Controller
public class HelloController {
@GetMapping("hello")
public String hello(Model model) {
model.addAttribute("data", "hello!!");
return "hello";
}
@GetMapping("hello-mvc")
public String helloMvc(@RequestParam("name") String name, Model model) {
model.addAttribute("name", name);
return "hello-template";
}
@GetMapping("hello-string")
@ResponseBody // 응답 바디에 직접 넣어주겠다는 것.
public String helloString(@RequestParam("name") String name) {
return "hello " + name;
}
@GetMapping("hello-api")
@ResponseBody
public Hello helloApi(@RequestParam("name") String name) {
Hello hello = new Hello();
hello.setName(name);
return hello;
}
static class Hello {
private String name;
public String getName() {
return this.name;
}
public void setName(String name) {
this.name = name;
}
}
}
출력결과 (JSON : key-value)
{"name":"\"호랑이\""}
@ResponseBody 사용 시
HTTP의 BODY에 문자 내용을 직접 반환
viewResolver 대신 HttpMessageConverter가 동작.
기본 문자처리 : StringHttpMessageConverter
기본 객체처리 : MappingJackson2HttpMessageConverter
(Jackson : JSON 으로 바꿔는 라이브러리 중 하나, 스프링은 기본적으로 Jackson 탑재, 구글의 Gson도 존재함.)
byte 처리 등등 기타 여러 HttpMessageConverter가 기본적으로 등록되어 있다.
클라이언트의 HTTP Accept 헤더와 서버의 컨트롤러 반환 타입 정보 둘을 조합해서 HttpMessageConverter가 선택됨.