JPA @MappedSuperClass

 

📝 @MappedSuperclass란?

@MappedSuperclass는 JPA에서 공통 속성을 여러 엔티티 클래스에 재사용할 수 있게 해주는 슈퍼클래스를 정의할 때 사용되는 어노테이션입니다. 이 슈퍼클래스는 엔티티가 아니며, 따라서 데이터베이스에 별도의 테이블이 생성되지 않습니다. 대신, 이 슈퍼클래스를 상속받는 서브클래스 엔티티의 테이블에 슈퍼클래스의 필드가 포함됩니다.

주요 포인트:

• 엔티티가 아님: @MappedSuperclass로 선언된 클래스는 JPA 엔티티가 아니므로 데이터베이스에 별도의 테이블이 생성되지 않습니다.
• 공통 속성 상속: 슈퍼클래스의 필드와 매핑 정보가 서브클래스 엔티티에 상속되어 테이블에 포함됩니다.
• 단일 테이블 전략과의 차이: 다른 상속 매핑 전략과는 달리, 슈퍼클래스 자체는 별도의 테이블로 관리되지 않습니다.

---

📝 @MappedSuperclass의 특징

2.1. 필드 매핑 상속

@MappedSuperclass로 선언된 클래스의 필드는 이를 상속받는 엔티티 클래스에 그대로 포함됩니다. 따라서 슈퍼클래스에서 정의된 필드들은 서브클래스의 테이블에 매핑됩니다.

2.2. 엔티티가 아님

@MappedSuperclass로 지정된 클래스는 엔티티가 아니므로, JPA에서 직접적으로 관리되지 않습니다. 즉, 이 클래스로는 데이터베이스에 쿼리를 실행할 수 없습니다.

2.3. 상속 구조

• 단일 상속: 하나의 슈퍼클래스만을 상속받을 수 있습니다.
• 다중 상속 불가: 자바의 다중 상속 제한으로 인해, 하나의 클래스는 하나의 @MappedSuperclass만을 상속받을 수 있습니다.

2.4. 어노테이션 사용

• 필수: 슈퍼클래스에 반드시 @MappedSuperclass 어노테이션을 지정해야 합니다.
• 추가 어노테이션 사용 가능: 필드에 @Column, @Id 등 다른 JPA 어노테이션을 사용할 수 있습니다.

---

📝 @MappedSuperclass 사용 예제

3.1. 기본 예제

아래 예제에서는 BaseEntity라는 슈퍼클래스를 정의하고, 이를 상속받는 Member와 Order 엔티티를 구현합니다.

BaseEntity.java

<!-- BaseEntity.java -->
import javax.persistence.*;
import java.time.LocalDateTime;

@MappedSuperclass
public abstract class BaseEntity {

    @Id
    @GeneratedValue
    private Long id;

    @Column(name = "created_date", updatable = false)
    private LocalDateTime createdDate;

    @Column(name = "last_modified_date")
    private LocalDateTime lastModifiedDate;

    // Getter, Setter
    public Long getId() {
        return id;
    }

    public LocalDateTime getCreatedDate() {
        return createdDate;
    }

    public void setCreatedDate(LocalDateTime createdDate) {
        this.createdDate = createdDate;
    }

    public LocalDateTime getLastModifiedDate() {
        return lastModifiedDate;
    }

    public void setLastModifiedDate(LocalDateTime lastModifiedDate) {
        this.lastModifiedDate = lastModifiedDate;
    }
}

Member.java

<!-- Member.java -->
import javax.persistence.*;

@Entity
public class Member extends BaseEntity {

    private String name;
    private int age;

    // Getter, Setter
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

	public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }
}

Order.java

<!-- Order.java -->
import javax.persistence.*;
import java.time.LocalDateTime;

@Entity
public class Order extends BaseEntity {

    private LocalDateTime orderDate;
    private String status;

    // Getter, Setter
    public LocalDateTime getOrderDate() {
        return orderDate;
    }

    public void setOrderDate(LocalDateTime orderDate) {
        this.orderDate = orderDate;
    }

	public String getStatus() {
        return status;
    }

    public void setStatus(String status) {
        this.status = status;
    }
}

3.2. 설명

• BaseEntity:
  • @MappedSuperclass 어노테이션을 사용하여 슈퍼클래스로 선언되었습니다.
  • 공통 속성인 id, createdDate, lastModifiedDate가 정의되어 있습니다.
