🚀 Spring Boot + JPA + RESTful API 핵심 정리

🏷 1️⃣ Entity 클래스

항목	설명
Entity	DB의 테이블 역할
Field	DB 컬럼 역할
기본 생성자	JPA 객체 생성 시 필수
@AllArgsConstructor	@Id @GeneratedValue 필드가 있으면 오류 발생
Lombok 활용	@NoArgsConstructor(force = true) + @RequiredArgsConstructor → 기본 생성자 + 필수 필드 생성

💡 Tip: final / @NonNull 필드가 있어도 force = true를 쓰면 JPA 기본 생성자를 만들 수 있습니다.

---

🔗 2️⃣ 테이블 관계 (Owner ↔ Car)

관계	설명
Owner(1) ↔ Car(N)	한 명의 소유자가 여러 대의 자동차를 소유
Car 클래스	@ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name="owner")
Owner 클래스	@OneToMany(cascade = CascadeType.ALL, mappedBy="owner")

🔹 Fetch 전략

• LAZY : 필요할 때만 로딩 → 성능 최적화
• EAGER : 조회 시 연관 데이터 즉시 로딩 → 간단하지만 무거움

---

🖼 3️⃣ JSON 직렬화

• 무한 반복 방지:

@JsonIgnoreProperties({"hibernateLazyInitializer","handler"})
@JsonIgnore // cars 필드

Owner ↔ Car 관계에서 JSON 변환 시 무한 루프 방지

---

💾 4️⃣ DB 변경 (H2 → MariaDB)

• build.gradle / application.properties 수정
• MariaDB 접속 정보 정의: URL, 계정, 비밀번호, 드라이버
• JPA ddl-auto: create-drop → 앱 재시작마다 테이블 초기화
• MariaDB 사용 시 데이터 영구 저장 가능

---

🌐 5️⃣ RESTful API

항목	설명
Controller	@RestController + HTTP 메서드 매핑
HTTP 메서드	GET → 조회, POST → 생성, PATCH/PUT → 수정, DELETE → 삭제
Repository	JpaRepository 통해 DB 접근
JSON 변환	Jackson 자동 처리
Owner ↔ Car	JSON 직렬화 시 무한 반복 방지 필요

---

⚡ 6️⃣ Spring Data REST

• Repository 기반 CRUD 자동 생성
• 엔드포인트 기본 규칙: Entity 이름 → 복수형 소문자 (/cars, /owners)
• 엔드포인트 변경 가능

@RepositoryRestResource(path="vehicles")

• HATEOAS 지원 → JSON에 링크 포함

• 쿼리 메서드 정의 가능

  • 예: /api/cars/search/findByBrand?brand=Kia

---

🛠 7️⃣ Postman 활용

항목	설명
요청 유형	GET / POST / PATCH / PUT / DELETE
PUT vs PATCH	PUT: 전체 key-value 필요, PATCH: 일부 key만 수정 가능
Owner 등록	PUT 요청 시 Content-Type = text/uri-list 설정 필요

---

💡 8️⃣ 핵심 요약

1. Entity 클래스 = DB 테이블 구조 + JPA 연동
2. 테이블 관계 = @ManyToOne / @OneToMany + Fetch 전략
3. JSON 직렬화 시 무한 반복 방지 필수
4. DB 변경 시 build.gradle / application.properties 수정
5. Controller + Repository = RESTful API 구현
6. Spring Data REST = CRUD 자동 제공 + HATEOAS 지원
7. Postman = API 요청/응답 확인 및 테스트 가능

---