首先需要下载 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 会自动完成这个工作。