[인프런]스프링 입문 - 코드로 배우는 스프링 부트, 웹 MVC, DB 접근 기술 강의 정리(1)

화나·2020년 11월 3일
Spring Framework강의정리인프런
0
post-thumbnail

이 게시글은 [인프런]스프링 입문 - 코드로 배우는 스프링 부트, 웹 MVC, DB 접근 기술 강의를 기반으로 작성되었으며 강의를 기억하기 위한 기록물입니다.
출처 : 인프런

1.프로젝트 환경설정

1-1. 프로젝트 생성

  • Gradle Project
  • Spring Boot : 2.3.4
  • Language : Java
  • Packaging : Jar
  • Java : 11
  • Dependencies : Spring Web, Thymeleaf
  • IDE : IntelliJ
  • 스프링 부트 스타터 사용하여 스프링 프로젝트 생성

1-2. 라이브러리 살펴보기

Gradle은 의존관계가 있는 라이브러리를 함께 다운로드한다

  • Spring Boot 라이브러리
    • spring-boot-starter-web
      • spring-boot-starter-tomcat: 톰캣 (웹서버)
      • spring-webmvc: 스프링 웹 MVC
    • spring-boot-starter-thymeleaf: 타임리프 템플릿 엔진(View)
    • spring-boot-starter(공통): 스프링 부트 + 스프링 코어 + 로깅
      • spring-boot
        - spring-core
      • spring-boot-starter-logging
        - logback, slf4j
  • 테스트 라이브러리
    • junit : 테스트 프레임워크
    • mockito : 목 라이브럴
    • assertj : 테스트코드를 좀 더 편하게 작성할 수 있도록 도와주는 라이브러리
    • spring-test : 스프링 통합 테스트 지원

1-3. View 환경설정

// hello > helloSpring > controller > HelloController
@Controller
public class HelloController {
    
 	@GetMapping("hello")
	public String hello(Model model) {
 		model.addAttribute("data", "hello!!");
		return "hello";
 	}
}
<!-- src > resources > templates > hello.html -->
<!DOCTYPE HTML>
<html xmlns:th="http://www.thymeleaf.org">
    <head>
      	<title>Hello</title>
      	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    </head>
    <body>
     	 <p th:text="'안녕하세요. ' + ${data}" >안녕하세요. 손님</p>
    </body>
</html>
  • thymeleaf 템플릿엔진 동작확인
    1. 웹브라우저가 /hello라는 경로를 요청하면 Spring Boot는 내장 톰캣 서버를 통해 스프링 컨테이너에서 해당 경로를 가진 컨트롤러를 찾는다.
    2. model에 데이터를 저장하고 컨트롤러에서 리턴값으로 문자값을 반환하면 viewResolver가 화면을 찾아서 처리한다.

2. 스프링 웹 개발 기초

2-1. 정적 컨텐츠

URL로 접속하면 서버가 파일을 브라우저로 바로 내려주는 방식
ex) welcome page

2-2. MVC와 템플릿 엔진

서버를 거쳐서 페이지를 변형한 뒤 브라우저로 전송하는 방식(뷰 반환)
controller : 비지니스 로직을 작성하는 등 내부의 작업에 집중해야함
view : 화면을 그리는데에 집중해야함

@Controller
public class HelloController {
 	@GetMapping("hello-mvc")
	public String helloMvc(@RequestParam("name") String name, Model model) {
		 model.addAttribute("name", name);
		 return "hello-template";
	}
}
<html xmlns:th="http://www.thymeleaf.org">
	<body>
		<p th:text="'hello ' + ${name}">hello! empty</p>
	</body>
</html>
  1. http://localhost:8080/hello-mvc?name=spring
  2. url에 있는 hello-mvc를 컨트롤러에서 찾아서 파라미터를 모델에 담은 뒤 view name을 리턴해준다.
  3. 템플릿 엔진은 모델에 담긴 파라미터 값을 찾아 화면에 반환한다.

2-3. API

