[JPA] 연관관계 매핑

연관관계가 필요한 이유

---

용어 이해

• 방향(Direction): 단방향, 양방향
• 다중성(Multiplicity): 다대일(N:1), 일대다(1:N), 일대일(1:1), 다대다(N:M) 이해
• 연관관계의 주인(Owner): 객체 양방향 연관관계는 관리 주인 이 필요

 

예제 시나리오

• 회원과 팀이 있다.
• 회원은 하나의 팀에만 소속될 수 있다.
• 회원과 팀은 다대일 관계다.

 

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

 

객체를 테이블에 맞추어 모델링하면 연관관계가 없는 객체가 됨
→ 참조 대신, MEMBER 테이블의 외래 키, TEAM_ID를 그대로 사용

 

객체를 테이블에 맞추어 모델링

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

@Entity
public class Member {
    @Id @GeneratedValue
    private Long id;
    @Column(name = "USERNAME")
    private String name;
    @Column(name="TEAM_ID")
    private Long teamId;
	...
}
@Entity
public class Team {
    @Id @GeneratedValue
    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());

Long findTeamId = findMember.getTeamId();
Team findTeam = em.find(Team.class, findTeamId);

member가 속한 팀명을 알기 위해, member가 가진 team.id을 통해, 즉 식별자로 테이블을 검색해서 가져와야 함

이는 연관관계가 없기 때문이며, 객체지향적인 방법이 아님!

 

• 테이블은 외래 키로 조인, 객체는 참조을 사용해 연관 테이블 찾음
• 테이블과 객체 사이에는 이런 큰 간격이 있음

 

단방향 연관관계

---

객체 지향 모델링

✓ 객체 연관관계 사용

• teamId → Team team 으로 참조값 가져옴

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

@Entity
public class Member {
    @Id @GeneratedValue
    private Long id;
    @Column(name = "USERNAME")
    private String name;
    
//    @Column(name="TEAM_ID")
//    private Long teamId;
    
    @ManyToOne // 관계jpa에 알려줌(다대일), 여러멤버가 하나의팀에 소속되니
    @JoinColumn(name = "TEAM_ID") //외래 키(FK)로 사용할 컬럼명
    private Team team;

 

✓ 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에 team 참조 저장하면, JPA가 알아서 team 엔티티에서 pk 값을 추출해서 member의 fk로 설정함

✓ 연관관계 조회, 수정

//회원 조회
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)
• 팀 → 회원 (Team.members)

-Member

Member 엔티티는 단방향과 동일

@Entity
public class Member {
    @Id @GeneratedValue
    private Long id;
    @Column(name = "USERNAME")
    private String name;

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

-Team

컬렉션 추가

@Entity
public class Team {
    @Id
    @GeneratedValue
    private Long id;
    private String name;
    
    @OneToMany(mappedBy = "team") //상대편 엔티티에서 나를 참조하는 필드명, 연관관계의 주인은 Member 엔티티의 team 필드라는 뜻
    List<Member> members = new ArrayList<>();//그래서 이 필드는 조회용, DB에 컬럼 없음

 

이러면 JPA가  "이 팀에 속한 모든 Member 엔티티들"을 자동으로 넣어줌

 

잠깐! 언제 컬렉션이 채워지는 거지?

자동으로 연관된 엔티티(예: members 컬렉션) 를 채워주는 시점은 조회할 때!
정확히 말하면, 영속성 컨텍스트에서 엔티티를 로딩할 때 발생

(일단 이렇게만. 나중에 자세히...LAZY,EAGER)

 

-조회

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

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

em.flush();//조회 할꺼니 필요
em.clear();

//팀 조회
Team findTeam = em.find(Team.class, team.getId());
int memberSize = findTeam.getMembers().size(); //1

 

지연로딩(LAZY) 이라면 (기본값) : 

• em.find(Team.class, id) → Team만 조회됨.(SELECT * FROM team WHERE id = ?)
• findTeam.getMembers().size() 하는 그 순간에 쿼리가 날아감 (프록시가 초기화됨)
  → SELECT * FROM member WHERE team_id = ?

 

