====== Hibernate User Type ======
* ''UserType'', ''ParameterizedType'' 을 통해 사용자 정의 타입을 만들 수 있다.
* [[https://github.com/vladmihalcea/hibernate-types|vladmihalcea/hibernate-types: The Hibernate Types repository gives you extra types that are not supported by the Hibernate ORM core.]]
* [[java:hibernate:usertype:generic_enum|Hibernate Generic Enum UserType]]
* [[java:hibernate:usertype:stringdate|StringDate Hibernate UserType]]
* [[java:hibernate:usertype:stringboolean|StringBoolean Hibernate UserType]]
* UserType의 ''nullSafeSet''과 ''nullSafeGet''에서 값에 대한 로그를 ''trace'' 레벨로 남겨주어 쿼리 결과나 쿼리를 날릴 때의 로그로 해당 값을 Hibernate가 자동으로 남겨주는 다른 값들과 함께 로그로 남긴다.
* **''nullSafeGet''/''nullSafeSet''은 ''org.hibernate.type.StandardBasicTypes''의 실제 Type 상수에게 위임해주는 것이 좋다.**
* 이 경우 굳이 UserType의 ''nullSafeGet/nullSafeSet''에서 로그를 안 남겨도 알아서 남는다.
* [[https://github.com/jamesward/spring_hibernate_hstore_demo|Hibernate PostgresQL HStore]]
===== UserType의 등록 =====
* [[|@org.hibernate.annotations.TypeDef]]와 [[|@org.hibernate.annotations.TypeDefs]]를 통해 사용자 정의 타입에 짧은 이름을 부여해 둘 수 있다.
* 위 애노테이션은 Package(package-info.java)나 Entity class 레벨에 부여할 수 있다.
* ''package-info.java''에 등록할 경우에는 Hibernate냐 JPA에 따라 패키지 지정작업이 필요하다.
* JPA persistence.xml
com.foo.bar.thepackage
* Hibernate cfg.xml
* 패키지에 모든 파라미터까지 포함하여 미리 등록해 두는 것도 가능하다. ''package-info.java''
@TypeDefs({
@TypeDef(name = "some_enum", typeClass = GenericEnumUserType.class,
parameters = {
@Parameter(name = "enumClass", value = "kr.pe.kwonnam.usertype.SomeEnum"),
@Parameter(name = "identifierMethod", value = "toShortName"),
@Parameter(name = "valueOfMethod", value = "fromShortName")
})
})
package kr.pe.kwonnam.usertype;
import org.hibernate.annotations.Parameter;
import org.hibernate.annotations.TypeDef;
import org.hibernate.annotations.TypeDefs;
// Entity class
// 이제 엔티티 클래스에서는 다음과 같이 간단히 등록 가능
@Type(type = "some_enum")
@Column(name = "some_enum", length = 2, nullable = true)
private SomeEnum someEnum;
===== Primary Key =====
* Primary Key(Identifier)나 Descriminator(상속관계에서 구분자?)로 사용할 Custom Type은 ''org.hibernate.usertype.EnhancedUserType''를 구현해야 한다.
===== java.time.Year, java.time.Month =====
* [[https://vladmihalcea.com/java-time-year-month-jpa-hibernate/|How to map java.time.Year and java.time.Month with JPA and Hibernate - Vlad Mihalcea]]
* 기본적으로는 JPA ''AttributeConverter''를 사용한다.
* Hibernate 사용시에는 ''AbstractSingleColumnStandardBasicType''와 ''AbstractTypeDescriptor''로 처리 가능하다. 이에 관한 예제.
===== 참고 =====
* [[https://www.baeldung.com/hibernate-custom-types|Custom Types in Hibernate | Baeldung]]