📚 [Spring] 프로젝트 고도화

📕 페이징/페이지네이션

페이징 처리는 한 번에 모든 데이터를 가져오면 많은 시간이 걸리기 때문에 단위를 나눠서 데이터를 가져올 수 있도록 단편화시키는 것을 의미한다
페이지네이션이란 여러개의 컨텐츠를 여러 페이지로 나누고 페이지 번호 버튼, 이전 버튼, 다음 버튼을 눌러서 페이지를 이동하는 기능이다

스프링에서 페이지네이션은 사용자가 직접 구현해서 사용할 수 있고, Spring에서 제공하는 Pageable을 사용할 수도 있다

📖 Pageable 인터페이스

Spring Data JPA에서 페이징 처리를 위해 제공하는 인터페이스로 페이지 크기(size), 페이지 번호(page), 정렬(sort) 방식을 설정할 수 있다
클라이언트로부터의 페이지 요청을 담당하는 Pageable 객체는 PageRequest.of(page, size, sort) 메서드를 통해 생성할 수 있으며, 이 객체는 Spring Data JPA 리포지토리 메서드에 전달된다

🎈 변수
size : 한 페이지당 담길 데이터의 양 ex) 10, 5, ...
page : size를 기준으로 몇번째 페이지인지? ex) 0, 1, ...
sort : 무엇을 기준으로 정렬할 것인지? ex) createdAt,DESC, description
이것을 기준으로 요청 URL에 변수를 넘기면, 페이지네이션이 동작한다

🎈 Pageable 사용법

//Pageable 인스턴스 생성
PageRequest pageRequest = PageRequest.of(pageNum - 1, PAGE_POST_COUNT, Sort.by(Sort.Direction.DESC, "createdAt"));

📖 Page 인터페이스

Spring Data JPA에서 페이징된 결과를 담는 인터페이스로, 페이징된 데이터와 페이징 정보(총 페이지 수, 현재 페이지 등)를 제공한다

🎈 Page 사용법

Page<BoardEntity> page = boardRepository.findByTitleContaining(keyword, pageRequest);
List<BoardDto> boardDtoList = page.getContent(); // 페이징된 데이터 리스트
int totalPages = page.getTotalPages(); // 총 페이지 수

📙 단위 테스트

단위 테스트(Unit Test)는 하나의 모듈을 기준으로 독립적으로 진행되는 가장 작은 단위의 테스트

✔ 단위 테스트는 애플리케이션을 구성하는 하나의 기능이 올바르게 동작하는지를 독립적으로 테스트하는 것으로, "어떤 기능이 실행되면 어떤 결과가 나온다" 정도로 테스트를 진행한다

🎈 장점
◾ 테스팅에 대한 시간과 비용을 절감할 수 있다
◾ 새로운 기능 추가 시에 수시로 빠르게 테스트 할 수 있다
◾ 리팩토링 시에 안정성을 확보할 수 있다
◾ 코드에 대한 문서가 될 수 있다

✔ 실무에서는 단위 테스트를 선호하며, 요즘 많이 사용되는 TDD(Test-Driven Development, 테스트 주도 개발)에서 얘기하는 테스트도 단위 테스트를 의미한다
✔ 작성한 테스트 코드를 수시로 빠르게 돌리면서 문제를 파악할 수 있다

📖 통합 테스트(Integration Test)

모듈을 통합하는 과정에서 모듈 간의 호환성을 확인하기 위해 수행되는 테스트

✔ 독립적인 기능에 대한 테스트가 아니라 웹 페이지로부터 API를 호출하여 올바르게 동작하는 지를 확인하는 것

📒 빌드와 배포

📖 빌드

컴파일 된 코드를 실행할 수 있는 상태로 만드는 일

✔ 빌드 툴로는 Ant, Maven, Gradle 등이 있다

📖 애플리케이션 빌드

🎁 IntelliJ IDE를 이용한 빌드
✔ Spring Boot는 Gradle 빌드 툴을 이용해서 애플리케이션을 빌드할 수 있는 툴을 지원한다
✔ :build 또는 :bootJar 실행한다
✔ 빌드가 정상적으로 완료되면 build/libs 디렉토리에 Jar 파일이 생성된다
✔ 생성된 Jar 파일은 로컬에서 실행 가능한 애플리케이션 실행 파일이다

🎈 :build
assemble, :check 같이 Gradle에서 빌드를 위해 관련된 모든 task들을 실행시킨다. 그리고 실행 가능한 Jar 파일 이외에 plain Jar 파일 하나를 더 생성한다

