필드와 컬럼 매핑

 

01. 요구사항 추가 정리

 

요구사항은 다음과 같다.

• 회원은 일반 회원과 관리자로 구분된다.
• 회원 가입일과 수정일이 있어야 한다.
• 회원을 설명하는 필드가 있어야 하고, 이 필드는 길이 제한이 없다.

 

 

---

 

 

02. 요구사항에 따른 코드 및 Mapping Annotation 정리

 

요구사항에 따른 코드

• 다음은 Member 클래스이다.

@Entity
@Getter
@Setter
public class Member {
    
    @Id
    private Long id;

    @Column(name = "name")
    private String username;

    private Integer age;

    @Enumerated(EnumType.STRING)
    private RoleType roleType;

    @Temporal(TemporalType.TIMESTAMP)
    private Date createdDate;

    @Temporal(TemporalType.TIMESTAMP)
    private Date lastModifiedDate;

    @Lob
    private String description;

}

 

 

 

실행 후 로그이다.

Mapping Annotation 정리 : 위 코드에서 사용한 Mapping Annotation들을 간단하게 정리해보면 다음과 같다.

 

어노테이션	설명
@Column	컬럼 매핑
@Temporal	날짜 타입 매핑
@Enumerated	enum 타입 매핑
@Lob	BLOB, CLOB 매핑
@Transient	특정 필드를 컬럼에 매핑하지 않음

---

 

03. @Column

 

 

@Column의 속성들에 대해 알아보자

 

name

• 필드와 매핑할 테이블의 컬럼 이름이다.
• 기본값은 객체의 필드 이름이다.

 

insertable, updatable

• 필드의 등록 및 변경 가능 여부이다.
• 기본값은 true이다.

 

nullable (DDL)

• null 값의 허용 여부를 설정한다.
• false로 설정하면 DDL 생성 시 not null 제약조건이 붙는다.

 

 

unique (DDL)

• @Table의 uniqueConstraints와 같다. 
• 다른 점은, 한 Column에 간단히 유니크 제약조건을 걸 때 사용한다는 것이다.

columnDefinition (DDL)

• 데이터베이스 컬럼 정보를 직접 줄 수 있다.
• 필드의 자바 타입과 방언 정보를 이용하여 사용하면 된다.
• 예를 들어, 다음과 같이 작성할 수 있다.

@Column(columnDefinition = varchar(100) default 'EMPTY')

length (DDL)

• 문자 길이 제약 조건으로, String 타입에만 사용된다.
• 기본값은 255이다.

precision`, `scale` (DDL)

• BigDecimal, BigInteger 타입에서 사용한다.
• precision은 소수점을 포함한 전체 자릿수이다.
• scale은 소수의 자릿수이다.
• double, float 타입에는 적용되지 않으며, 아주 큰 숫자나 정밀한 소수를 다룰 때만 사용한다.
• precision의 기본값은 19, scale의 기본값은 2 이다.

 

 

---

 

 

04. @Enumerated

 

@Enumerated

• 자바 enum 타입을 매핑할 때 사용한다.
• DB에는 Enum 타입이 없다.
• 속성으로는 value가 있다.

 

value 속성

• EnumType.ORDINAL은 enum 순서를 데이터베이스에 저장하며, 기본값이다. Integer 타입으로 추가된다.
• EnumType.STRING 은 enum 이름을 데이터베이스에 저장한다. varchar 타입으로 추가된다. 이것을 사용해야 한다.
• ORDINAL인 상황에서 요구사항이 변경되어 Enum 타입을 변경하는 경우 데이터에 오류가 발생한다.

 

 

 

---

 

05. @Temporal

 

 

@Temporal

• 날짜 타입 (java.util.Date, java.util.Calendar)을 매핑할 때 사용한다.
• LocalDate와 LocalDateTime 사용할 때는 생략이 가능하다.
• 속성으로는 value가 있다.

value 속성

• @TemporalType.DATE
  • 날짜만을 나타낸다.
  • 데이터베이스의 date 타입과 매핑된다.
  • 2023-07-22 형태이다.
• @TemporalType.TIME
  • 시간만을 나타낸다.
  • 데이터베이스의 time 타입과 매핑된다.
  • 11:11:12 형태이다.
• @TemporalType.TIMESTAMP
  • 날짜와 시간을 나타낸다. 
  • 데이터베이스의 timestamp 타입과 매핑된다.
  • 2024-01-06 00:11:12 형태이다.

    

---

 

05. @Lob

 

 

@Lob

• 데이터베이스 BLOB, CLOB 타입과 매핑된다.
• 데이터베이스에서 큰 값을 사용하고 싶을 때 사용한다.
• 지정할 수 있는 속성이 없다.
• 매핑하는 필드 타입이 문자면 CLOB 매핑이다. (String, char[], java.sql.CLOB)
• 매핑하는 필드 타입이 문자 이외이면 BLOB 매핑이다. (byte[], java.sql.BLOB)

 

 

---

 

06. @Transient

 

 

@Transient

• 필드를 매핑하지 않는다는 뜻이다.
• 데이터베이스에 저장하지 않고, 조회하지 않는다.
• 주로 메모리 상에서만 임시로 어떤 값을 보관하고 싶을 때 사용한다.
• 예시 코드는 다음과 같다.

@Transient
private Integer temp;