📌 JPA 연관관계 매핑 실습 정리

📅 날짜

2025년 5월 7일

📝 학습 내용

1️⃣ 연관관계 기본 개념

✅ 객체 vs 테이블 간 차이

• 객체 지향 세계: 객체 참조 (예: Member → Team)
• 관계형 DB 세계: 외래 키 사용 (예: member.team_id → team.id)
• JPA는 객체의 참조와 외래 키를 연결해주는 ORM 도구

---

2️⃣ 연관관계 종류

관계 종류	설명
ManyToOne	가장 흔한 관계. 다수의 엔티티가 하나를 참조
OneToMany	실무에서 잘 사용되지 않음. 추가적 설정 필요
OneToOne	거의 사용되지 않음. 특정 상황에서만 활용
ManyToMany	비추천. 별도 엔티티로 풀어내는 것이 일반적

---

3️⃣ 단방향 vs 양방향

• 단방향: 한 쪽만 참조 → 설정 간단하지만, 조회 제약
• 양방향: 양쪽 모두 참조 가능
  → mappedBy를 이용해 연관관계의 주인(Owner) 을 설정
  → 실제 외래 키는 주인 엔티티에서 관리됨

❗ 왜 연관관계의 주인을 정해야 할까?

양방향 관계에서는 두 객체가 서로를 참조하지만,

DB에 외래 키는 하나만 존재하므로 JPA에게 어떤 쪽이 관리 주체인지 알려줘야

SQL 생성 및 동기화에 혼란이 없습니다.

---

4️⃣ 실무 팁: @OneToMany 사용 시 주의

• 외래 키를 상대 테이블에서 관리하므로 insert/update 시 복잡해질 수 있음
• mappedBy 설정과 cascade, orphanRemoval 등의 옵션 조합에 주의 필요
• 단방향보다 양방향 + 명확한 주인 설정이 실무에서 더 안정적

---

🧩 실습 코드

✅ Lend 엔티티 (양방향 다대일 연관관계 설정)

package com.example.demo.domain.entity;

import jakarta.persistence.*;
import lombok.*;

@Entity
@Table(name="lend")
@Data
@NoArgsConstructor
@AllArgsConstructor
@Builder
public class Lend {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @ManyToOne
    @JoinColumn(name="bookcode", foreignKey = @ForeignKey(name="FK_LEND_BOOK",
            foreignKeyDefinition = "FOREIGN KEY(bookcode) REFERENCES book(bookcode) ON DELETE CASCADE ON UPDATE CASCADE"))
    private Book book;

    @ManyToOne
    @JoinColumn(name="username", foreignKey = @ForeignKey(name="FK_LEND_USER",
            foreignKeyDefinition = "FOREIGN KEY(username) REFERENCES user(username) ON DELETE CASCADE ON UPDATE CASCADE"))
    private User user;
}

---

✅ LendRepository (Spring Data JPA)

package com.example.demo.domain.repository;

import com.example.demo.domain.entity.Lend;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

@Repository
public interface LendRepository extends JpaRepository<Lend, Long> {

}

---

✅ LendRepositoryTest (CRUD 테스트)

package com.example.demo.domain.repository;

import com.example.demo.domain.entity.Book;
import com.example.demo.domain.entity.Lend;
import com.example.demo.domain.entity.User;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;

@SpringBootTest
class LendRepositoryTest {

    @Autowired
    private LendRepository lendRepository;

    @Autowired
    private UserRepository userRepository;

    @Autowired
    private BookRepository bookRepository;

    @Test
    public void t1() throws Exception {
        Book book = bookRepository.findById(3333L).get();
        User user = userRepository.findById("user2").get();

        Lend lend = new Lend();
        lend.setBook(book);
        lend.setUser(user);
        lendRepository.save(lend); // INSERT
    }

    @Test
    public void t2() throws Exception {
        Lend lend = lendRepository.findById(1L).get();
        Book book = bookRepository.findById(4444L).get();
        lend.setBook(book);
        lendRepository.save(lend); // UPDATE
    }

    @Test
    public void t3() throws Exception {
        lendRepository.deleteById(1L); // DELETE
    }
}

---

🔥 정리

• @ManyToOne, @JoinColumn을 통해 외래 키 명시 및 제약 조건 설정
• 연관관계의 주인은 @JoinColumn이 선언된 쪽 → DB와의 싱크 주체
• Repository는 JpaRepository로 CRUD 자동 구현
• 테스트 클래스에서 삽입, 수정, 삭제의 전체 흐름을 확인
• 실무에서는 ManyToOne 위주로 사용, OneToMany는 보완적 사용이 일반적

---

🔗 참고 자료

• 인프런 김영한 JPA 강의
• 공식 문서: Hibernate ORM Docs
• Baeldung - JPA Relationships

---