본문 바로가기
WINK-(Web & App)/Spring Boot 스터디

[2025 겨울방학 스프링 스터디] 김재승 #1주차~2주차

kilometer0107 2025. 1. 20. 21:34
반응형

목차

  • 섹션2
    • 프로젝트 생성
    • 환경설정
  • 섹션3
    • 정적 컨텐츠
    • MVC와 템플릿 엔진
    • API
  • 섹션4
    • 회원 domain & repository 개발
    • 회원 repository test case 작성
    • 회원 서비스 개발
    • 회원 서비스 test case 작성

#섹션2

프로젝트 생성

1. Spring Initializr 접속

2. 최신 버전 설정 후 project Metadata에서 이름 설정하기

->단, 자바 17 이상이 깔려있어야함. 이미 깔려있는 자바가 있다면 Java파일을 찾아서 깔려있는 구 버전을 지우면 된다.

(경로 예시 : C:\Program Files\Java)

3. Dependancies에서 spring web과 Thymeleaf를 추가해준다.

4. Intellij에서 생성한 파일 안에 build.gradle 을 열어서 프로젝트를 생성해주면 된다.

환경설정

먼저 view 환경 설정을 해줄 것이다.

Spring에서 우리가 하고자하는 것은 web 애플리케이션을 구현하는 것이기에 당연히 만든 것을 업로드할 웹이 필요하다.

Welcome page를 만들어보자!

src -> main -> resources -> static에 index.html을 생성해준다. (확인은 localhost:8080에서 하면 된다)

<!DOCTYPE HTML>
<html>
<head>
 <title>Hello</title>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
</head>
<body>
Hello
<a href="/hello">hello</a>
</body>
</html>

 

이어서 src -> main-> java -> hello.hello_spring에 controller 패키지를 추가하고 내부에 HelloController 클래스를 생성해준다

@Controller
public class HelloController {
 @GetMapping("hello")
 public String hello(Model model) {
 model.addAttribute("data", "hello!!");
 return "hello";
 }
}

.

이 컨트롤러는 "/hello" URL로 GET 요청이 오면, "hello!!"라는 데이터를 모델에 추가하고, "hello"라는 이름의 뷰를 반환하여 사용자에게 결과를 보여주는 작업을 수행한다.

 

다음으로 resources ->templates에 hello.html을 만들어서 thymeleaf 템플릿엔진 동작을 통해 동적으로 내용을 생성하는 과정이다.

웹에서 localhost:8080/hello url을 내장 톰켓 서버에 보내면 스프링에 던져서 수행하도록 하고 맵핑 되어 있는 경우 viewResolver에 보내서 변환 작업 후 다시 웹에 던지는 과정이라고 보면 된다.

#섹션3

정적 컨텐츠

 

정적 컨텐츠란?
> 파일을 그대로 웹 브라우저에 전달해주는 것 (html)

웹 브라우저로 부터 내장톰켓 서버가 localhost:8080/hello-static.html 를 받고 먼저 스프링 컨테이너에서
관련 컨트롤러가 있는지 확인하고 없으면 그냥 resources에서 찾아서 있으면 그대로 반환하는 방식.

즉 컨트롤러에 맵핑이 되어있지 않은 경우에 해당

 

MVC와 템플릿 엔진

mvc와 템플릿 엔진이란?
> 뭔가 변환을 해서 웹 브라우저에 전달해주는 것 (html을 동적으로 프로그래밍한 후 전달)
(cf. mvc => model view controller를 의미함)

-Spring MVC는 Controller가 요청을 처리하고, 그 결과를 View에 전달하여 최종적으로 사용자에게 HTML을 반환하는 구조
-템플릿 엔진은 Controller가 전달한 모델 데이터를 HTML 템플릿에 동적으로 삽입하여 최종 HTML을 생성함

즉 컨트롤러에 맵핑이 되어있어 그걸 처리 후 view resolver에 던져서 뷰 리졸버가 최종 형태의 html로 다시 웹 브라우저에 던지는 방식이다.

 

API

API란?
> 웹 브라우저로부터 내장톰켓 서버가 localhost:8080/hello-api 를 받고 스프링에 던져서
컨트롤러가 맵핑되는 걸 확인 후 뷰 리졸버에 던지는 것이 아닌 

 

