Hibernate映射之实体映射

1.使用@注解配置实体类

实体类一般有ID、普通属性、集合属性等，分别对应数据库的主键、普通列、外键。@注解配置中，实体类用@Entity注解，用@Table指定对应的数据表，用@Id配置主键，用@Column配置普通属性，用@OneToMany、@ManyToOne、@OneToOne、@ManyToMany配置实体间关系等。实体类之间的关于在后面的章节中会做详细介绍。下面编写一个UsersVo类，在该类中使用@注解配置实体类的映射，UsersVo类的代码如下：

package com.cn.vo;

import javax.persistence.*;

@Entity // 注解Entity表示该类纳入Hibernate管理，能够被持久化

@Table(name = "users") // 指定该实体类对应的数据库表名

public class UsersVo {

//  Fields

@Id // 指定该列为主键。

 // 这个注解用来表示主键类型, auto为数据库自增长类型

@GeneratedValue(strategy = GenerationType.AUTO)

private int id;

@Column(name = "name") //指定变量对应的数据库表的列为"name"

private String name;

@Column(name = "age")//指定变量对应的数据库表的列为"age"

private int age;

@Column(name = "tel")//指定变量对应的数据库表的列为"tel"

private String tel;

@Column(name = "address")//指定变量对应的数据库表的列为"address"

private String address;

}

2 使用XML文件配置实体类映射

多个实体类可以配置在一个XML文件中。Hibernate推荐XML映射文件和实体类同名，便于阅读和维护，比如UsersVo.java文件对应UsersVo. hbm.xml文件。XML文件一般以“.hbm.xml”结尾，便于辨认，也可以直接用“.xml”结尾。例如UsersVo类的映射文件可取名为“UsersVo.hbm.xml”或者“UsersVo.xml”。使用XML文件配置实体类映射的时候，实体类和普通的实体类一样，和数据库的映射关系放在XML文件中，UsersVo. hbm.xml文件代码如下：

<?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">

<!--

    Mapping file autogenerated by MyEclipse Persistence Tools

-->

<hibernate-mapping>

<!--  name=””用来指定实体类， table="”用来指定数据库表格 catalog表示连接的数据库 lazy表示延迟加载 -->

    <class name="com.cn.vo.UsersVo" table="users" catalog="bank" lazy="false">

        <id name="id" type="java.lang.Integer"><!--  配置实体类变量-->

            <column name="id" /><!--  主键的字段名  -->

            <generator class="assigned" /><!-- 主键 类型，这里设置成不主动增长 -->

        </id>

        <property name="name" type="java.lang.String"><!--  配置实体类变量-->

            <column name="name" length="20" /><!--  数据库的字段名和字段长度  -->

    </class>

</hibernate-mapping>

代码中的DOCTYPE指定的dtd文件位于hibernate.jar中。dtd文件为XML格式验证文件，Hibernate使用该dtd来验证该XML文件格式是否正确。如果hibernate.jar或者classpath中不存在该dtd文件，Hibernate会到指定的URL下载该文件。

在上述的映射文件中，<class>中的name表示实体类的路径和名称。table="”用来指定数据库表格 catalog表示连接的数据库 lazy表示延迟加载，<id>用来声明表的主键，<id>中的属性name="id"表示实体类的属性id。数据库对应的字段名放在<column>中，<column>中的name表示表中的字段名，<generator class="assigned" />表示数据库表的主键类型为默认的类型，默认的类型是不自动增长类型，在<property>中映射表中的其他字段，<property>中的name属性值表示实体类的属性，type表示实体类属性的类型。表字段的映射放在<column>中，name的值是字段名，length表示字段长度。

3 在hibernate.cfg.xml文件中配置实体类映射

实体类还需要配置到hibernate.cfg.xml中，以便Hibernate初始化实体类与数据库表的映射关系。如果只配置了映射关系，而没有配置到hibernate.cfg.xml中，Hibernate是无法解析实体类的，因为Hibernate无法自行判断哪些是实体类。