 @OneToMany(mappedBy = "team", fetch = FetchType.EAGER) 즉시 로딩이라면:

• em.find(Team.class, id) 시점에 Team + 연관된 Member들도 즉시 같이 조회됨.
  → SELECT * FROM team WHERE id = ? 즉시
      SELECT * FROM member WHERE team_id = ?

 

 

 

연관관계의 주인과 mappedBy

---

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

먼저, 객체와 테이블간에 연관관계를 맺는 차이 이해해야 함

 

객체 연관관계 = 2개

회원 → 팀 1개(단방향)

팀 → 회원 1개(단방향)

 

테이블 연관관계 = 1개

회원 ↔︎ 팀 1개 (양방향)

 

✓ 테이블의 양방향 관계

테이블은 외래 키 하나로 두 테이블의 연관관계를 관리

MEMBER.TEAM_ID 외래 키 하나로 양방향 연관관계 가짐
(양쪽으로 조인할 수 있다.)

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

 

✓ 객체의 양방향 관계

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

객체를 양방향으로 참조하려면 단방향 연관관계를 2개 만들어야 한다.

 A -> B (a.getB())     class A { B b; }
 B -> A (b.getA())     class B { A a; }

 

근데 여기서 둘중 하나로 외래 키 관리 해야함

그렇다면, Member.team, Team.members 둘 중 어떤 것을 연관간계의 주인으로 정해야할까?

 

✓ 연관관계의 주인(Owner) - 양방향 매핑 규칙

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

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

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

주인은 mappedBy 속성 사용X

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

 

✓ 누구를 주인으로?

외래키가 있는 곳

 

일대다, 다대일 관계에서 다쪽이 외래키를 가짐

그래서, 다쪽인 @ManyToOne에는 mappedBy 속성이 없음

 

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

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

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

Member member = new Member();
member.setName("member1");
member.setTeam(team); //❗️ 연관관계의 주인에 값 설정해주자

//역방향(주인이 아닌 방향)만 연관관계 설정
team.getMembers().add(member); //❗️순수한 객체 관계를 고려해서 항상 양쪽다 값을 입력 해주자
//안넣으면 em.flush()clear()하고 1차캐시 비워졌으니 디비에서 다시 조회해와야함

em.persist(member);

 

ID	USERNAME	TEAM_ID
1	member1	null

 

✓ 양방향 연관관계 주의점

 

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

member.setTeam(team);

team.getMembers().add(member);

 

근데, 실수도 안하고 편의성있게

 

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

@Entity
public class Member {
	@ManyToOne
    @JoinColumn(name = "TEAM_ID")
    private Team team;
    ...
    public void setTeam(Team team) { //게터세터관례때문에 setTeam → changeTeam 바꿔주자❗️
        this.team = team;
        team.getMembers().add(this); //✅ 
    }
}

그러면

member.changeTeam(team);

//team.getMembers().add(member); 생략가능

 

또는, 팀에서 멤버를 넣을수도 있음

@Entity
public class Team {

    @OneToMany(mappedBy = "team")
    List<Member> members = new ArrayList<>();

