6장. 값 타입 매핑

• 두 가지 범주
  • 기본 값 타입 클래스
    • 원시 타입 및 해당 타입의 래퍼와 같이 JDK와 함께 제공되는 클래스
  • 개발자가 정의한 값 타입 클래스

6.1.1 기본 프로퍼티 기본값 재정의 - @Transient, @Basic, @Column, @NotNull

• @Transient: 선언된 필드는 영속화에서 제외
• 프로터피 값이 필요한지 여부를 선언하는 세 가지 방법
  • @Basic
  • @Column
  • @NotNull

6.1.2 프로퍼티 접근 방식 변경 - @Access(PROPERTY/FIELD)

• @Access: 프로퍼티 접근 전략
  • @Access(AccessType.PROPERTY): 게터/세터를 통한 접근
    • JPA 공급자(하이버네이트)가 게터/세터를 통해 접근하게 한다.
  • @Access(AccessType.FIELD): 필드를 통한 접근

6.1.3 파생 프로퍼티 활용 - @Formula

• @Formula

  @Formula("CONCAT(SUBSTR(DESCRIPTION, 1, 12), '...')")
  private string shortDescription;
  
  @Formula("(SELECT AVG(B.AMOUNT) FROM BID B NHERE B.ITEN_ID = ID)")
  private BigDecimal averageBidAmount;
  

• https://velog.io/@hahm0726/JPA-Formula

6.1.4 컬럼 값 변환 - @ColumnTransformer

• @ColumnTransformer

  @Column(name = "IMPERIALWEIGHT")
  @ColumnTransformer(
  	read = "IMPERIALNEIGHT / 2.20462",
  	write = "? * 2.20462" 
  )
  private double metricWeight;
  

  List Item> result =
  		em.createquery("SELECT i FROM Item i WHERE i.metricNeight = :W")
  			.setParameter("w", 2.0)
  			.getResultList();
  ----------------------------------------------
  // ...
  where
    i.IMPERIALNEIGHT / 2.20462 = ?
  

6.1.5 생성되는 프로퍼티 값과 기본 프로퍼티 값 - @Generated

• @Generated : 생성되는 프로퍼티를 표시할 때 사용

  @CreationTimestamp
  private LocalDate Createdon;
  
  @UpdateTimestamp
  private LocalDateTime LastModified; 
  
  @Column(insertable = false)
  @ColumnDefault("1.00")
  @Generated(org.hibernate.annotations.GenerationTime.INSERT)
  private BigDecimal initialprice;
  

• Hibernate 6.0.0부터 선택적으로 데이터베이스를 날짜 소스로 지정 가능한것으로 알려졌으나 적용되지 않은듯함..

  @CreationTimestamp(source = SourceType.DB)
  private Instant createdOn;
  @UpdateTimestamp(source = SourceType.DB)
  private Instant lastUpdatedOn;
  

  • https://www.baeldung.com/hibernate-creationtimestamp-updatetimestamp

6.1.6 @Temporal 어노테이션

• 자바8 이전 시간 타입 지정

6.1.7 열거형 매핑 - @Enumerated(EnumType.String)

6.2 임베드 가능한 컴포넌트 매핑

6.2.2 클래스를 임베드 가능하게 만들기 - @Embeddable

@EmbeddabLe
public class Address { // equals, hashCode 재정의 필요
	@Notnull
	@Column(nullable = false, Length = 5)
	@Column(nullable = false)
	private String street;
	
	@NotNull
	private String zipcode;
	
	@NotNull
	@Column(nullable = false)
	private String city;

	public Address() {
	}

	public Address (String street, String zipcode, String city) {
		this.street = street;
		this.zipcode = zipcode;
		this.city = city;
	}

	// 게터
	
	// equals, hashCode 재정의
}

@Entity
@Table(name = "USERS")
public class User { 
	@Id
	@GeneratedValue(generator = Constants.ID_GENERATOR)
	private Long id;
	