• Member와 Order:
  • @Entity 어노테이션을 사용하여 JPA 엔티티로 선언되었습니다.
  • BaseEntity를 상속받아 공통 속성을 재사용합니다.
  • 각 엔티티는 자신의 고유 속성인 name, age, orderDate, status 등을 추가로 정의합니다.

3.3. 데이터베이스 테이블 구조

• Member 테이블
  • id (PK)
  • created_date
  • last_modified_date
  • name
  • age
• Order 테이블
  • id (PK)
  • created_date
  • last_modified_date
  • order_date
  • status

BaseEntity는 별도의 테이블로 생성되지 않고, Member와 Order 테이블에 id, created_date, last_modified_date 필드가 포함됩니다.

---

📝 다른 상속 매핑 전략과의 비교

JPA에서는 상속 관계를 매핑하기 위한 여러 가지 전략을 제공합니다. 주요 전략으로는 @MappedSuperclass 외에도 @Inheritance 어노테이션을 사용한 상속 매핑 전략이 있습니다. 이를 비교하여 이해하면 @MappedSuperclass의 용도와 장점을 더 명확히 알 수 있습니다.

4.1. @MappedSuperclass vs @Inheritance

특징	@MappedSuperclass	@Inheritance (SINGLE_TABLE, JOINED, TABLE_PER_CLASS)
엔티티 여부	슈퍼클래스는 엔티티가 아님	슈퍼클래스가 엔티티일 수 있음
테이블 매핑	슈퍼클래스의 필드는 서브클래스의 테이블에 매핑	서브클래스와 슈퍼클래스의 필드가 각각 별도의 테이블에 매핑됨 (매핑 전략에 따라 다름)
쿼리 가능 여부	슈퍼클래스를 쿼리할 수 없음	슈퍼클래스 엔티티를 쿼리할 수 있음 (SINGLE_TABLE, JOINED)
상속 계층의 복잡성	단순히 필드 상속용	다양한 상속 매핑 전략을 통해 복잡한 상속 계층을 지원
다형성 지원	지원하지 않음	지원함 (특히 SINGLE_TABLE, JOINED 전략에서)
용도	공통 속성 재사용	객체 지향 상속 구조를 데이터베이스에 반영
장점	코드 재사용성 향상, 단순한 설계, 성능 향상	객체 지향 상속 구조를 데이터베이스에 잘 반영 가능, 다형성 지원
단점	다형성 미지원, 슈퍼클래스를 직접 쿼리할 수 없음, 복잡한 상속 구조 지원 어려움, 제한된 기능	매핑 전략에 따라 성능과 복잡성이 다름, 특정 전략은 테이블 조인이 많이 발생할 수 있음

4.2. 매핑 전략 요약

1. @MappedSuperclass:
   • 용도: 공통 속성을 재사용할 때, 상속 계층의 다형성이 필요 없을 때.
   • 장점: 단순한 설계, 테이블 조인 불필요.
   • 단점: 다형성 지원 안 함, 슈퍼클래스를 직접 쿼리할 수 없음.
2. @Inheritance:
   • SINGLE_TABLE:
     • 설명: 모든 상속 계층을 단일 테이블에 저장.
     • 장점: 성능 우수, 조인 불필요.
     • 단점: NULL 값이 많이 발생, 데이터 무결성 관리 어려움.
   • JOINED:
     • 설명: 슈퍼클래스와 서브클래스를 별도의 테이블에 저장하고 조인.
     • 장점: 데이터 정규화, 중복 최소화.
     • 단점: 조인 필요로 성능 저하 가능.
   • TABLE_PER_CLASS:
     • 설명: 각 서브클래스마다 별도의 테이블을 생성.
     • 장점: 독립적인 테이블, 서브클래스별 최적화 가능.
     • 단점: 데이터 중복, 슈퍼클래스 데이터 조회 어려움.

---

📝 @MappedSuperclass의 장단점

5.1. 장점

1. 코드 재사용성 향상:
   • 공통된 속성을 슈퍼클래스에 정의하고, 여러 엔티티에서 이를 상속받아 중복 코드를 줄일 수 있습니다.
2. 단순한 설계:
   • 슈퍼클래스가 별도의 테이블을 생성하지 않으므로 데이터베이스 설계가 단순해집니다.
3. 성능 향상:
   • 조인이 필요 없으므로 성능이 개선될 수 있습니다. 특히, 단일 테이블 전략을 사용할 때 조인 비용이 발생하지 않아 빠른 조회가 가능합니다.
