[자바 ORM 표준] 연관관계 매핑 기초

May 27, 2022 3 분 소요

연관관계의 필요성

예제 모델링

객체를 테이블에 맞추어 모델링(연관관계X)

참조 대신에 외래키를 그대로 사용

@Entity
public class Member {

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

    @Column(name = "TEAM_ID")
    private Long teamId;

    private String username;
}

...

@Entity
public class Team {

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

    private String name;
}

외래 키 식별자를 직접 다룸

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

// 회원 저장
Member member = new Member();
member.setName("member1");
member.setTeamId(team.getId());
em.persist(member);

식별자로 다시 조회, 객체 지향적인 방법은 아니다.

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

// 연관관계X
Team findTeam = em.find(Team.class, findMember.getTeamId())

정리

객체를 테이블에 맞추어 데이터 중심으로 모델링하면 협력 관계를 만들 수 없다.

테이블은 외래 키로 조인을 사용해서 연관된 테이블을 찾는다.
객체는 참조를 사용해서 연관된 객체를 찾는다.
테이블과 객체 사이에는 큰 간격이 있다.

단방향 연관관계

객체 지향 모델링

객체 연관관계 사용

객체의 참조와 테이블의 외래 키를 매핑

@Entity
public class Member {

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

    private String username;

    // @Column(name = "TEAM_ID")
    // private Long teamId;

    @ManyToOne
    @JoinColumn(name = "TEAM_ID")
    private Team team;

}

(Team.class 생략...)

ORM 매핑

연관관계 저장

// 팀 저장
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);

양방향 연관관계

양방향 매핑

Member 엔티티는 단방향과 동일

Team 엔티티는 컬렉션 추가

@Entity
public class Team {

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

    private String name;

    @OneToMany(mappedBy = "team")   // Member엔티티의 외래키 매핑 필드명
    List<Member> members = new ArrayList<Member>();
}

반대 방향으로 객체 그래프 탐색

Team findTeam = em.find(Team.class, team.getId());

int memberSize = findTeam.getMembers().size();   //역방향 조회

객체와 테이블이 관계를 맺는 차이

객체 연관관계 = 2개
- 회원 -> 팀 연관관계 1개(단방향) (Team team)
- 팀 -> 회원 연관관계 1개(단방향) (List members)
테이블 연관관계 = 1개
- 회원 <-> 팀의 연관관계 1개(양방향) (외래 키)

객체의 양방향 관계

객체의 양방향 관계는 사실 양방향이 아니라 서로 다른 단방향 관계 2개이다.
객체를 양방향으로 참조하려면 단방향 연관관계를 2개 만들어야 한다.

테이블의 양방향 관계

테이블은 외래 키 하나로 두 테이블의 연관관계를 관리
MEMBER.TEAM_ID 외래 키 하나로 양방향 관계를 가짐(양쪽으로 조인 가능)
```
SELECT *
FROM MEMBER M
JOIN TEAM T ON M.TEAM_ID = T.TEAM_ID
```

객체의 양방향 관계에서는 둘 중 하나로 외래 키를 관리해야 한다!

Ex)팀을 수정하고 싶다면 Member에서 team을 수정해야 하는지?
아니면 Team에서 List members를 바꿔야 하는지?

연관관계의 주인

양방향 매핑 규칙

객체의 두 관계중 하나를 연관관계의 주인으로 지정
연관관계의 주인만이 외래 키를 관리(등록, 수정)
주인이 아닌쪽은 읽기만 가능
주인이 아니면 mappedBy 속성으로 주인 지정
외래 키가 있는 곳을 주인으로 지정
여기서는 Member.team이 연관관계의 주인

양방향 매핑시 많이 하는 실수

연관관계의 주인에 값을 입력하지 않음

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_ID = null

team.getMembers()는 읽기만 가능하기 때문에 update시에 사용되지 않는다.

순수한 객체 관계를 고려하면 항상 양쪽다 값을 입력해야 한다.

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;

// 결과 : TEAM_ID = 2

member.setTeam(team)을 통해 값을 입력하면 정상적으로 동작하지만, 실제로는 영속성 컨텍스트(1차 캐시)에만 있기 때문에 커밋전에 team을 조회하면 조회가 안된다.
따라서, team.getMembers()에도 값을 넣어 주어야 문제가 발생하지 않는다.
또한, test시에도 JPA를 사용하지 않기 때문에 필요하다.

양방향 연관관계 주의

순수 객체 상태를 고려해서 항상 양쪽에 값을 설정
연관관계 편의 메소드 생성
양방향 매핑시에 무한 루프 조심
- Ex) toString(), lombok, JSON 생성 라이브러리
- Ex) team을 출력하면 toString이 동작하게 되는데, team의 toString()안에는 member가 포함되어있어 member를 호출하고, member도 toString()이 동작하게 되는데, 안에는 team이 포함되어있다. 이것을 반복하여 무한루프에 걸리게 된다.
- Controller에는 Entity를 반환하지 않는것을 권장한다.
  - 1.무한 루프
  - 2.엔티티 변경시 API 스펙이 달라진다.
  - 따라서, DTO로 반환해주는 것을 권장!

연관관계 편의 메소드

양방향 연관관계시 양쪽에 값을 설정하는 경우 개발자의 실수로 코드를 기입하지 않을 가능성이 있기 때문에 편의 메소드를 사용을 권장한다.

예시

public class Member {

    ...
    public void changeTeam(Team team){
        this.team = team;
        team.getMembers().add(this);
    }
}

양방향 매핑 정리

단방향 매핑만으로도 이미 연관관계 매핑은 완료 (처음 설계시 단방향으로 설계)
양방향 매핑은 반대 방향으로 조회(객체 그래프 탐색)하는 기능이 추가된 것 뿐
JPQL에서 역방향으로 탐색할 일이 많음
단방향 매핑을 잘 해놓고, 양방향은 필요할 때 추가해도 됨.(테이블에 영향 X)

[기본 마인드]

단방향 매핑으로 다 끝낸다.
1:N일때 N쪽에 다 연관관계 매핑을 받아 놓고 설계 종료
애플리케이션 개발 단계에 들어가서 양방향 매핑 고민

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

비즈니스 로직을 기준으로 연관관계의 주인을 선택하면 안됨
연관관계의 주인은 외래 키의 위치를 기준으로 정해야한다!
- 성능면이나 운영 관점에서 좋다.

<출처 : 인프런 - 자바 ORM 표준 JPA 프로그래밍 - 기본편 (김영한)>

Twitter Facebook LinkedIn