[Spring JPA] @OneToMany 에서 @MapsId 사용하기

>> @OneToMany에서 @MapsId 올바르게 사용하는법 보러가기

 

>> @OneToOne에서 @MapsId 로 컬럼갯수 1개 줄여보기

 

 

---

@MapsId  에 관하여...

 

@MapsId는 FK를 PK로 지정할 때 사용하는 어노테이션이다.

 

이 말은 즉슨, @MapsId를 통해 엔티티의 PK를 FK로 매핑한다면, 데이터베이스 컬럼하나를 줄일 수 있다는 이야기이다...!

 

@MapsId를 검색하다가 @OneToMany 와 같이 검색어가 자동완성되기에, 이거 되는거구나!! 대박인걸!! 하고 웹상에 존재하는 예시코드를 따라해보았다.

 

결론부터 말하면, @OneToMany에서의 @MapsId 사용은 PK가 복합키일때만 사용가능하며, 위의 데이터베이스 컬럼하나를 줄일 수 있는 효과는 없다.

 

@OneToOne에서는 @MapsId 사용으로 @MapsId 를 사용하지 않았을 때, 디폴트로 생성되는 조인컬럼 필드를 하나 줄일 수 있다.

 

주의할점은, @OneToMany에서 @MapsId를 사용할때 PK가 복합키가 아니더라도 컴파일오류 및 DDL 오류는 발생하지 않는다. 

오히려 멋지게 잘 동작한다. 다만 데이터 삽입시 PK를 지정하라는 오류 문구를 내뱉는다.

 

 

---

@MapsId 를 사용한 올바르지 않은 코드 (삽질)

 

바보같은 나는 또 삽질을 하였다.

 

이러한 상상을 했다.

 

DDD(Domain-Driven-Development) 느낌으로 설계를 하고싶어..!!!!

그러므로 상위엔티티에서 하위엔티티들을 관리할꺼야...!!!

하위엔티티 테이블 필드를 최대한 줄이고 싶어...!!!

하위엔티티의 단일 PK를 FK로 지정하면 디폴트로 생성되던 조인칼럼 하나 줄일 수 있겠구나!!!

=> Hibernate가 ORM인 이상 진짜 진짜 진짜 말도 안되는 소리다. 

=> 물론 PK를 복합키로 사용하고 있다면 말이 되긴 한다.

 

DB에서 PK란 Unique한 값이며 Index로 지정되는 값이다. 이로인해 PK로 조회시 검색성능이 높아진다.

 

@OneToMany의 상황에서 단일 PK를 FK로 지정하는 것 자체가 모순이다.

하나의 부모를 가르키는 여러개의 자식이 있을건데 전혀 Unique하지 않다. 

 

아래는 이 사실을 깨닫기 전에 필자가 작성한 코드이다. (개인기록용) 

 

 

@OneToMany에서 단일 PK를  @MapsId로 매핑해보자!

 

# Item 엔티티 (Tags 를 OneToMany로 매핑중)

@Inheritance(strategy = InheritanceType.JOINED)
@DiscriminatorColumn @Getter
@AllArgsConstructor @NoArgsConstructor
@ToString(callSuper = true)
@Entity
public class Item extends BaseEntityWithId {
    protected Long itemId; //FolderId & BookmarkId
    protected String name;
    protected Long parentId;
    protected BigDecimal visitCount;
    protected Long userId;

    @OneToMany(fetch = FetchType.LAZY, mappedBy = "item", cascade = CascadeType.ALL)
    protected List<Tag> tags;

    public void setTags(List<Tag> tags){
        this.tags=tags;
    }
}

 

# Tag 엔티티 (Item을 @ManyToOne으로 매핑중)

@Entity
@AllArgsConstructor
@Builder
@NoArgsConstructor
@Getter
@ToString
public class Tag {
    @Id
    @Column(name="item_id")
    private Long itemId;
    private String tag;

    @MapsId("item_id")
    @ManyToOne(fetch = FetchType.LAZY,optional = false)
    @JoinColumn(name= "item_id")
    @ToString.Exclude
    Item item;

    public void setItem(Item item){
        this.item = item;
    }
}

 

#  DDL 실행결과 

 

 

원하는대로 tag 테이블에서는 FK로 생성되는 다른 컬럼이 없다..!

 

 

하지만 저렇게 테이블 매핑은 되지만, Item.setTags() 와 Tags.setItem()으로 연관관계를 묶은 후 Insert를 하면 오류가 발생한다.

 

오류의 표면적이유는 " PK를 Manual 하게 지정하셔야 되는데 하지 않으셨습니다. " 인데... 

 

생각해보면 당연하게도, Tag의 ItemId 를 PK로 지정했고, 그로 인해 PK는 Unique해야하는데,

일대다 관계기 때문에 Item의 PK를 Tag의 ItemId로 지정한다면 PK는 Unique해지지 못하므로

Hibernate가 @MapsId의 PK 주입을 허용하지 않는 것이다.

 

그럼 왜 오류문구가 " @MapsId를 잘못사용하셨습니다 " 가 아닐까?

실제 DB 에서는 PK 없이 테이블을 구성할 수 있다고 한다.

그리하여 Hibernate는 ORM 의 기능인 테이블에 매핑을 하기위한 @MapsId 는 동작을 허용하지만,

Insert 때 @MapsId로 연결된 컬럼을 자동삽입하는 기능은 모순되기에 동작을 허용하지 않는 것이다.

그리고 그 동작이 허용되지않으니, @GeneratedValue 가 아닌 PK는 값을 가지지 않게되고

그로 인해 PK를 Manual하게 지정해달라고 오류메세지를 띄우게 되는 것이다.

 

Hibernate의 움직임의 기초인 Proxy는 PK를 기반으로 움직이기 때문에

DB에서 PK 없이 테이블을 구성했을 때 매핑할 수 있는 방법 또한 아래와 같이 임의로 PK를 지정하는 방법이다. 

 

 

PK없이 테이블을 구성했을 때, DB에서도 삭제시에 여러가지 아이템이 지워질 수 있다는 오류문구를 띄우기도 한다.

결국은 칼럼1개를 절약하기 위해 PK 없이 테이블을 구성하는 것은 구성원들의 실수로 데이터가 날라갈 수도 있는 상황을 만들 수 있기에 지양하는 것이 옳다.

 

칼럼 1개의 Trade-off 비용은 JPA에서 적용의 까다로움 + 유지보수 + 데이터손실의 위험이다.

 

---

OneToMany 에서 @MapsId 를 올바르게 사용하기

 

복합키를 만들어서 매핑한다.

복합 PK의 검색성능에 대해서는 아직 공부가 덜되서 확답을 할 수 없다.

 

 

위와 같이 테이블구조를 만들면 PK가 중복되지 않으므로 @MapsId의 필드자동주입 기능도 활성화 된다. 

근데 언제 이런 구조를 가져가야하는지는 경험도 없고 지식도 없다... (추후 공부 필요)

 

 

# Tag 엔티티

@Entity @AllArgsConstructor
@Builder @NoArgsConstructor
@Getter @ToString
@IdClass(CompositeId.class) // 복합키설정
public class Tag {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Id
    @Column(name="item_id")
    private Long itemId;

    public class CompositeId implements Serializable{ // 복합키는 Serializable 
        private Long id;
        private Long itemId;
    }

    private String tag;

    @MapsId("item_id")
    @ManyToOne(fetch = FetchType.LAZY,optional = false)
    @JoinColumn(name= "item_id")
    @ToString.Exclude
    Item item;

}