第一个 Hibernate 应用程序

首先需要下载 HIbernate 的开发包，此处下载的是hibernate-release-5.0.7.Final版本，打开文件后发现有以下三个目录：

• documentation：存放了 API 及其它开发中用到的文档
• lib：存放了 Hibernate 所用到的 jar 包，其中required文件夹下存放的是 Hibernate 开发所必须的依赖包，optional文件夹下存放的是可选的 jar 包，比如 C3P0 连接池包等。
• project：Hibernate 提供的开发样例项目，其内部有一个etc的文件夹，存放了几个核心配置文件的样例，在开发新项目时，可以用来进行拷贝，然后在此基础上进行修改。

新建一个 Java 项目

第一步：尽管 Hibernate 通常在 B/S 架构的企业级项目中，但它一个纯 Java 的程序，所以这里新建一个普通的 Java 项目即可。然后引入相关的 jar 包到lib目录下，再将其编译到项目的classpath路径下即可。需要导入的包有：

• 对应数据库的驱动包
• Hibernate 核心 jar 包

第二步：新建一个实体类，该类必须有过一个 id 属性，作为对象标识符而存在。因为Java 语言中是以内存中的地址来区分不同的对象，而数据库中又是以主键来区分不同的记录，那 Hibernate 如何保证两者的统一呢？就是通过维护一个 OID (对象标识符)属性来解决这种冲突的，所以这也算是 Hibernate 对 POJO 的一种侵入吧，当然这也是不仅可避免的。

第三步：创建对象映射文件，默认是以类名.hbm.xml的方式命名，且放在和类对应的包下，这样方便维护。而且在编译阶段，该文件会被拷贝到bin目录下，映射文件具体内容到后面总结，反正它定义了如何将 POJO 类映射成数据库中的表。

第四步：创建 Hibernate 的核心配置文件，放在src目录下，该文件必须命名为hibernate.cfg.xml，该文件用来定义数据库连接的信息和一些 Hibernate 运行时所需要的信息，比如 POJO 类映射文件的路径等。

第五步：编写测试代码，如下：

// 1.加载Hibernate的核心配置文件
Configuration configuration = new Configuration().configure();
// 2.创建一个SessionFactory对象：类似于JDBC中连接池
SessionFactory sessionFactory = configuration.buildSessionFactory();
// 3.通过SessionFactory获取到Session对象：类似于JDBC中Connection
Session session = sessionFactory.openSession();
// 4.手动开启事务：
Transaction transaction = session.beginTransaction();
// 5.编写代码
Customer customer = new Customer();
customer.setCust_name("王西");
session.save(customer);
// 6.事务提交
transaction.commit();
// 7.资源释放
session.close();

Hibernate 的核心配置文件

Hibernate 的配置文件包含了数据库连接和映射文件的基本信息，其配置文件有两种格式，具体如下：

• 一种是以hibernate.properties命名的属性文件格式的配置文件，它使用键值对来存储信息。
• 另一种是以hibernate.cfg.xml方式命名的配置文件

以上两种配置文件的方式是等价的，但是推荐使用 XML 格式的配置文件。因为它更易于修改，配置能力更强，而且能够直接引入 POJO 类的映射文件。而 properties 属性文件是不能直接引入配置文件的，需要通过手动编码加载映射文件，不推荐使用。

核心配置文件中主要有三个部分的内容：

• 必要的数据库连接信息并指定数据库方言
• 可选的配置，比如自动建表，控制台显示 SQL 语句等
• POJO 类对应的映射文件的引入

hibernate.cfg.xml文件内容如下：