4. 유연성:
   • 상속 계층이 단순하고, 다형성이 필요 없을 때 유용합니다. 여러 엔티티가 공통된 필드를 가질 때 쉽게 적용할 수 있습니다.

5.2. 단점

1. 다형성 미지원:
   • @MappedSuperclass는 다형성을 지원하지 않기 때문에, 슈퍼클래스를 기준으로 한 엔티티 쿼리를 실행할 수 없습니다.
2. 슈퍼클래스 직접 쿼리 불가:
   • @MappedSuperclass로 선언된 슈퍼클래스는 엔티티가 아니므로, 이를 직접적으로 조회하거나 조작할 수 없습니다.
3. 복잡한 상속 구조 지원 어려움:
   • 상속 계층이 복잡하거나, 다형성이 필요한 경우에는 다른 상속 매핑 전략(@Inheritance)을 사용하는 것이 더 적합합니다.
4. 제한된 기능:
   • @MappedSuperclass는 엔티티의 일부 기능만을 제공하며, 완전한 상속 매핑을 지원하지 않습니다.

---

📝 사용 시 주의사항

1. 엔티티로 사용 불가:
   • @MappedSuperclass로 선언된 클래스는 엔티티로 사용될 수 없으므로, 이를 기반으로 하는 쿼리를 작성할 수 없습니다.
2. 상속 관계 관리:
   • 단일 상속만을 지원하며, 다중 상속은 불가능합니다. 자바의 단일 상속 제한으로 인해, 하나의 클래스는 하나의 @MappedSuperclass만을 상속받을 수 있습니다.
3. 상속 전략 혼용 금지:
   • @MappedSuperclass와 다른 상속 매핑 전략(@Inheritance)을 혼용하여 사용하는 것은 권장되지 않습니다. 이는 매핑의 복잡성을 증가시키고, 예기치 않은 동작을 유발할 수 있습니다.
4. 데이터 무결성:
   • 공통 속성이 여러 엔티티에 분산되어 있을 수 있으므로, 데이터 무결성을 유지하기 위해 추가적인 주의가 필요합니다.
5. 보안 고려사항:
   • 슈퍼클래스에 민감한 정보가 포함되어 있는 경우, 이를 상속받는 엔티티에서 적절히 관리해야 합니다.

---

📝 베스트 프랙티스

1. 공통 속성 재사용:
   • 여러 엔티티에서 공통으로 사용하는 필드(예: id, createdDate, lastModifiedDate)는 @MappedSuperclass를 사용하여 슈퍼클래스에 정의하고, 이를 상속받아 재사용합니다.
2. 단일 책임 원칙:
   • 슈퍼클래스는 오직 공통된 속성과 관련된 책임만을 가져야 하며, 비즈니스 로직은 서브클래스 엔티티 또는 서비스 계층에 위치시킵니다.
3. 상속 계층 단순화:
   • 상속 계층을 가능한 단순하게 유지하고, @MappedSuperclass는 다형성이 필요 없는 경우에만 사용합니다.
4. 코드 일관성 유지:
   • 슈퍼클래스와 서브클래스 간의 일관성을 유지하기 위해, 필드명과 타입을 일관되게 관리합니다.
5. 테스트와 검증:
   • @MappedSuperclass를 사용한 경우, 서브클래스 엔티티가 올바르게 매핑되고, 데이터베이스 스키마가 기대한 대로 생성되는지 테스트합니다.

---

📝 결론

@MappedSuperclass는 JPA에서 공통 속성을 여러 엔티티에 효율적으로 재사용할 수 있게 해주는 유용한 도구입니다. 이를 통해 코드 중복을 줄이고, 공통된 필드를 일관되게 관리할 수 있습니다. 그러나 다형성이 필요하지 않고, 단순한 상속 구조에만 적합하며, @MappedSuperclass 자체는 엔티티로 취급되지 않기 때문에 이를 염두에 두고 사용해야 합니다.

복잡한 상속 구조나 다형성이 필요한 경우에는 @MappedSuperclass보다는 @Inheritance 어노테이션을 사용한 다른 상속 매핑 전략을 고려하는 것이 좋습니다. 프로젝트의 요구사항과 상속 구조의 복잡성에 따라 적절한 매핑 전략을 선택하여 데이터베이스와 애플리케이션의 효율성을 극대화하시기 바랍니다.

---

📚 추가 참고 자료

• JPA 공식 문서 - Inheritance
• Hibernate 공식 문서 - Inheritance
• Baeldung의 JPA Inheritance 가이드
• Spring Data JPA Documentation