3.HIbernate的基本映射

实体类－－表

实体类中的普通属性－－表字段

 

采用<class>标签映射数据库表，通过<porperty>标签将普通属性映射成表字段。

所谓普通属性指不包括自定义类、集合、数组等。

 

注意：如果实体类和实体类的属性和SQL中的关键字重复，必须使用table或column重新命名。

 

实体类的设计原则：

(1):实现一个默认的（即无参数的）构造方法（constructor）

(2):提供一个标识属性（identifier property）（可选）

(3): 使用非final的类 (可选)

(4):为持久化字段声明访问器(accessors)和是否可变的标志(mutators)(可选)

 

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">

<hibernate-mapping package="com.tao.hibernate">
	<class name="Student" table="student" schema="jpa">
		<id name="id" type="java.lang.Integer" column="id">
			<generator class="native" />
		</id>
		<property name="name" type="java.lang.String">
			<column name="name" length="16" />
		</property>
	</class>
</hibernate-mapping>

 

详细介绍：

一：<hibernate-mapping>标签：

<hibernate-mapping
	auto-import="true|false"
	package="package.name"
 />

 

(1):package (可选): 指定一个包前缀，如果在映射文档中没有指定全限定的类名， 就使用这个作为包名。

(2):auto-import(可选 - 默认为 true ):指定我们是否可以在查询语言中使用非全限定的类名（仅限于本映射文件中的类）。

 

二：<class>标签：

<class
	name="ClassName"  
	table="tableName"        
	dynamic-update="true|false"
	dynamic-insert="true|false"       
	lazy="true|false"       
/>

 

(1):name (可选): 持久化类（或者接口）的Java全限定名。 如果这个属性不存在，Hibernate将假定这是一个非POJO的实体映射。

(2):table (可选 - 默认是类的非全限定名): 对应的数据库表名。

(3): dynamic-update (可选, 默认为 false ): 指定用于UPDATE 的SQL将会在运行时动态生成，并且只更新那些改变过的字段。

(4):dynamic-insert (可选, 默认为 false ): 指定用于INSERT 的 SQL 将会在运行时动态生成，并且只包含那些非空值字段。

(5):lazy (可选): 通过设置lazy="false" ， 所有的延迟加载（Lazy fetching）功能将被全部禁用（disabled）。

 

三：<id>标签：

<id
	name="propertyName" 
	type="typename"
	column="column_name"
	<generator class="generatorClass"/>
</id>

 

(1):name (可选): 标识属性的名字。

(2):type (可选): 标识Hibernate类型的名字。
(3):column (可选 - 默认为属性名): 主键字段的名字。

 

 

四：<generator>标签：

<id name="id" type="long" column="cat_id">
	<generator class="org.hibernate.id.TableHiLoGenerator">
		<param name="table">uid_table</param>
		<param name="column">next_hi_value_column</param>
	</generator>
</id>

 

(1):class：主键生成器的名称，Hibernate提供了很多内置的实现：

a.increment： 用于为long , short 或者int 类型生成 唯一标识。只有在没有其他进程往同一张表中插入数据时才能使用。 在集群下不要使用。

b.identity ：

         对DB2,MySQL, MS SQL Server, Sybase和HypersonicSQL的内置标识字段提供支持。 返回的标识符是long , short 或者int 类型的。

c.sequence ：

        在DB2,PostgreSQL, Oracle, SAP DB, McKoi中使用序列（sequence)， 而在Interbase中使用生成器(generator)。返回的标识符是long , short 或者 int 类型的。

d.uuid ：

        用一个128-bit的UUID算法生成字符串类型的标识符， 这在一个网络中是唯一的（使用了IP地址）。UUID被编码为一个32位16进制数字的字符串。

e.hilo ：

        使用一个高/低位算法高效的生成long , short 或者 int 类型的标识符。给定一个表和字段（默认分别是 hibernate_unique_key 和next_hi ）作为高位值的来源。 高/低位算法生成的标识符只在一个特定的数据库中是唯一的。

f.native ：

        根据底层数据库的能力选择identity , sequence 或者hilo 中的一个。

g.assigned ： 让应用程序在save() 之前为对象分配一个标示符。这是 <generator> 元素没有指定时的默认生成策略。

(2):param:生成器实例需要某些配置值或者初始化参数， 用<param> 元素来传递

 

五：<property>标签：

<property
        name="propertyName"
        column="column_name"
        type="typename"
        update="true|false"
        insert="true|false"
        lazy="true|false"
        unique="true|false"
        not-null="true|false"
        length="L"       
/>

(1):name : 属性的名字,以小写字母开头。

(2):column (可选 - 默认为属性名字): 对应的数据库字段名。 也可以通过嵌套的<column> 元素指定。

(3):type (可选): 一个Hibernate类型的名字。

(4):update, insert (可选 - 默认为 true ) : 表明用于UPDATE 和/或 INSERT 的SQL语句中是否包含这个被映射了的字段。这二者如果都设置为false 则表明这是一个“外源性（derived）”的属性，它的值来源于映射到同一个（或多个） 字段的某些其他属性，或者通过一个trigger(触发器）或其他程序生成

(5):lazy (可选 - 默认为 false ): 指定 指定实例变量第一次被访问时，这个属性是否延迟抓取（fetched lazily）（ 需要运行时字节码增强）。

(6):unique (可选): 使用DDL为该字段添加唯一的约束。 同样，允许它作为property-ref 引用的目标。

(7):not-null (可选): 使用DDL为该字段添加可否为空（nullability）的约束。

(8):length (可选): 使用DDL为该字段指定长度。

 

 

 

<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC 
	"-//Hibernate/Hibernate Mapping DTD 3.0//EN"
	"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<hibernate-mapping>
	<class name="com.bjsxt.hibernate.FiscalYearPeriod" table="t_fiscal_year_period">
		<composite-id name="fiscalYearPeriodPK">
			<key-property name="fiscalYear"/>
			<key-property name="fiscalPeriod"/>	
		</composite-id>
		<property name="beginDate"/>
		<property name="endDate"/>
		<property name="periodSts"/>
	</class>
</hibernate-mapping>

 

<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC 
	"-//Hibernate/Hibernate Mapping DTD 3.0//EN"
	"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<hibernate-mapping>
	<class name="com.bjsxt.hibernate.User" table="t_user">
		<id name="id">
			<generator class="native"/>
		</id>
		<property name="name"/>
		<component name="contact">
			<property name="email"/>
			<property name="address"/>
			<property name="zipCode"/>
			<property name="contactTel"/>
		</component>
	</class>
</hibernate-mapping>