🎈 :bootJar
빌드를 위해 관련된 모든 task들을 실행하는 것이 아니라, jar 파일을 생성하기 위한 task만 실행한다.

📖 배포

빌드가 완성된 실행 가능한 파일을 사용자가 접근할 수 있는 환경에 배치시키는 일

📖 애플리케이션 배포

🎁 전통적인 배포 방법
Spring Boot 기반의 Executable Jar 파일을 서버에 배포하는 가장 일반적인 방법은 scp와 같은 표준 유닉스 툴을 이용해서 서버로 간단히 전송하는 것이다. 서버로 전송된 jar 파일은 JVM이 설치된 환경이라면 어디서든 손쉽게 실행할 수 있다

🎁 클라우드 서비스를 위한 배포 방법
jar 파일은 클라우드 환경에도 손쉽게 배포할 수 있다

🎈 PaaS(Platform as a Service)
대표적인 PaaS 제공 회사인 Cloud Foundry에서 제공하는 cf command line 툴을 사용하면 jar 파일을 손쉽게 배포할 수 있다.

🎈 IaaS(Infrastructure as a Service)
jar 파일은 AWS Code Deploy, AWS Elastic Beanstalk, AWS Container Registry 같은 서비스를 이용해서 손쉽게 배포가 가능하다.
또한, Microsoft의 클라우드 서비스인 Azure와 Google Cloud 역시 여러가지 Executable Jar 파일 배포 기능을 제공한다.

🎁 CI / CD 플랫폼을 사용한 배포
Github Actions나 Circle CI, Jenkins 같은 CI/CD 플랫폼을 이용해 AWS나 Azure 같은 클라우드 서비스에 Executable Jar 파일을 자동 배포하도록 구성할 수 있다

📗 CI / CD - AWS

📖 CI

빌드/테스트 자동화 과정을 의미하는 용어로 개발자를 위한 자동화 프로세스이며, 지속적인 통합(Continuous Integration)을 의미한다
쉽게 GitHub에 특정 브랜치(master)에 새로운 커밋이 될 때 마다, 해당 코드를 바탕으로 빌드하고 사용자가 미리 만들어둔 테스트 코드를 실행하여 문제가 있는지 없는지를 체크하는 과정을 자동화 한것을 의미한다.

📖 CD

배포 자동화 과정을 의미하는 용어로 지속적 서비스 제공(Continuous Delivery) 또는 지속적 배포(Continuous Deployment)를 의미한다.
기존에는 빌드 후 문제가 없다고 판단되면, 실제 서버나 클라우드 환경에 합쳐진 코드(빌드된 상태의)를 올리는 과정을 거쳐 이를 배포한다고 한다. 그런데 CI(Continuous Integration) 과정을 통해 코드가 자동으로 통합되고 테스트가 완료된 이후, 배포까지 자동으로 실행하면 이를 CD라고 한다

📘 브랜치 전략 - 깃 플로우

브랜치 전략이란 여러 개발자가 하나의 저장소를 사용하는 환경에서 저장소를 효과적으로 활용하기 위한 work-flow로 브랜치 생성에 규칙을 만들어서 협업을 유연하게 하는 방법론이라 말할 수 있다

📖 git-flow 전략

✔ 기본적인 브랜치 이름 : feature > develop > release > hotfix > master
✔ 위 순서들은 왼쪽으로 갈수록 포괄적인 브랜치이며 master branch를 병합할 경우 그 왼쪽에 있는 hotfix 등 모든 브랜치에 있는 커밋들도 병합하도록 구성하게 된다
✔ 5가지 중, 항시 유지되는 메인 브랜치 master, develop 2가지와 merge 되면 사라지는 보조 브랜치 feature, release, hotfix 3가지로 구성된다

📖 git-flow 브랜치 구조

master : 라이브 서버에 제품으로 출시되는 브랜치
develop : 다음 출시 버전을 대비하여 개발하는 브랜치
feature : 추가 기능 개발 브랜치. develop 브랜치에 들어간다
release : 다음 버전 출시를 준비하는 브랜치. develop 브랜치를 release 브랜치로 옮긴 후 QA, 테스트를 진행하고 master 브랜치로 합친다
hotfix : master 브랜치에서 발생한 버그를 수정하는 브랜치

📚 참고자료

📖 단위 테스트와 통합 테스트
📖 빌드와 배포 방법
📖 빌드와 배포, CI/CD
📖 브랜치 전략