如果实体类是使用@注解配置的，需要用<mapping class=””/>配置，而如果是用XML文件配置的，需要用<mapping resource=””/>配置XML配置文件。hibernate.cfg.xml文件中配置实体类映射的示例代码如下：

<!-- 使用XML映射文件映射实体类的配置 -->

<mapping resource="com/cn/vo/UsersVo.hbm.xml"/>

<mapping resource="com/cn/vo/DeptVo.hbm.xml"/>

<!-- 使用@注解映射实体类的配置 -->

<mapping class="com.cn.vo.UsersVo "/>

<mapping class="com.cn.vo.DeptVo "/>

4 配置主键映射

实体类最好有主键列，并有对应的getter、setter方法，这是Hibernate推荐的。主键尽量使用可以为null值的类型，例如Integer、Long、String等，而不要使用int、long等。因为如果主键为null，则表示该实体类还没有保存到数据库，是一个临时状态（Transient），而int、long等原始类型则不具备该功能。

1. 使用@注解配置主键

Hibernate中用@Id声明该列为主键列，同时用@Column声明该列的列名。当列名与属性名相同时，@Column配置可省略。@GeneratedValue用于指定主键的生成策略。Hibernate支持多种逐渐生成规则，例如自增长、由某个表决定、由Sequence决定等等。如果不配置@GeneratedValue，则必须手动设置ID值。

@Id

@Column(name = "id")

// 设置主键类型, auto表示主键是自增长类型

@GeneratedValue(strategy = GenerationType.AUTO)

private Integer id;

2. XML文件中配置主键

如果使用XML配置，主键用<id />配置，name指定实体类的主键属性，column指定数据表中的主键列名。使用嵌套的<generator />配置主键生成策略，native表示使用数据库自己的策略，在MySQL中就是自增长类型，如果不用自动增长类型，则可以用assigned，例如：

</id>

5. 使用@注解配置普通属性映射

这里说的普通属性，是指除了主键外的、Java基本类型的属性，Integer类型与int类型是不同的，Integer默认为null，在数据库中也表现为null，而int默认为0，在数据库中也表现为0。

普通属性使用@Column与@Basic配置。二者都可以省略。如果省略，则全部按照默认的规则配置，@Column与@Basic的用法如下：

q @Column中可指定nullable（是否允许为null）、unique（是否唯一）、insertable（是否允许插入）、updatable（是否允许更新）、length（列长度）、columnDefinition（列类型）、scale（整数长度）、precision（小数点精度）等。这些属性用于生成DDL建表语句。如果属性对应的列名与属性名一致，@Column可以省略。

q @Basic可为普通属性配置加载方式，默认为即时加载。如果列数据比较大，例如大文本类型或者LOB类型，可配置为延迟加载。optional配置该列是否可为null。如果为true，表示该属性是可选的，可以为null，否则不可以为null。

@Column与@Basic使用的代码示例如下：

@Column(name = "usersName", nullable = true, columnDefinition = "varchar", insertable = true, length = 255, unique = true, updatable = true, precision = 2, scale = 4)

@Basic(fetch = FetchType.LAZY, optional=true)

private String usersName;

日期属性也是普通的属性，需要用@Basic声明加载方式、@Column等指定列名，二者都可省略。另外，如果日期属性是java.util.Date类型的，必须要用@Temporal配置日期类型，取值可以为Date、Time或者Timestemp。否则Hibernate将无法区分该类型是到底是java.sql.Date（只有年月日等日期信息）类型还是java.sql.Time（只有时分秒等时间信息）类型、还是java.sql.TimeStamp（既有日期信息、又有时间信息）类型。例如：

@Temporal(TemporalType.TIMESTAMP) // 日期类型为DATE, TIME或者TIMESTEMP。

@Column(name = " birthday")

private java.util.Date birthday;

在配置日期属性时，如果属性类型是java.util.Date类型，需要用@Temporal声明日期类型。但是如果是java.sql.Time、java.sql.Date或者java.sql.TimeStamp类型的，类型本身就已经很明确了，不再需要@Temporal声明了。