🌿 Spring Data JPA - 매핑 어노테이션 정리

📌 1. 객체와 테이블 매핑

• @Entity
  이 클래스가 JPA가 관리하는 엔티티 클래스임을 선언함.
  실제 데이터베이스 테이블과 매핑됨.
• @Table(name = "table_name") (선택)
  엔티티와 매핑될 테이블 이름을 지정. 생략하면 클래스 이름과 동일한 테이블로 자동 매핑됨.

@Entity
@Table(name = "posts") // posts 테이블과 매핑
public class Post {
    ...
}

 

 

---

📌 2. 기본 키 매핑

• @Id
  기본 키(primary key)를 지정하는 어노테이션. 반드시 필요함!
• @GeneratedValue(strategy = GenerationType.IDENTITY)
  기본 키의 자동 생성 전략을 지정함. 대표적인 전략:
  • IDENTITY: DB에서 자동 증가 (MySQL의 auto_increment)
  • SEQUENCE: DB의 시퀀스 사용 (Oracle 등)
  • AUTO: JPA가 자동으로 적절한 전략 선택
  • TABLE: 키 생성용 별도 테이블 사용

@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;

 

 

---

📌 3. 필드와 컬럼 매핑

• @Column(name = "column_name", nullable = false, length = 100)
  • name: 실제 컬럼 이름 지정
  • nullable: NOT NULL 여부
  • length: 문자 길이 제한 (문자열에만 적용)
• 생략 시 필드명이 그대로 컬럼명으로 사용됨

@Column(name = "post_title", nullable = false, length = 100)
private String title;

• 기타 컬럼 관련 어노테이션
  • @Lob → 큰 텍스트나 바이너리 저장 (ex: TEXT, BLOB)
  • @Transient → DB 컬럼과 무관한 필드 (저장되지 않음)
  • @Temporal → 날짜 타입 설정 (Date/Calendar에 사용됨 → 대부분 LocalDateTime으로 대체)

 

 

---

📌 4. 연관관계 매핑

• @ManyToOne : 다대일 관계 (N:1)
• @OneToMany : 일대다 관계 (1:N)
• @OneToOne : 일대일 관계 (1:1)
• @ManyToMany : 다대다 관계 (N:N)
• @JoinColumn(name = "foreign_key")
  외래 키 컬럼을 지정 (기본값은 참조하는 테이블의 필드명 + _id)

✔ 예시: 다대일 (N:1)

@Entity
public class Post {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String title;

    @ManyToOne
    @JoinColumn(name = "author_id") // 외래 키 컬럼 이름
    private Author author;
}

 

✔ 예시: 일대다 (1:N)

@Entity
public class Author {

    @Id
    @GeneratedValue
    private Long id;

    private String name;

    @OneToMany(mappedBy = "author")
    private List<Post> posts = new ArrayList<>();
}

 

 

---

📎 요약

구분	어노테이션	설명
엔티티 지정	@Entity	JPA가 관리하는 클래스 지정
테이블명	@Table	매핑될 테이블 이름 지정
기본키	@Id	PK 지정
키 생성	@GeneratedValue	키 자동 생성 전략
컬럼 매핑	@Column	컬럼 속성 지정
대용량 컬럼	@Lob	TEXT/BLOB 같은 대용량 데이터 저장
연관관계	@ManyToOne, @OneToMany 등	엔티티 간 관계 지정
외래키	@JoinColumn	외래키 컬럼 이름 지정
제외 필드	@Transient	DB 저장 제외 필드

 

 

---