JPA 엔티티 어노테이션 정리 (@Entity, @MappedSuperclass, @Inheritance 상속 매핑 전략)

🚀 어노테이션 요약

어노테이션	목적
@Entity	DB 테이블과 매핑되는 진짜 엔티티 (JPA에서 가장 기본이 되는 테이블 매핑 어노테이션)
@MappedSuperclass	공통 필드를 공유하기 위한 상속 전용 부모 클래스
@Inheritane	상속 구조 자체를 DB테이블로 구현할 때 사용, 전략에 따라 하나 또는 여러개의 테이블로 저장

---

@Entity

🔍 실제로 DB에 테이블(user)을 만들어주는 역할이다.

@Entity
public class User {
    @Id
    private Long id;
    private String name;
}

✔️ @Entity가 있다면 @Id는 세트로 따라다닌다. (Id 지정 필수)

✔️ JPA의 기본 단위이다.

---

@MappedSuperclass

🔍 여러 엔티티에 공통으로 사용하는 필드들을(상속용) 정의할 때 사용하는 어노테이션

 

@MappedSuperclass
public abstract class BaseTimeEntity {
    private LocalDateTime createdAt;
    private LocalDateTime updatedAt;
}

✔️ @MappedSuperclass가 붙은 클래스는 DB테이블이 만들어지지 않는다.

✔️ 필드를 사용하기 위해선 자식 엔티티가 extends로 상속을 받아야한다.

 

@Entity
public class Post extends BaseTimeEntity {
    @Id
    private Long id;
    private String title;
}

✔️ @MappedSuperclass를 상속받는다면, createdAt, updatedAt 필드가 자동으로 포함된다.

✔️ 단순 필드만 상속되며 관계(@OneToMay 등)는 상속이 되지 않는다.

✔️매번 공통된 필드를 만들기 번거롭기 때문에, 공통으로 사용되는 필드를 뽑아서 @MappedSuperclass를 만들어준다.

　　=> 공통으로 사용되는 필드를 재사용하기 용이하게 만들어준다.

---

@Inheritance

엔티티의 상속 구조를 테이블로 구현할 때 사용한다. 3가지 전략(SINGLE_TABLE, JOINED, TABLE_PER_CLASS)을 제공한다.

@Entity
@Inheritance(strategy = InheritanceType.SINGLE_TABLE)
public class Item {
    @Id
    private Long id;
    private String name;
}

　

@Entity
public class Book extends Item {
    private String author;
}

@Inheritance(strategy = InheritanceType.전략 선택)

 

🚀 전략 요약

전략 이름	뜻	테이블 수	특징
SINGLE_TABLE	하나의 테이블에 전부 저장	1개	속도 빠름, 공간 비효율
JOINED	부모/자식 테이블 나눠서 조인	여러 개	정규화 잘 됨, 느림
TABLE_PER_CLASS	자식마다 독립 테이블	여러 개	조인 없음, 중복 심함

* Table_per_class는 거의 사용하지 않는다.

---

🧐 공통 상품(Item)에 책(Book), 영화(Movie), 앨범(Album) 같은 자식이 있다고 가정한다,

@Entity
@Inheritance(strategy = ???)
public abstract class Item {
    @Id
    private Long id;
    private String name;
}

@Entity
public class Book extends Item {
    private String author;
}

@Entity
public class Movie extends Item {
    private String director;
}

 

1️⃣ SINGLE_TABLE

@Inheritance(strategy = InheritanceType.SINGLE_TABLE)

 

📁 테이블 예시

id	name	author	director
1	책1	홍길동	null
2	영화1	null	봉준호

 

💫특징

✔️ 모든 자식 클래스 필드를 한 테이블에 몰아서 저장한다. 그렇기 때문에 빈 칸(null)이 많아진다. (모든 필드가 합쳐져서)

✔️ 테이블이 하나이기 때문에 디스크 상에 테이블이 차지하는 용량자체는 적다(디스크 절약)

✔️ 그러나 모든 자식 클래스의 필드를 전부 다 포함해야 해서 공간 비효율이다.

 

🔎 생성되는 SQL 테이블 DDL

CREATE TABLE item (
  id BIGINT NOT NULL,
  name VARCHAR(255),
  author VARCHAR(255),
  director VARCHAR(255),
  dtype VARCHAR(31),  -- ★ 어떤 자식 클래스인지 구분하는 컬럼
  PRIMARY KEY (id)
);

 

---

2️⃣ JOINED

@Inheritance(strategy = InheritanceType.JOINED)

 

📁 테이블 예시

📌 Item(부모 테이블) : 공통 필드만 저장

id	name	dtype
1	책1	Book
2	영화1	Movie

 

📌 Book(자식 테이블) 

id	name
1	책1

 

📌 Movie(자식 테이블)

id	name
2	영화1

id는 Item의 PK를 그대로 사용한다. (Item.id = Book.id 그리고 Item.id = Movie.id)

 

💫특징

✔️ 부모와 자식 엔티티를 각각 별도의 테이블로 분리해서 저장한다.

✔️ 조회할 땐 JOIN을 사용해서 묶는다. JOIN으로 인해 성능이 느릴 수 있다.

✔️ 테이블이 분리되어 정규화가 되어있다. (깔끔한 구조)

 

🔎 생성되는 SQL 테이블 DDL

CREATE TABLE item (
  id BIGINT NOT NULL,
  name VARCHAR(255),
  dtype VARCHAR(31),
  PRIMARY KEY (id)
);

CREATE TABLE book (
  id BIGINT NOT NULL,
  author VARCHAR(255),
  PRIMARY KEY (id),
  FOREIGN KEY (id) REFERENCES item(id)  -- ★ 조인용 연결
);

CREATE TABLE movie (
  id BIGINT NOT NULL,
  director VARCHAR(255),
  PRIMARY KEY (id),
  FOREIGN KEY (id) REFERENCES item(id)
);

 

---

3️⃣ TABLE_PER_CLASS

@Inheritance(strategy = InheritanceType.TABLE_PER_CLASS)

 

📁 테이블 예시

 

📌 Book(자식 테이블) 

id	name	author
1	책1	홍길동

 

📌 Movie(자식 테이블)

id	name	director
2	영화1	봉준호

자식 테이블에 부모 필드(name)도 같이 들어간다.

 

💫특징

✔️ 부모 테이블(item)이 없고, 자식 클래스마다 독립적인 테이블(book, item)을 생성해서 저장한다.

✔️ 중복 필드(name)가 많아져서 정규화 정도가 낮고, 유지 보수가 어렵다.

✔️ 전체 조회시 UNION이 필요해 어렵고 불편하다.

　　 =>자식 테이블마다 따로 조회해야 할 수 도 있기 때문에 쿼리 짜기가 힘들다.

 

🔎 생성되는 SQL 테이블 DDL

CREATE TABLE book (
  id BIGINT NOT NULL,
  name VARCHAR(255),
  author VARCHAR(255),
  PRIMARY KEY (id)
);

CREATE TABLE movie (
  id BIGINT NOT NULL,
  name VARCHAR(255),
  director VARCHAR(255),
  PRIMARY KEY (id)
);