enginner_s2eojeong

[자바 ORM 표준 JPA 프로그래밍] 05.연관관계 매핑 기초 본문

Backend/Database

[자바 ORM 표준 JPA 프로그래밍] 05.연관관계 매핑 기초

_danchu 2025. 4. 6. 21:52

목차

  • 객체와 테이블 연관관계 차이 이해하기
  • 객체의 참조 ↔ 테이블의 외래 키(FK) 매핑 방법
  • 방향 (단방향, 양방향), 다중성 (1:N, N:1, 1:1 등) 이해
  • 연관관계의 주인 개념 정리

1. 1 단방향 연관관계

테이블은 외래키(FK)로 조인을 해서 연관된 테이블을 찾지만, 객체는 참조를 통해서 연관된 객체를 찾는다.

객체 연관관계와 테이블 연관관계를 매핑 -> ORM 매핑을 해주어야 한다.

 

회원 & 팀 Class

@Entity
public class Member {

    @Id
    @GeneratedValue
    @Column(name = "MEMBER_ID")
    private Long id;

    @Column(name = "USERNAME")
    private String username;

    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "TEAM_ID")
    private Team team;
  
  // Getter, Setter
}

@Entity
public class Team {

    @Id
    @GeneratedValue
    @Column(name = "TEAM_ID")
    private Long id;

    private String name;
  
  // Getter, Setter
  }

JoinColumn name: Team과 Member를 조인하는 컬럼명을 적어주기

 

연관관계 저장

//팀 저장
Team team = new Team();
team.setName("TeamA");
em.persist(team);

//회원 저장
Member member = new Member();
 member.setName("member1");
member.setTeam(team); //단방향 연관관계 설정, 참조 저장
em.persist(member);

 

참조로 연관관계 조회하기

//조회
Member findMember = em.find(Member.class, member.getId());

//참조를 사용해서 연관관계 조회
Team findTeam = findMember.getTeam();

 

연관관계 수정

// 새로운 팀B
Team teamB = new Team();
teamB.setName("TeamB");
em.persist(teamB);

// 회원1에 새로운 팀B 설정
member.setTeam(teamB);

 

2.1 양방향 연관관계

더보기

‼️기존 단방향 매핑의 문제점: 객체에서 Member->Team 조회는 가능하지만, Team->Member 조회는 불가.

List members 를 넣어줘야 양방향이 가능해짐

 

@Entity
public class Team {

    @Id
    @GeneratedValue
    @Column(name = "TEAM_ID")
    private Long id;

    private String name;
    
    @OneToMany(mappedBy = "team")
    private List<Member> members = new ArrayList<>();
    
    //Getter, Setter...
 }

 

2.2 연관관계 주인 (mappedBy)

객체 연관관계 = 2개

  • 회원->팀 (단방향)
  • 팀->회원 (단방향)

테이블 연관관계 = 1개

  • 회원<->팀 (양방향)

객체의 양방향 관계는 사실 양방향 관계가 아니라 서로 다른 단뱡향 관계 2개이다.

따라서 객체를 양방향으로 참조하려면 단방향 연관관계를 2개 만들면 된다.

 

테이블에서는 외래 키 하나로 두 테이블의 연관관계를 관리한다.

즉, MEMBER.TEAM_ID 외래 키 1개로 양방향 연관관계 가진다.
 (양쪽으로 조인할 수 있음)

SELECT *
FROM MEMBER M
JOIN TEAM T ON M.TEAM_ID = T.TEAM_ID

SELECT *
FROM TEAM T
JOIN MEMBER M ON T.TEAM_ID = M.TEAM_ID

 

더보기

⁉️ Q. 어느 member가 team을 바꾸려고 할 때, Member 안에 있는 Team을 바꾸어야할지, Team 안에 있는 members(List)를 바꾸어야 할지 딜레마가 생긴다.

🙋‍♀️ A. 둘 중 하나로 외래키를 관리한다. (연관관계의 주인 정하기)

 

양방향 매핑 규칙

  • 객체의 두 관계중 하나를 연관관계의 주인으로 지정
  • 연관관계의 주인만이 외래 키를 관리(등록, 수정)
  • 주인이 아닌쪽은 읽기만 가능
  • 주인은 mappedBy 속성 사용X
  • 주인이 아니면 mappedBy 속성으로 주인 지정

연관관계 주인

  • 외래 키가 있는 있는 곳이 주인
  • 여기서는 Member.team이 연관관계의 주인
  • 연관관계의 주인이 되는 엔티티만이 연관관계를 수정(등록, 변경) 할 수 있다.

2.3 양방향 매핑 시 주의사항

⚠️ 주의할 점 1

Team 엔티티에서 members.add(member)만 하고 member.setTeam(team)을 하지 않으면 외래 키가 갱신되지 않는다.

즉, 주인이 아닌 쪽에서만 수정하면 DB에 반영되지 않음.

Team team = new Team();
team.setName("TeamA");
em.persist(team);

Member member = new Member();
member.setName("member1");


//역방향(주인이 아닌 방향)만 연관관계 설정
team.getMembers().add(member);

em.persist(member);

 

결론: 양방향 매핑시 연관관계의 주인에 값을 입력해야 한다. ‼️

Team team = new Team();
team.setName("TeamA");
 
em.persist(team);



Member member = new Member();
 
member.setName("member1");



team.getMembers().add(member); //연관관계의 주인에 값 설정
member.setTeam(team);

em.persist(member);

 

 

또한 순수 객체 상태를 고려해서 항상 양쪽에 값을 설정해야 한다.

이를 위해 연관관계 편의 메소드를 생성하는 것이 권장된다. (둘 중 한곳에만. 최악의 경우 무한루프에 걸릴 수 있음.)

@Entity
public class Member {
   .
   .
   .
    public void setTeam(Team team) {
        this.team = team;
        team.getMembers().add(this);
    }
}

 

양방향 매핑시에 무한 루프를 조심해야한다. (둘 중 한곳에만. 최악의 경우 무한루프에 걸릴 수 있음.)

  • 예: toString(), lombok, JSON 생성 라이브러리

3. 정리

양방향 매핑 정리

  • 단방향 매핑만으로도 이미 연관관계 매핑은 완료된 것임.
  • 양방향 매핑은 반대 방향으로 조회.
  • JPQL에서 역방향으로 탐색할 일이 많음.
  • 단방향 매핑을 잘 하고 양방향은 필요할 때 추가해도 됨.
 (테이블에 영향을 주지 않음)

연관관계의 주인을 정하는 기준

  • 비즈니스 로직을 기준으로 연관관계의 주인을 선택하면 안됨.
  • 연관관계의 주인은 외래 키의 위치를 기준으로 정해야 함.