    public void addMember(Member member) {
        member.setTeam(this);
        members.add(member);
    }

//member.changeTeam(team);
team.addMember(member);

 

상황보고 둘중 하나 하면됨

 

3. 양방향 매핑시에 무한 루프를 조심하자  예: toString(), lombok, JSON 생성 라이브러리

@Entity
public class Member {
	...
    @Override
    public String toString() {
        return "Member{" +
            "id=" + id +
            ", name='" + name + '\'' +
            ", team=" + team + //team = team.toString()호출
            '}';
    }
}

@Entity
public class Team {
	...
    @Override
    public String toString() {
        return "Team{" +
                "id=" + id +
                ", name='" + name + '\'' +
                ", members=" + members + //members = members.toString()호출 ❗️무한루프❗️
                '}';
    }
}

 

이러면 무한루프에 빠짐

 

*JSON 생성 라이브러리

컨트롤러에서 절대 엔티티 반환❌

➡︎ 엔티티 DTO로 변환해 반환 할것

 

왜?

JPA의 양방향 연관관계와 JSON 직렬화 라이브러리가 충돌할 수 있기 때문

// Team.java
@Entity
public class Team {
    @OneToMany(mappedBy = "team")
    private List<Member> members = new ArrayList<>();
}

// Member.java
@Entity
public class Member {
    @ManyToOne
    @JoinColumn(name = "team_id")
    private Team team;
}

이 구조에서 컨트롤러에서 Team을 반환하면:

1. Team 객체 안에 List<Member>가 있어서 모든 Member들을 JSON으로 만듬
2. 각 Member는 다시 Team을 참조함
3. 그 Team은 또 List<Member>를 참조함
4. 이 과정이 무한 반복됨 → ❌ StackOverflowError 발생

@GetMapping("/teams")
public List<Team> getTeams() {
    return teamRepository.findAll(); // ❌ 위험!
}

 

해결방법 : DTO로 변환해서 반환하기

✨DTO 클래스 추가

-TeamDto.java

public class TeamDto {
    private String name;
    private List<String> memberNames;

    public TeamDto(Team team) {
        this.name = team.getName();
        this.memberNames = team.getMembers().stream()
            .map(Member::getName)
            .collect(Collectors.toList());
    }
}

public class MemberDto {
    private String name;
    private String teamName;

    public MemberDto(Member member) {
        this.name = member.getName();
        this.teamName = member.getTeam().getName();
    }
}

✨컨트롤러에서 DTO 반환하기

@GetMapping("/teams")
public List<TeamDto> getTeams() {
    return teamRepository.findAll().stream()
        .map(TeamDto::new)
        .collect(Collectors.toList());
}

@GetMapping("/members")
public List<MemberDto> getMembers() {
    List<Member> members = memberRepository.findAll();
    return members.stream()
        .map(MemberDto::new)
        .collect(Collectors.toList());
}

 

 

✓ 양방향 매핑 정리

• 단방향 매핑만으로도 이미 연관관계 매핑은 완료 (처음에 단방향 매핑으로 설계 끝내야함)
• 양방향 매핑은 반대 방향으로 조회(객체 그래프 탐색) 기능이 추가된 것 뿐
• JPQL에서 역방향으로 탐색할 일이 많음
• 단방향 매핑을 잘 하고 양방향은 필요할 때 추가해도 됨
 (테이블에 영향을 주지 않음)
• 연관관계의 주인을 정하는 기준 :  외래 키의 위치 기준 (비즈니스 로직을 기준으로 연관관계의 주인을 선택하면 안됨)

 

실전 예제 - 2. 연관관계 매핑 시작

---

✓ 테이블 구조

 

✓ 객체 구조

+) 단방향만 설계하고 개발하다 필요하면 List 넣기

 

✓ 매핑

-Member

*회원은 List 넣기보단 회원만 가지는게 좋음

@OneToMany(mappedBy = "member")
private List<Order> orders = new ArrayList<>();

-Order

@ManyToOne
@JoinColumn(name = "MEMBER_ID")
private Member member;

@OneToMany(mappedBy = "order")
List<OrderItem> orderItemList = new ArrayList<>();

public void addOrderItem(OrderItem orderItem) {
    orderItemList.add(orderItem);
    orderItem.setOrder(this);
}

사실 addOrderItem도 필요없음 

오더엔티티 조회 했을때 바로 오더 아이템 알고싶을때 (편의성)때 만들기

-OrderItem

@ManyToOne
@JoinColumn(name="ORDER_ID")
private Order order;

@ManyToOne
@JoinColumn(name="ITEM_ID")
private Item item;