대충 넘어가지 않는 습관을 위한 기록

JPA 기록 - 연관관계 매핑 기초

uhyvn 2024. 4. 10. 17:05

김영한님의 자바 ORM 표준 JPA 프로그래밍 - 기본편 을 보고 기록한 글입니다.

 


 

 

양방향 연관관계와 연관관계의 주인 - 기본

위와 같은 관계가 있다.

 

멤버에서도 팀을 호출할 수 있어야 하고, 팀에서도 멤버들을 호출할 수 있어야 한다.

테이블 입장에서는 외래 키만 보면 되니까 조인만 하면 간단하게 끝날 문제인데..

 

객체 입장에서는 멤버에도 팀이 있어야 하고, 팀에도 멤버가 있어야 한다.

 

 

 

Member Entity

@Entity
public class Member {

    @Id  @GeneratedValue
    @Column(name = "MEMBER_ID")
    private Long id;
    
    @Column(name = "USERNAME")
    private String name;
    
    @ManyToOne
    @JoinColumn(name = "TEAM_ID")
    private Team team;
}

 

 

Team Entity

@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<>();
}

 

 

이런 식으로 엔티티 코드를 작성하면 양방향 매핑이 가능하다.

 

 

사실 객체의 양방향 관계는 서로 다른 단방향 두 개인 셈이다.

팀에서 멤버로 가는 연관관계 1개(단방향),

멤버에서 팀으로 가는 연관관계 1개(단방향)

 

테이블은 외래 키가 있기 때문에 사실 방향이 없음.

 

 

둘 중 하나로 외래 키를 관리해야 한다.

-> 연관관계의 주인을 정해야 한다.

 

- 객체의 두 관계중 하나를 연관관계의 주인으로 지정

- 연관관계의 주인만이 외래 키를 관리(등록, 수정)

- 주인이 아닌 쪽은 읽기만 가능

- 주인은 mappedBy 속성 사용 X

- 주인이 아니면 mappedBy 속성으로 주인 지정

 

 

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

비즈니스 로직을 기준으로 연관관계의 주인을 선택하면 안되고 외래 키가 있는 곳을 주인으로 정해야 한다.

위와 같은 상황에서는 Member.team이 연관관계의 주인

 

 

 

 

 

 

 


 

 

 

 

양방향 연관관계와 연관관계의 주인 -  주의점, 정리

 

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

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

 

위 코드를 실행하면 TEAM_ID가 null로 나온다.

Member의 Team이 주인이기 때문에 아래처럼 바꿔야 한다.

 

 

이 코드에서 핵심은 member.setTeam이다.

(실제로는 setter를 쓰지 않는다. 이해의 용도로만 넘기자.)

 

 

양방향 매핑 시에는 연관관계의 주인에 값을 입력해야 한다.

 

양방향 연관관계 주의

- 순수 객체 상태를 고려해서 항상 양쪽에 값을 설정하자

- 연관관계 편의 메소드를 생성하자

- 양방향 매핑 시에 무한 루프를 조심하자

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

 

 

위처럼 member.setTeam(team)과 team.getMembers().add(member) 두 가지 모두

작성해줘야 하지만, 편의성을 위해 아래와 같이 연관관계 편의 메서드를 만들어두자.

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

 

혹은

@Entity
public class Team {
    public void addMember(Member member) {
        member.setTeam(this);
        members.add(member);
    }
}

 

둘 중에 하나만 작성해두면 된다.

 

 

 


 

 

양뱡향 매핑 시 무한루프를 조심하자..!

 

예를 들어 toString()의 경우,

@Override
public String toString() {
        return "Member{" +
            "id=" + id +
            ", name='" + name + '\'' +
            ", team=" + team +
            '}';
}

 

실제로는 위와 같은 코드를 실행하게 된다.

이 말은 곧, team.toString()을 또 호출한다는 얘기다.

public String toString() {
        return "Team{" +
            "id=" + id +
            ", name='" + name + '\'' +
            ", members=" + members +
            '}';
}

 

또 위 코드에서는 member.toString()을 호출하게 된다.

그럼 무한 루프에 빠지면서 StackOverflowError 를 터뜨리게 된다.

 

 

 


 

 

양방향 매핑 정리

- 단방향 매핑만으로도 이미 연관관계 매핑은 완료

- 양방향 매핑은 반대 방향으로 조회(객체 그래프 탐색) 기능이 추가된 것 뿐

- 하지만 실무에서는 예를 들어 JPQL에서 역방향으로 탐색할 일이 많음

- 그러나 단방향 매핑을 잘 하고 양방향은 필요할 때 추가해도 됨(테이블에 영향을 주지 않음)