<hibernate-configuration>
    <session-factory>
        <!-- 连接数据库的基本参数 -->
        <property name="hibernate.connection.driver_class">com.mysql.jdbc.Driver</property>
        <property name="hibernate.connection.url">jdbc:mysql:///hibernate</property>
        <property name="hibernate.connection.username">keqi</property>
        <property name="hibernate.connection.password">admin</property>
        <!-- 配置Hibernate的方言 -->
        <property name="hibernate.dialect">org.hibernate.dialect.MySQLDialect</property>
        
        <!-- 可选配置================ -->
        <!-- 打印SQL -->
        <property name="hibernate.show_sql">true</property>
        <!-- 格式化SQL -->
        <property name="hibernate.format_sql">true</property>
        <!-- 自动创建表 -->
        <property name="hibernate.hbm2ddl.auto">update</property>
    
        <mapping resource="com/hibernate/demo1/Customer.hbm.xml"/>
    </session-factory>
</hibernate-configuration>

需要补充的一点是关于hibernate.hbm2ddl.auto自动建表的属性有以下 5 个，这在project/etc目录下都可以找到，分别是：

• none：不允许 Hibernate 自动建表，默认是不建表的
• create：表示如果数据库中已经有对应的表，就删除原表，再重新创建表
• create-drop：表示数据库中已经有对应的表，就删除原来表，再重新建表，当关闭 SessionFactory 工厂的时候，就会把新建的表再次删除。这种特性，方便用来进行测试。
• update：表示如果数据库中已经有表，就在原有表的基础行进行操作，没有就新建一个表
• validata：并不会新建表，它是专门用来校验映射和表结构的

Hibernate 的映射配置文件

该文件用于向 Hibernate 提供 POJO 类和数据库表的映射信息，Hibernate 是通过它来决定如何去创建数据库表的。下面以一个Customer类来讲解如何配置映射文件。

Customer 类源码：

public class Customer{
    private Long cust_id;
    private String cust_name;
    private String cust_source;
    private String cust_industry;
    private String cust_level;
    private String cust_phone;
    private String cust_mobile;
    //省略getter&setter方法
}

Customer.hbm.xml映射文件内容如下：

<hibernate-mapping>
    <!-- 建立类与表的映射 -->
    <class name="com.hibernate.demo1.Customer" table="cst_customer">
        <!-- 建立类中的属性与表中的主键对应 -->
        <id name="cust_id" column="cust_id" >
            <generator class="native"/>
        </id>
        
        <!-- 建立类中的普通的属性和表的字段的对应 -->
        <property name="cust_name" column="cust_name" length="32" />
        <property name="cust_source" column="cust_source" length="32"/>
        <property name="cust_industry" column="cust_industry"/>
        <property name="cust_level" column="cust_level"/>
        <property name="cust_phone" column="cust_phone"/>
        <property name="cust_mobile" column="cust_mobile"/>
    </class>
</hibernate-mapping>

从上面可以看出<hibernate-mapping>标签下有一个<class>标签，这个标签下还有一个<id>标签和<property>。下面分别讲解：

<class>标签

该标签描述类和表的映射关系，有以下几个属性：

• name：填写类的全名
• table：指定类对应的表名，否则 Hibernate 就会默认创建一个和类名同名的表

<id>标签

建立类的属性和表中的主键的对应关系，它有一下几个属性：

• name：填写类中的 ID 名
• column：指定 ID 对应表中的主键名，否则 Hibernate 就会默认创建一个和 id 名同名的主键名
• length：指定列的长度，不指定就用该属性对应数据类型的默认长度
• type：指定表中的数据类型，否则Hibernate 会根据类属性的类型指定其默认对应的类型。一般不需要显示指定，因为 Hibernate 会自动完成这个工作。

<id>标签内部有个子标签<generator>用来指定主键生成策略。此标签的属性如下：

• class：指定主键生成策略，一般使用native，本地生成策略，即有数据库来决定如何生成主键。

<property>标签

该标签用来建立类中的普通属性和表中的列的对应关系。有几下一个常用的属性：

• name：填写类中的属性名
• column：指定表中的列名，否则 Hibernate 就会创建一个和属性名同名的列名
• length：指定列的长度，不指定就用该属性对应数据类型的默认长度
• type指定表中的数据类型，否则Hibernate 会根据类属性的类型指定其默认对应的类型。一般不需要显示指定，因为 Hibernate 会自动完成这个工作。