상품 관리 애플리케이션책의 상품 API와 기존 개인 과제를 DB에 연결합니다.
SPRING BOOT & AI교재 CH 11
데이터베이스 연동
SPRING BOOT & AI수업 내용
수업 내용
- 교재 CH 11을 함께 읽고 DB의 기본 용어를 확인합니다.
- product-api의 저장소를 메모리에서 DB로 바꿉니다.
- personal-project의 위시리스트를 DB에 저장합니다.
- 완료한 기능을 확인하고 구현 범위를 PR로 제출합니다.
SPRING BOOT & AI교재 CH 11
책에서 함께 읽을 부분
| 순서 | 교재의 내용 |
|---|---|
| 1 | 데이터베이스를 사용하는 웹 애플리케이션 |
| 2 | 데이터베이스 다뤄 보기 |
| 3·4 | 상품 추가 기능 구현하기 → 상품 조회/수정/삭제 구현하기 |
구체적인 코드 설명은 책을 보며 진행합니다. JDBC 방식으로 기존 프로젝트에 적용합니다.
SPRING BOOT & AIDB 기초
Java 객체·JSON·DB 행
| 형태 | 상품 하나를 표현하는 방법 |
|---|---|
| Java 객체 | Product 객체 · 실행 중인 Java 프로그램에서 사용 |
| JSON | {"id": 7, "name": "키보드", "price": 50000} · HTTP로 전달 |
| DB 행 | products 테이블의 id=7인 행 · 파일 DB에 저장한 기록 |
Repository가 DB 행을 읽어 Product로 복원하고, Controller가 응답 DTO를 반환합니다.
SPRING BOOT & AIDB 기초
테이블·행·열·기본 키
| 용어 | products 예시 |
|---|---|
| 테이블·행 | 상품을 모은 표 · 상품 한 개가 한 행 |
| 열 | id, name, price처럼 각 행에 저장할 항목 |
| 기본 키 · PK | id로 한 행을 식별 · 서로 다른 상품의 id는 중복할 수 없음 |
상품 이름이 같아도 서로 다른 행일 수 있습니다. 조회·수정·삭제는 id로 대상을 찾습니다.
SPRING BOOT & AIDB 기초
자료형과 NULL
| 값 | 설계에서 구분할 내용 |
|---|---|
| 정수·문자열 | id·price는 정수, name은 문자열 · Java와 DB 자료형을 맞추기 |
| NULL | 아직 값이 없다는 뜻 · 가격 0원이나 빈 문자열과 다름 |
| 제약 조건 | PK·NOT NULL·UNIQUE로 DB가 지켜야 할 규칙을 지정 |
가격 0은 정상 값입니다. 필수 가격의 NULL을 0으로 바꾸어 저장하지 않습니다.
SPRING BOOT & AIDB 기초
SQL 네 가지 작업
| SQL | 상품 API에서 하는 일 |
|---|---|
| INSERT · SELECT | 상품 행 추가 · 저장된 상품 조회 |
| UPDATE | 조건에 맞는 기존 행의 값 수정 |
| DELETE | 조건에 맞는 기존 행 삭제 |
UPDATE·DELETE는 id 조건을 지정합니다. 입력값은 SQL에 이어 붙이지 않고 바인딩합니다.
목록 순서는 ORDER BY로 명시합니다.
목록 순서는 ORDER BY로 명시합니다.
SPRING BOOT & AI저장 흐름
메모리 대신 DB에 저장
Controller·Service·DTO의 HTTP 계약은 유지하고 저장 구현을 교체합니다.
SPRING BOOT & AI실행 설정
앱 DB와 SQL 연습 DB 구분
| 용도 | H2 연결 URL |
|---|---|
| 책 상품 API | jdbc:h2:file:./data/products |
| 개인 위시리스트 | jdbc:h2:file:./data/wishlist |
| 독립 SQL 연습 | jdbc:h2:mem:db_basics · 종료하면 사라지는 연습용 |
Java 17·Spring Boot 4의 기존 설정을 유지합니다. JDBC·H2 설정은 책과 공식 문서를 확인합니다.
SPRING BOOT & AIDB 준비
재시작해도 같은 DB 사용
- 책의 테이블 SQL을 확인하고 CREATE TABLE IF NOT EXISTS 등으로 준비합니다.
- 동일한 파일 URL·작업 디렉터리로 앱을 종료한 뒤 다시 실행합니다.
- 시작할 때마다 DROP·TRUNCATE하거나 초기 데이터로 덮어쓰지 않습니다.
JPA의 ddl-auto는 JDBC 테이블을 자동 생성하는 설정이 아닙니다.
SPRING BOOT & AI식별자
DB가 만든 id를 사용
| 시점 | 구현할 동작 |
|---|---|
| 추가 | DB가 발급한 키를 읽어 생성 결과에 반영 |
| 조회 | 행을 Domain 객체로 복원할 때 저장된 id를 유지 |
| 수정·삭제 | 요청받은 기존 id로 처리 · 없는 id를 새 행으로 만들지 않음 |
DB 구현에서 AtomicLong이나 MAX(id)+1로 id를 만들지 않습니다.
SPRING BOOT & AIRepository
기존 인터페이스로 DB 구현 연결
- Repository 인터페이스의 저장·조회·수정·삭제 계약을 확인합니다.
- DB 구현이 SQL 결과를 Domain 객체로 바꾸도록 작성합니다.
- Service에 DB 구현을 생성자로 주입하고 사용할 빈 하나를 선택합니다.
Service에 SQL을 옮기거나 Controller에서 DB를 직접 다루지 않습니다.
SPRING BOOT & AI책 실습
상품 API를 DB에 연결
- CH 11의 상품 추가를 적용하고 DB가 발급한 id를 확인합니다.
- 조회·수정·삭제를 연결하고 기존 응답 상태·헤더·본문을 유지합니다.
- DB의 실제 행을 확인하고, 같은 설정으로 재시작해 동일한 id·값을 조회합니다.
기존 product-api/에서 구현합니다. 책의 코드를 읽은 뒤 직접 적용합니다.
SPRING BOOT & AI실패 처리
실패한 요청은 DB도 그대로
| 상황 | 지켜야 할 동작 |
|---|---|
| 잘못된 입력 | 기존 400 응답 · 저장 전에 규칙 검사 |
| 없는 id 수정·삭제 | 영향받은 행 수가 0이면 404 |
| 저장 중 실패 | 부분 저장 없이 기존 값과 행을 유지 |
HTTP 400을 반환했다는 이유만으로 DB 변경이 자동 취소되지는 않습니다.
SPRING BOOT & AI과제
과제
SPRING BOOT & AI필수 과제
기존 위시리스트를 DB에 저장
| 대상 | 유지하거나 저장할 내용 |
|---|---|
| 기본 필드 | id·name·price와 실제 구현한 기존 필드 |
| 외부 상품 정보 | source·externalId·category·image·stock 등 구현한 메타데이터 |
| 진행 순서 | 위시리스트 DB 연동 완료 → 기존 미완료 기능 이어서 구현 |
기존 personal-project/를 이어갑니다. 새 프로젝트나 JPA 전환은 요구하지 않습니다.
SPRING BOOT & AI필수 과제
기존 API와 추천 규칙 유지
- 가격 0·입력 검증·400·404 등 기존 API 동작을 유지합니다.
- 추천과 정렬의 동률이면 기존 등록 순서를 유지합니다.
- 목록 SQL에 ORDER BY를 명시하고 기존 테스트를 유지합니다.
테이블 구조·SQL·등록 순서 보존 방법을 직접 정해 README에 기록합니다.
SPRING BOOT & AI필수 과제
외부 상품 식별자와 중복 처리
| 항목 | 요구사항 |
|---|---|
| 식별자 | 내 로컬 id와 외부 source·externalId 구분 유지 |
| 중복 방지 | 외부 식별자 조합에 DB UNIQUE 제약 · 충돌은 409로 변환 |
| 외부 요청 실패 | 불완전한 외부 값을 저장하지 않고 기존 DB 유지 |
수동 상품의 이름 중복은 허용합니다. 이름에 UNIQUE를 새로 걸지 않습니다.
외부 상품 이름·가격·메타데이터는 저장한 값을 복원하며 자동 갱신하지 않습니다.
외부 상품 이름·가격·메타데이터는 저장한 값을 복원하며 자동 갱신하지 않습니다.
SPRING BOOT & AI완료자 확장
장바구니도 DB에 저장
| 저장할 값 | 유지할 규칙 |
|---|---|
| 장바구니 행 | 행 id·원본 로컬 id·수량을 보존 |
| 상품 복사본 | 처음 담은 이름·단가·재고를 별도 보존 |
| 원본 변경·삭제 | 원본 삭제를 막거나 장바구니를 함께 삭제하지 않도록 FK 설계 |
쿠폰 선택과 금액 미리보기는 저장 상태로 추가하지 않습니다. 기존 계산 규칙을 유지합니다.
SPRING BOOT & AI저장 단위
여러 쓰기는 함께 성공하거나 취소
- 하나의 요청에서 두 번 이상 저장하는 부분이 있는지 찾습니다.
- 중간 저장이 실패해도 일부 결과만 남지 않게 처리합니다.
- 트랜잭션이 필요한 범위를 책과 함께 확인하고 README에 설명합니다.
트랜잭션은 여러 DB 변경을 하나의 작업 단위로 묶는 방법입니다.
SPRING BOOT & AIQA·테스트
직접 확인할 항목 작성
| 확인 방법 | 남길 결과 |
|---|---|
| 수동 QA | 본인이 정상·실패·재시작 항목을 정하고 실제 결과 기록 |
| Repository 통합 테스트 | 별도 테스트 DB에서 SQL·객체 복원·실패 보존 확인 |
| 기존 단위 테스트 | 기존 검증·추천·쿠폰 계산 테스트 유지 |
테스트에서 앱의 파일 DB를 삭제하거나 초기화하지 않습니다.
SPRING BOOT & AI설계 확인
적용한 내용을 설명하기
- HTTP·Service·Repository의 책임과 인터페이스를 유지했는가?
- DB id와 행의 자료형·NULL·중복 제약을 설명할 수 있는가?
- 기존 규칙과 실패 시 데이터 보존을 확인했는가?
- 같은 DB로 재시작한 결과와 실제 완료 범위를 기록했는가?
SPRING BOOT & AIGitHub 제출
DB 연동 결과 제출
| 항목 | 제출할 내용 |
|---|---|
| Issue·PR 제목 | [11/12][이름] 기존 과제 DB 연동 |
| README | 테이블·SQL·실행 설정·QA·테스트·완료/미완료 범위 |
| PR 본문 | 책 실습과 개인 과제의 실제 변경 범위 · 이전 PR 링크 |
개인 Fork에 Push → 공용 sesac-spring-boot-study에 Issue 1개·PR 1개.
이전 구현에서 자율 브랜치로 시작하고 리뷰 수정도 같은 브랜치에 Push합니다.
이전 구현에서 자율 브랜치로 시작하고 리뷰 수정도 같은 브랜치에 Push합니다.
SPRING BOOT & AI다음 수업
14일 · 단축 URL·주문 API·JPA
- 오전 3시간 · 단축 URL 과제 테스트를 직접 풀이합니다.
- 오후 3시간 · 주문 관리 API 과제 테스트를 직접 풀이합니다.
- 마지막 1~2시간 · ORM·JPA·Spring Data JPA·영속성 컨텍스트를 소개합니다.
SPRING BOOT & AI읽기와 참고
교재와 공식 문서
아래 파일은 기존 HTTP 검증·예외 처리 보충 코드입니다. DB 구현 완성 답안이 아닙니다.