들어가기 앞서

이 글은 김영한 님의 저서 「자바 ORM 표준 JPA 프로그래밍」을 학습한 내용을 정리한 글입니다. 모든 출처는 해당 저서에 있습니다.

4.5 필드와 컬럼 매핑: 레퍼런스

📝 필드와 컬럼 매핑 분류

4.5.1 @Column

객체 필드를 테이블 컬럼에 매핑

✅ 속성

✅ DDL 생성 속성에 따라 생성되는 DDL

📝 nullable

• 매핑 코드

@Column(nullable = false)
private String data;

• 결과

data varchar(255) not null

📝 unique

• 매핑 코드

@Column(unique = true)
private String username;

• 결과

alter table Tablename add constraint UK_Xxx unique (username)

📝 columnDefinition

• 매핑 코드

@Column(columnDefinition = "varchar(100) default 'EMPTY'")
private String data;

• 결과

data varchar(100) default 'EMPTY'

📝 length

• 매핑 코드

@Column(length = 400)
private String data;

• 결과

data varchar(400)

📝 precision, scale

• 매핑 코드

@Column(precision = 10, scale = 2)
private BigDecimal cal;

• 결과

cal numeric(10,2)  //H2, PostgreSQL
cal number(10,2)   //ORACLE
cal decimal(10,2)  //MySQL

✅ 생략

int data1;  //@Column 생략, 자바 기본 타입
data1 integer not null  //생성된 DDL → null 값 허용 x

Integer data2; //@Column 생략, 객체 타입
data2 integer  //생성된 DDL → null 값 허용

@Column  //'nullable = true' 기본
int data3;    //@Column 사용, 자바 기본 타입
data3 integer //생성된 DDL

∴ 기본 타입에 @Column 사용시 nullable = false로 지정하는 것이 안전함

4.5.2 @Enumerated

자바의 enum 타입 매핑

✅ 속성

💡 주의 사항

ORDINAL을 사용할 경우, 만약 ADMIN(0번), USER(1번) 사이에 enum을 추가하여 ADMIN(0번), NEW(1번), USER(2번)가 되면, USER는 2로 저장되지만 기존 데이터베이스에 저장된 값은 변경되지 않고 1이므로 값이 일치하지 않는 문제 발생
→ EnumType.String 사용 권장

✅ 사용 예

📝 enum 클래스

enum RoleType {
    ADMIN, USER
}

📝 enum 이름 매핑

@Enumerated(EnumType.STRING)
private RoleType roleType;

📝 enum 사용

member.setRoleType(RoleType.ADMIN);  //DB에 문자 ADMIN으로 저장

4.5.3 @Temporal

날짜 타입(java.util.Date, java.util.Calendar) 매핑

✅ 속성

✅ 사용 예

📝 매핑

@Temporal(TemporalType.DATE)
private Date date;      //날짜

@Temporal(TemporalType.TIME)
private Date time;      //시간

@Temporal(TemporalType.TIMESTAMP)
private Date timestamp; //날짜와 시간

📝 생성된 DDL

date date,
time time,
timestamp timestamp,
...

✅ 생략

• timestamp로 정의
• 데이터베이스 방언에 따라 DDL이 자동 생성 됨
  • datetime : MySQL
  • timestamp : H2, ORACLE, PostgreSQ

4.5.4 @Lob

데이터베이스 BLOB, CLOB 타입과 매핑

✅ 속성

• 지정 속성 존재 x
• 매핑하는 필드 타입에 따라 DB의 BLOB, CLOB과 매핑
  • CLOB : 문자 ex) String, char[], java.sql.CLOB
  • BLOB : 그 외 ex) byte[], java.sql.BLOB

✅ 사용 예

📝 매핑

@Lob
private String lobString;

@Lob
private byte[] lobByte;

📝 생성된 DDL

//ORACLE
lobString clob,
lobByte blob,

//MySQL
lobString longtext,
lobByte longblob,

//PostgreSQL
lobString text,
lobByte old,
...

4.5.5 @Transient

객체에 어떤 값을 임시로 보관하고 싶을 때 사용

• 매핑 x → 데이터베이스에 저장 x, 조회 x

✅ 사용 예

@Transient
private Integer temp;

4.5.6 @Access

JPA의 엔티티 데이터 접근 방식 지정

• 미설정 시 @Id 위치 기준으로 접근 방식 설정
• 접근 방식 동시 사용 가능

✅ 필드 접근

• 지정 : AccessType.FIELD
• 필드에 직접 접근
• 필드 접근 권한이 private이어도 접근 가능
• @Id가 필드에 존재 = @Access(AccessType.FIELD) 설정
  → @Access 생략 가능

@Entity
@Access(AccessType.FIELD)  //생략 가능
public clss Member {

    @Id
    private String id;
    
    private String data1;
    private String data2;
    ...
}

✅ 프로퍼티 접근

• 지정 : AccessType.PROPERTY
• 접근자(Getter) 사용하여 접근
• @Id가 프로퍼티에 존재 = @Access(AccessType.PROPERTY 설정
  → @Access 생략 가능

@Entity
@Access(AccessType.PROPERTY)  //생략 가능
public clss Member {

    private String id;
    
    private String data1;
    private String data2;
    
    @Id
    public String getId() {
        return id;
    }
    
    @Column
    public String getData1() {
        return data1;
    }
    
    public String getData2() {
        return data2;
    }
    ...
}

✅ 필드 접근 + 프로퍼티 접근

@Entity
public clss Member {

    @Id  //필드 접근 방식
    private String id;
    
    @Transient
    private String firstName;
    
    @Transient
    private String lastName;
    
    @Access(AccessType.PROPERTY)  //프로퍼티 접근 방식
    public String getFullName() {
        return firstName + lastName;
    }
    ...
}