	private Address homeAddress; // Address는 @Embeddable이므로, 애너테이션 지정 생략가능.
	
	//...
}

6.2.3 임베드된 속성 재정의 - @Embedded, @AttributeOverride

@Entity
@Table(name = "USERS")
public class User {
	//...
	
	@Embedded // 생략가능
	@AttributeOverride(name = "street", column = @column(name = "BILLING_STREET"))
	@AttributeOverride(name = "zipcode", column = @Column(name = "BILLING_2IPCODE", Length = 5))
	@AttributeOverride(name = "city", column = @Column(name = "BILLING_CITY"))
	private Address bilLingAddress;
	
	public Address getBillingAddress() {
		return billingAddress;
	}
	public void setBillingAddress(Address billingAddress) {
		this.billingAddress = bilLingAddress; 
	}
	
	//...	
}

6.2.4 중첩 임베드된 컴포넌트 매핑

@Embeddable
public class Address {
	@NotNull
	@Column(nullable = false)
	private String street;
	
	@NotNull
	@AttributeOverride(name = "name",	column = @Column(name = "CITY", nullable = false))
	private City city;
	
	// ....
}

@Embeddable
public class City {
	@NotNull
	@Column(nullable = false, length = 5)
	private String zipcode;
	
	@NotNull
	@Column(nullable = false)
	private String name;
	
	@NotNull
	@Column(nullable = false)
	private String country;

	// ...
}

• 루트 엔티티 클래스인 User에서 재정의하는 경우
  • User#address에 @AttributeOverride(name ="city.name")
  • 중첩된 프로퍼티는 점 표기법(dot notation)으로 참조.

6.3 변환기를 이용한 자바 타입과 SQL 타입의 매핑 - @Type, @Lob

6.3.1 내장 타입

@Entity
public class Item {
	@Lob
	private byte[] image;

	@Lob
	private String description;
}

• 개발할때 지연로딩 여부 확인 필요

@Entity
public class Item {
	@Lob
	private Blob image;

	@Lob
	private Clob description;
}

• JDBC는 대용량 객체(LOB, Large Object)를 직접 지원한다.
  • 자바 프로퍼티가 Clob이나 Blob인 경우, 바이트코드 조작 없이도 지연 로딩을 하게 된다.

타입 어댑터 선택하기 - @Type

QEntity
public class Item {
	@org.hibernate.anotations.Type(type = "yes_no")
	private boolean verified = false;
}

6.3.2 사용자 정의 JPA 변환기 생성 - @Convert

• AttributeConverter을 구현한다.

@NotNuLL
@Convert(converter = MonetaryAmountConverter.cLass)
@Column(name = "PRICE", Length = 63) 
private MonetaryAmount buyNowprice;

@Converter
public class MonetaryAmountConverter 
									implements AttributeConvertercMonetaryAmount, String> {
									
	@Override
	public String convertToDatabaseColumn(MonetaryAmount monetaryAmount) {
		return monetaryAmount.tostring();
	}
	
	@Override
	public MonetaryAmount convertToEntityAttribute(String s) {
		return MonetaryAmount.fromstring(s);
	}
									
}

컴포넌트의 프로퍼티 변환하기

public abstract class Zipcode {
	private string value;

	public zipcode(String value) {
		this.value = value; 
	}
		
	public string getValue() {
		return value;
	} 
	
	@Override
	public boolean equals(object o){
		if (this == o) return true;
		if (0 ==null il getclass() != 0.getclass()) return false;
		Zipcode zipcode = (Zipcode) 0;
		return objects.equals(value, zipcode.value);
	}
	
	@Override
	public int hashCode() {
		return Objects.hash(value);
	}
}

public class Germanzipcode extends Zipcode {
	public Germanzipcode(String value) {
		super(value);
	}
}

@Converter
public class Zipcodeconverter implements AttributeConverterczipcode, String> {

