基本值类型
内置的basic mapping types可以大致地分类为:
-
这些类型都对应 Java 的原始类型或者其封装类,来符合(特定厂商的)SQL 字段类型。
boolean, yes_no
和true_false
都是 Java 中boolean
或者java.lang.Boolean
的另外说法。 -
从
java.lang.String
到VARCHAR
(或者 Oracle 的VARCHAR2
)的映射。 -
从
java.util.Date
和其子类到 SQL 类型DATE
,TIME
和TIMESTAMP
(或等价类型)的映射。 -
从
java.util.Calendar
到 SQL 类型TIMESTAMP
和DATE
(或等价类型)的映射。 -
从
java.math.BigDecimal
和java.math.BigInteger
到NUMERIC
(或者 Oracle 的NUMBER
类型)的映射。 -
从
java.util.Locale
,java.util.TimeZone
和java.util.Currency
到VARCHAR
(或者 Oracle 的VARCHAR2
类型)的映射。Locale
和Currency
的实例被映射为它们的 ISO 代码。TimeZone
的实例被影射为它的ID
。 -
从
java.lang.Class
到VARCHAR
(或者 Oracle 的VARCHAR2
类型)的映射。Class
被映射为它的全限定名。 -
把字节数组(byte arrays)映射为对应的 SQL 二进制类型。
-
把长 Java 字符串映射为 SQL 的
CLOB
或者TEXT
类型。 -
把可序列化的 Java 类型映射到对应的 SQL 二进制类型。你也可以为一个并非默认为基本类型的可序列化 Java 类或者接口指定 Hibernate 类型
serializable
。 -
JDBC 类
java.sql.Clob
和java.sql.Blob
的映射。某些程序可能不适合使用这个类型,因为 blob 和 clob 对象可能在一个事务之外是无法重用的。(而且, 驱动程序对这种类型的支持充满着补丁和前后矛盾。) -
一般来说,映射类型被假定为是可变的 Java 类型,只有对不可变 Java 类型,Hibernate 会采取特定的优化措施,应用程序会把这些对象作为不可变对象处理。比如,你不应该对作为
imm_timestamp
映射的 Date 执行Date.setTime()
。要改变属性的值,并且保存这一改变,应用程序必须对这一属性重新设置一个新的(不一样的)对象。
integer, long, short, float, double, character, byte, boolean, yes_no, true_false
string
date, time, timestamp
calendar, calendar_date
big_decimal, big_integer
locale, timezone, currency
class
binary
text
serializable
clob, blob
imm_date, imm_time, imm_timestamp, imm_calendar, imm_calendar_date, imm_serializable, imm_binary
实体及其集合的唯一标识可以是除了
binary
、blob
和clob
之外的任何基础类型。(联合标识也是允许的,后面会说到。)
在
org.hibernate.Hibernate
中,定义了基础类型对应的Type
常量。比如,Hibernate.STRING
代表string
类型。
自定义值类型
开发者创建属于他们自己的值类型也是很容易的。比如说,你可能希望持久化
java.lang.BigInteger
类型的属性,持久化成为VARCHAR
字段。Hibernate没有内置这样一种类型。自定义类型能够映射一个属性(或集合元素)到不止一个数据库表字段。比如说,你可能有这样的 Java 属性:getName()
/setName()
,这是java.lang.String
类型的,对应的持久化到三个字段:FIRST_NAME
,INITIAL
,SURNAME
。
要实现一个自定义类型,可以实现
org.hibernate.UserType
或org.hibernate.CompositeUserType
中的任一个,并且使用类型的 Java 全限定类名来定义属性。请查看org.hibernate.test.DoubleStringType
这个例子,看看它是怎么做的。
<propertyname="twoStrings"type="org.hibernate.test.DoubleStringType"><columnname="first_string"/><columnname="second_string"/></property>
注意使用
<column>
标签来把一个属性映射到多个字段的做法。
CompositeUserType
,EnhancedUserType
,UserCollectionType
和UserVersionType
接口为更特殊的使用方式提供支持。
你甚至可以在一个映射文件中提供参数给一个
UserType
。 为了这样做,你的UserType
必须实现org.hibernate.usertype.ParameterizedType
接口。为了给自定义类型提供参数,你可以在映射文件中使用<type>
元素。
<propertyname="priority"><typename="com.mycompany.usertypes.DefaultValueIntegerType"><paramname="default">0</param></type></property>
现在,
UserType
可以从传入的Properties
对象中得到default
参数的值。
如果你非常频繁地使用某一
UserType
,可以为他定义一个简称。这可以通过使用<typedef>
元素来实现。Typedefs 为一自定义类型赋予一个名称,并且如果此类型是参数化的,还可以包含一系列默认的参数值。
<typedefclass="com.mycompany.usertypes.DefaultValueIntegerType"name="default_zero"><paramname="default">0</param></typedef>
<propertyname="priority"type="default_zero"/>
也可以根据具体案例通过属性映射中的类型参数覆盖在 typedef 中提供的参数。
尽管 Hibernate 内建的丰富的类型和对组件的支持意味着你可能很少需要使用自定义类型。不过,为那些在你的应用中经常出现的(非实体)类使用自定义类型也是一个好方法。例如,一个
MonetaryAmount
类使用CompositeUserType
来映射是不错的选择,虽然他可以很容易地被映射成组件。这样做的动机之一是抽象。使用自定义类型,以后假若你改变表示金额的方法时,它可以保证映射文件不需要修改。