Spring Boot 기반 백엔드 강의 프로젝트입니다. 쇼핑몰(유저 기능 + 네이버 쇼핑 정보)을 단계별로 만들어갑니다.
- Java 21
- Spring Boot 4.0.2
- Gradle
./gradlew bootRun서버 실행 후 http://localhost:8080 으로 접속
- 유저 기능 (회원가입, 로그인, 조회)
- 네이버 쇼핑 API 연동 (상품 검색, 상품 정보 조회)
- branch:
main - Spring Boot 프로젝트 생성 및 Gradle 설정
- branch:
web/start spring-boot-starter-web의존성 추가
- branch:
web/get UserController- REST API JSON 응답GET /users/hello: 단순 문자열 응답GET /users: 유저 목록 조회GET /users/{id}: PathVariableGET /users/search?name=: RequestParamGET /users/page?page=0&size=10: RequestParam 기본값 + 페이징GET /users/me: RequestHeader (Authorization)GET /users/{id}/detail: ResponseEntity 상태코드 제어
UserPageController- HTML 응답 비교GET /pages/users: HTML / JSON content negotiationGET /pages/users/{id}: HTML 상세 페이지
- branch:
web/post - 인메모리 유저 저장소로 CRUD 동작 확인
UserController확장POST /users: RequestBody 로 유저 생성 (201 Created)PUT /users/{id}: 유저 정보 전체 수정DELETE /users/{id}: 유저 삭제 (204 No Content)
- branch:
web/swagger springdoc-openapi-starter-webmvc-ui의존성 추가- Swagger 애노테이션 적용
@Tag: 컨트롤러 그룹 이름@Operation: API 설명 (summary, description)@Parameter: 파라미터 설명@ApiResponse/@ApiResponses: 응답 상태코드 설명
- Swagger UI: http://localhost:8080/swagger-ui/index.html
- OpenAPI JSON: http://localhost:8080/v3/api-docs
- branch:
web/exception - 커스텀 예외 클래스
UserNotFoundException: 유저 조회 실패 시 (→ 404)InvalidRequestException: 잘못된 요청 시 (→ 400)
ErrorResponserecord : 통일된 에러 응답 형식 (status, error, message, timestamp)GlobalExceptionHandler(@RestControllerAdvice)@ExceptionHandler로 예외 타입별 응답 분기- 컨트롤러에서
null반환 /ResponseEntity분기 → 예외 던지기로 변경
- Before vs After 비교
- Before:
return ResponseEntity.notFound().build() - After:
throw new UserNotFoundException(id)→ GlobalExceptionHandler 가 처리
- Before:
- branch:
web/logging logback-spring.xml설정- Console Appender : 터미널 출력 (컬러 하이라이트)
- File Appender :
./logs/application.log파일 저장 - Rolling File Appender : 날짜 + 크기 기반 롤링 (
10MB,30일,1GB)
- 로그 레벨 사용 예시
log.debug(): 상세 디버깅 정보 (단건 조회 파라미터)log.info(): 주요 비즈니스 이벤트 (생성, 수정, 검색)log.warn(): 주의 필요한 이벤트 (삭제, 예외 발생)log.error(): 예상치 못한 에러 (스택 트레이스 포함)
- 패키지별 로그 레벨 분리
com.inspire12.backend→ DEBUGorg.springframework→ INFOorg.hibernate→ WARN
- branch:
web/profile - 프로필별 설정 파일 분리
application.properties: 공통 설정 +spring.profiles.active=devapplication-dev.properties: 개발 환경 (port 8080, DEBUG 로그)application-prod.properties: 운영 환경 (port 80, INFO/WARN 로그)
logback-spring.xml에서<springProfile>로 프로필별 Appender 분기- dev: 콘솔만, DEBUG
- prod: 콘솔 + 롤링 파일, WARN
SystemController: 현재 프로필 조회, 로그 레벨 테스트 API- 실행 방법:
./gradlew bootRun --args='--spring.profiles.active=prod'
- branch:
web/metric spring-boot-starter-actuator의존성 추가- Actuator 엔드포인트
/actuator/health: 헬스 체크 (커스텀 Health Indicator 포함)/actuator/metrics: 메트릭 목록/actuator/metrics/http.server.requests: HTTP 요청 메트릭/actuator/metrics/user.created.count: 커스텀 메트릭
- 프로필별 Actuator 노출 범위
- dev: 모든 엔드포인트 노출, health 상세 표시
- prod: health, info 만 노출
- 커스텀 구현
UserHealthIndicator: 커스텀 헬스 체크Counter(Micrometer) : 유저 생성 횟수 카운터
- branch:
layered/service-repository - Controller → Service → Repository 계층 분리
UserRepository(인터페이스) : 데이터 접근 계약 정의MemoryUserRepository(@Repository) : 인메모리 구현체 (ConcurrentHashMap)UserService(@Service) : 비즈니스 로직 (검증, 예외 처리, 로깅)UserController: HTTP 요청/응답만 담당 (얇은 계층)
- 각 계층의 역할
- Controller: 요청 파싱, 응답 생성, Swagger 문서화
- Service: 비즈니스 로직, 예외 던지기, 로깅
- Repository: 데이터 CRUD (저장소 추상화)
- branch:
layered/generic-repository CrudRepository<T, ID>제네릭 인터페이스 도입findAll,findById,save,deleteById,existsById,count- 어떤 엔티티든 기본 CRUD 를 제공하는 공통 인터페이스
UserRepository extends CrudRepository<User, Long>- 기본 CRUD 는 상속, 커스텀 메서드(
findByNameContaining)만 추가 선언
- 기본 CRUD 는 상속, 커스텀 메서드(
- 비교 포인트: 이 패턴이 Spring Data JPA 의
JpaRepository와 동일한 구조- 우리가 만든 것:
UserRepository extends CrudRepository<User, Long> - Spring Data JPA:
UserRepository extends JpaRepository<UserEntity, Long>
- 우리가 만든 것:
- branch:
layered/jpa spring-boot-starter-data-jpa+ SQLite JDBC + Hibernate Community Dialects 추가UserEntityJPA 엔티티 클래스 생성@Entity,@Table,@Id,@GeneratedValue- JPA Entity (class) vs DTO (record) 비교
UserRepository extends JpaRepository<UserEntity, Long>로 교체CrudRepository,MemoryUserRepository삭제 (Spring Data JPA 가 자동 구현)findByNameContaining쿼리 메서드 유지
UserService에 Entity ↔ DTO 변환 로직 추가@Transactional(readOnly = true)/@Transactional적용
data.sql로 초기 데이터 삽입- 비교 포인트:
- Before (이전 단계):
UserRepository extends CrudRepository<User, Long>+MemoryUserRepository직접 구현 - After (JPA):
UserRepository extends JpaRepository<UserEntity, Long>+ 구현체 자동 생성
- Before (이전 단계):
- branch:
shop/naver-api RestClient를 사용한 외부 API 호출- Spring 6.1+ 에서 도입된 동기 HTTP 클라이언트
RestTemplate의 후속, 더 간결한 API
- 네이버 쇼핑 검색 API (
https://openapi.naver.com/v1/search/shop.json)X-Naver-Client-Id,X-Naver-Client-Secret헤더 인증@Value로 설정값 주입, 환경변수 폴백 지원
- 새로운 파일 구조:
ShoppingController:GET /shop/search?query=키워드&display=10NaverShoppingService: RestClient 로 네이버 API 호출NaverShoppingResponse,ShoppingItem: 응답 DTO (record)
- branch:
shop/auth - 순수 Java 로 JWT 구현 (
JwtUtil유틸리티 클래스)- JWT 구조 이해:
header.payload.signature Base64URL인코딩 +HMAC-SHA256서명- 토큰 생성 (
generateToken), 검증 (validateToken), 파싱 (getUserIdFromToken)
- JWT 구조 이해:
POST /users/login: userId 로 JWT 토큰 발급GET /users/me개선: JWT 토큰 검증 → userId 추출 → 실제 유저 정보 반환- Before vs After 비교:
- Before: 토큰을 문자열로 그대로 반환 (인증 없음)
- After: JWT 서명 검증 + 만료 시간 체크 → 실제 유저 조회
- branch:
feature/pageable - Spring Data JPA 의
Pageable/Page<T>활용GET /users→Pageable파라미터 추가,Page<User>반환GET /users/search→Pageable파라미터 추가,Page<User>반환GET /users/page→ 수동 페이징 제거 (Pageable 로 대체)
- Before vs After 비교:
- Before:
stream().skip().limit()로 전체 데이터를 메모리에 로드 후 수동 페이징 - After: DB 레벨에서
LIMIT/OFFSET+COUNT쿼리 자동 생성
- Before:
- API 사용:
GET /users?page=0&size=10&sort=name,asc