[JPA] 엔티티 매핑 ⭐️ @Entity, @Table, @Column, @Id

엔티티 매핑 (Entity Mapping)

• 객체와 테이블 매핑: @Entity, @Table 
• 필드와 컬럼 매핑: @Column 
• 기본 키 매핑: @Id, @GeneratedValue 
• 연관관계 매핑: @ManyToOne, @JoinColumn

 

@Entity

• @Entity가 붙은 클래스는 JPA가 관리, 엔티티라 한다.
• JPA를 사용해서 테이블과 매핑할 클래스는 @Entity 필수 

주의

• 기본 생성자 필수(파라미터가 없는 public 또는 protected 생성자) 
• final 클래스, enum, interface, inner 클래스 사용 X 
• 저장할 필드에 final 사용 X

 

@ Table

@Table은 엔티티와 매핑할 테이블 지정

속성	기능	기본값
name	매핑할 테이블 이름	엔티티 이름 사용
catalog	DB catalog 매핑
schema	DB schema 매핑
uniqueConstraints (DDL)	DDL 생성 시에 유니크 제약 조건 생성

 

매핑 어노테이션

• @Column - 컬럼 매핑
• @Temporal - 날짜 타입 매핑
• @Enumerated - enum 타입 매핑
  • EnumType.ORDINAL: enum 순서를 데이터베이스에 저장 (ORDINAL 사용 X)
  • EnumType.STRING: enum 이름을 데이터베이스에 저장

• @Lob - BLOB, CLOB 매핑
  • 매핑하는 필드 타입이 문자면 CLOB 매핑, 나머지는 BLOB 매핑

• @Transient - 특정 필드를 컬럼에 매핑하지 않음(매핑 무시)

 

@Column 속성 ⭐️

• name - 필드와 매핑할 테이블의 컬럼 이름
  • 기본값: 객체의 필드 이름
• insertable, updatable - 등록, 변경 가능 여부
  • 기본값: TRUE
• nullable(DDL) - null 값의 허용 여부를 설정한다. false로 설정하면 DDL 생성 시에 not null 제약조건이 붙는다.
• unique(DDL) - @Table의 uniqueConstraints와 같지만 한 컬럼에 간단히 유니크 제 약조건을 걸 때 사용한다.
• columnDefinition(DDL) - 데이터베이스 컬럼 정보를 직접 줄 수 있다.
  ex) varchar(100) default ‘EMPTY'
  • 기본값: 필드의 자바 타입과 방언 정보를 사용해 서 적절한 컬럼 타입
• length(DDL) - 문자 길이 제약조건, String 타입에만 사용한다.
  • 기본값: 255
• precision, scale(DDL) - BigDecimal 타입에서 사용한다(BigInteger도 사용할 수 있다). precision은 소수점을 포함한 전체 자릿수를, scale은 소수의 자릿수 다. 참고로 double, float 타입에는 적용되지 않는다. 아주 큰 숫자나 정밀한 소수를 다루어야 할 때만 사용한다.
  • 기본값: precision=19, scale=2

 

기본 키 매핑

@Id, @GeneratedValue 

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

 

• 직접 할당: @Id만 사용 
• 자동 생성 : @GeneratedValue
  • IDENTITY: 기본키 생성을 데이터베이스에 위임  (예: MySQL의 AUTO_ INCREMENT)
    IDENTITY 전략은 em.persist() 시점에 즉시 INSERT SQL 실행 하고 DB에서 식별자를 조회
  • SEQUENCE: 데이터베이스 시퀀스 오브젝트 사용, ORACLE 
    • @SequenceGenerator 필요 
  • TABLE: 키 생성용 테이블 사용, 모든 DB에서 사용
    키 생성 전용 테이블을 하나 만들어서 데이터베이스 시퀀스를 흉 내내는 전략
    
    • @TableGenerator 필요 
    • 장점: 모든 데이터베이스에 적용 가능
    • 단점: 성능이 조금 떨어짐
  • AUTO: 방언에 따라 자동 지정, 기본값

 

권장하는 식별자 전략 

• 기본 키 제약 조건: null 아님, 유일, 변하면 안된다.
• 미래까지 이 조건을 만족하는 자연키는 찾기 어렵다. 대리키(대체키)를 사용하자.
• 주민등록번호도 기본 키로 적절하지 않다.
• 권장: Long형 + 대체키 + 키 생성전략 사용

 

 

 

참조 - 자바 ORM 표준 JPA 프로그래밍