반환값으로 JSON을 사용하여 클라이언트에게 데이터 전달(데이터 반환)
화면은 클라이언트가 알아서 그려야함

@Controller
public class HelloController {
 	@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 name;
	}
	public void setName(String name) {
 		this.name = name;
 	}
    }
}
  • @ResponseBody를 사용하고, 객체를 반환하면 객체가 JSON으로 변환됨
  • HTTP의 BODY부에 데이터를 직접 반환한다.
  • viewResolver 대신에 HttpMessageConverter가 동작한다.
    • 기본 문자처리 : StringHttpMessageConverter
    • 기본 객체처리 : MappingJackson2HttpMessageConverter

3. 회원 관리 예제

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

  • 간단한 예제를 통해 스프링의 전반적인 개념을 알기위한 강좌이므로 가장 단순한 비즈니스 요구사항을 전제로 한다.
  • 데이터 : 회원 아이디, 이름
  • 기능 : 회원 등록, 조회
  • 데이터 저장소가 선정되지 않은 가상의 시나리오
  • 일반적인 웹 애플리케이션 계층구조
    • 컨트롤러 : 웹 MVC의 컨트롤러 역할
    • 서비스 : 핵심 비즈니스 로직 구현
    • 리포지토리 : 데이터베이스에 접근, 도메인 객체를 DB에 저장하고 관리
    • 도메인 : 비즈니스 도메인 객체
  • 클래스 의존 관계
    • 아직 데이터 저장소가 선정되지 않아서, 인터페이스로 구현 클래스를 변경할 수 있도록 설계
    • 개발을 진행하기 위해서 초기 개발단계에서는 구현체로 가벼운 메모리 기반의 데이터 저장소 사용

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

//회원 도메인 객체
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;
     }
     
}
//회원 리포지토리 인터페이스
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();
 
}
//회원 리포지토리 메모리 구현체
package hello.hellospring.repository;
import hello.hellospring.domain.Member;
import java.util.*;

public class MemoryMemberRepository implements MemberRepository {
   //메모리 저장용 map
   private static Map<Long, Member> store = new HashMap<>();
   //ID값 생성을 위한 시퀀스
   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();
   }
   
   //저장소 초기화
   public void clearStore() {
   	store.clear();
   }
}

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

//회원 리포지토리 테스트케이스
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();
         //org.assertj.core.api
         assertThat(member).isEqualTo(result);
     }
     
     @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 : 하나의 메소드의 동작이 끝날 때마다 실행하게 되는 메소드, 여기에서는 저장소에 저장된 데이터를 삭제하는 역할을 한다.
    (한번에 여러개의 테스트를 진행하다보면 db에 직전 테스트 결과가 남아 있을 수 있는데, 이 결과는 다음 테스트에 영향을 줄 수도 있기 때문에 저장소 청소를 해줘야한다.)
  • 테스트 주도 개발 : 테스트 클래스를 먼저 작성한 뒤 구현 클래스를 작성할 수도 있다.(틀을 미리 작성하는 것)
  • given - when - then : 뭔가가 주어지면서(데이터) 이걸 실행했을때(검증 해야할 것) 결과가 이게 나와야함(검증하는 부분)

3-4. 회원 서비스 개발

package hello.hellospring.service;
import hello.hellospring.domain.Member;
import hello.hellospring.repository.MemberRepository;
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);
     }
}

3-5. 회원 서비스 테스트케이스 작성

package hello.hellospring.service;
import hello.hellospring.domain.Member;
import hello.hellospring.repository.MemoryMemberRepository;
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("이미 존재하는 회원입니다.");
     }
}
  • @BeforeEach : 각 테스트 실행전에 호출된다. 테스트가 서로 영향이 없도록하고 항상 새로운 객체를 생성한다.
profile
화나
이전 포스트

[JavaScript] Handlebars.js

다음 포스트

[인프런]스프링 입문 - 코드로 배우는 스프링 부트, 웹 MVC, DB 접근 기술 강의 정리(2)

0개의 댓글