@ResponseBody가 붙어있기 때문에,

받은 것이 문자라면 Stirng converter를 작동시켜서 던지고 

객체라면 JSON 형식으로 바꿔서 웹 브라우저에 던지는 방식으로 진행된다. 
(cf.

1.해당 전환 작업을 하는 친구를 HttpMessageConverter 라고 부른다.

2.Json형식이란 >> 기존 html 등에서 사용되는 형식을 xml로 불렀지만 요새는 Json형식이 널리 사용되고 있다.

예시:

{
  "name": "홍길동",
  "age": 30,
  "isStudent": false,
  "hobbies": ["독서", "등산", "요리"],
  "address": {
    "city": "서울",
    "zipCode": "12345"
  },
  "phoneNumbers": [
    {
      "type": "집",
      "number": "02-1234-5678"
    },
    {
      "type": "휴대폰",
      "number": "010-9876-5432"
    }
  ]
}

 

#섹션4

일반적으로 웹 애플리케이션의 구조는 아래와 같다.

회원 domain & repository 개발

domain 패키지에 회원 객체를 생성해준다.

Member는 id와 name을 필드로 가진다.

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;
 }
}

 

이어서 회원 repository 인터페이스를 작성한 뒤 구현체를 작성한다.

//회원 repository interface
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.*;
/**
 * 동시성 문제가 고려되어 있지 않음, 실무에서는 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();
 }
 public void clearStore() {
 store.clear();
 }
}

 

회원 repository test case 작성

자바에서개발한 기능을 실행해 테스트해볼 때 JUnit이라는 프레임워크를 통해 테스트를 하곤 한다.

src/test/java에 MemoryMemberRepositoryTest 클래스를 만들어서 회원 repositroy memory 구현체를 테스트해볼 것이다.

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();
 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);
 }
}
  • aftereach 메서드를 통해 각 메서드가 실행되고 난 뒤 저장소를 비운다
  • save(): 회원 정보를 저장하고 findbyid 메서드를 통해 원래 member와 result에 save통해 저장된 id와 동일한 지 검증하는 과정을 통해 테스트한다
  • findByName(): result에 특정 이름을 findByName메서드를 통해 찾은 객체 정보를 저장하고 그 객체정보와 해당 정보를 실제로 갖고있는 객체와 동일한 지 비교하는 과정을 통해 테스트한다
  • findAll(): 두 회원을 저장하고 findAll메서드를 통해 모든 회원을 조회하고 크기가 2인지 비교하는 과정을 통해 테스트를 진행한다

회원 서비스 개발

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;
 
 public MemberService(MemberRepository memberRepository) {
 	this.memberRepository = memberRepository;
    }
    
 /**
 * 회원가입
 */
 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);
 }
}
  • join 메서드를 통해 회원가입을 진행하고 validateduplicateMember메서드를 통해 중복 회원 검증을 진행한다.
  • findMembers와 findOne을 통해 전체 회원 조회 및 특정 회원 조회를 가능하도록 구현했다.

회원 서비스 test case 작성

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)
  • 테스트 후 저장소를 비워 다음 테스트에 영향 주지 않도록 함(aftereach)
  • 회원가입 테스트 진행: 새 회원을 생성 후 가입 시키고 정상적으로 저장되었는지 확인(findMember메서드 이용)
  • 중복 회원 에외 테스트 진행: 동일한 이름의 회원을 두 번 가입시켜 예외 발생하는지 확인하기 (assertThrows&assertThat이용)
반응형
저작자표시 동일조건

'WINK-(Web & App) > Spring Boot 스터디' 카테고리의 다른 글

[2025 겨울방학 스프링 스터디] 정채은 #3주차  (1) 2025.01.26
[2025 겨울방학 스프링 스터디] 정채은 #2주차  (0) 2025.01.21
[2025 겨울방학 스프링 스터디] 윤아영 #2주차  (0) 2025.01.20
[2025 겨울방학 스프링 스터디] 정채은 #1주차  (1) 2025.01.14
[2025 겨울방학 스프링 스터디] 윤아영 #1주차  (0) 2025.01.13

'WINK-(Web & App)/Spring Boot 스터디' Related Articles

티스토리툴바