	@Override
	public string convertToDatabaseColumn(Zipcode attribute) {
		return attribute.getValue();
	}
	
	@Override
	public Zipcode convertToEntityAttribute(String s) {
		if (S.length() == 5) {
			return new GermanZipcode(s);	
		}
		if (S.length() == 4) {
			return new SwissZipcode(s);		
		}
		throw new IllegalArgumentException("Unsupported zipcode in database: " + s);
	}
	 
}

@Entity
@Table(name ="USERS")
public class user {
	// ...

	@Convert(converter = ZipcodeConverter.class, attributename = "city.zipcode")
	private Address homeAddress;
	
}

영속성 맵의 경우

• 영속성 Map<Address, String>에서는 각 맵 키의 zipcode 프로퍼티에 대한 변환기를 Key.zipcode라는 속성명을 사용해 적용할 수 있습니다.
• 영속성 Map<String, Address>에서는 각 맵 값의 zipcode 프로퍼티에 대한 변환기를 value.zipcode라는 속성명으로 적용할 수 있습니다.
• 영속성 Map<Zipcode, String>에서는 각 맵 항목의 키에 대한 변환기를 key 속성명으로 적용할 수 있습니다.
• 영속성 Map<String, Zipcode>에서는 각 맵 항목의 값에 대한 변환기를 attributeName을 설정하지 않는 방식으 로 적용할 수 있습니다.

JPA 변환기의 제약사항

• 엔티티의 식별자 또는 버전 프로퍼티에는 적용할 수 없다.
• @Enumerated 또는 @Temporal로 매핑된 프로퍼티에 변환기를 적용해서는 안된다.
  • 이미 어떤 종류의 변환이 수행돼야 할지를 선언하고 있기 때문.

6.3.3 UserType을 이용한 하이버네이트 확장

• 하이버네이트는 세밀하고 저수준의 사용자 정의 접근을 허용하는 확장점인 네이티브 변환기 API를 제공한다.
• 확장점
  • UserType
    • 일반 JDBC와 상호작용해서 값을 변환할 수 있습니다. 즉, Preparedstatement(데이터를 저장할 때)와 ResultSet(데이터를 로드할 때)과 상호작용해서 값을 변환할 수 있습니다. 이 인터페이스를 구현하면 하이버네이트가 값을 캐시하고 변경 감지하는 방법도 제어할 수 있습니다.
  • CompositeUserType
  • ParameterizedType
  • DynamicParameterizedType
  • EnhanceduserType
  • UserVersionType
  • UserCollectionType

@org.hibernate.annotations.TypeDefs({ 
	@org.hibernate.annotations.TypeDef(
		name = "monetary_amount_usd",
		typeClass = MonetaryAmountuserType.class,
		parameters = {@parameter(name = "convertTo", value = "USD")}
	),
	@org.hibernate.annotations.TypeDef(
		name = "monetary_amount_eur",
		typeclass = MonetaryAmountuserType.class,
		parameters = {@parameter(name = "convertTo", value = "EUR")}
	)
})
package com.manning.javapersistence.ch06.converter;

import org.hibernate.annotations.Parameter;

@Entity
public class Item {
	@NotNull
	@org.hibernate.annotations.Type(
		type = "monetary_amount_usd"
	)
	@org.hibernate.annotations.Columns(columns ={
		@Column(name = "BUYNONPRICE_AMOUNT"),
		@Column(name = "BUYNOMPRICE_CURRENCY", Length = 3)
	})
	private MonetaryAmount buyNowprice;

	@NotNull
	@org.hibernate.annotations.Type(
		type = "monetary_amount_eur"
	)
	@org.hibernate.annotations.Columns(columns ={
		@Column(name = "INITIALPRICE_AMOUNT"),
		@Column(name = "INITIALPRICE_CURRENCY", Length = 3)
	})
	private MonetaryAmount initialprice;
	
	//...
}