Hibernate框架入门

导读

本文主要介绍hibernate的入门，主要包括以下内容：hibernate介绍、hibernate环境搭建、hibernate简单测试、测试涉及的api详解。

一、hibernate介绍

JDBC是Java操作数据库的工具，我们可以使用jdbc来书写并执行sql语句来操作数据库，对于普通的业务，jdbc工具是完全可以胜任的，但但当任务复杂，特别是数据库中表格很多的时候，jdbc就会显得力不从心，代码复用率低且sql语句容易出错。

Hibernate框架从jdbc面向过程操作数据库的过程转变为面向对象来操作数据库。其原理是ORM编程，即Object Relational Mapping(对象关系映射)。每一个数据库表对应一个实体类，这个实体类通过映射关系来操作这个数据库表，映射可以理解为平常我们所说的函数，如y=f(x);y是数据库中的表，x是实体类，f(x)即映射关系，我们通过操作x可以改变y值，同样的操作实体类便可以达到操作数据库的目的，这就是通过面向对象方式来操作数据库。

二、hibernate环境搭建

hibernate的环境搭建包括以下部分：1、导入运行环境需要的jar包；2、创建数据库表和对应的实体类；3、编写表和实体之间的映射关系（也叫orm元数据）；4、编写主配置文件hibernate.cfg.xml

1、导包

搜索下载压缩包：hibernate-release-5.0.7.Final.zip就可以找到相应的jar包：

注：不要忘了导入数据库驱动包（这里我使用的是mysql数据库），所以还需导入：

2、创建数据库表和实体类

这里假设我们创建了user表：

CREATE TABLE `user` (
`uid` bigint(32) NOT NULL AUTO_INCREMENT,
`uname` varchar(32) NOT NULL,
PRIMARY KEY (`uid`)
)

实体类：User

 package domain;
 public class User {
     private Long uid;
     private String uname;

     public Long getUid() {
         return uid;
     }
     public void setUid(Long uid) {
         this.uid = uid;
     }
     public String getUname() {
         return uname;
     }
     public void setUname(String uname) {
         this.uname = uname;
     }
     @Override
     public String toString() {
         return "User [uid=" + uid + ", uname=" + uname + "]";
     }
 }

3、编写表和实体之间的映射关系（orm元数据）

1）导入dtd约束

hibernate框架使用的是xml文件作为配置文件，所以在编写xml文件之前需要先导入dtd约束（该约束文件也在上面使用到的压缩包里）

导入方式：eclipse-->Preferences-->xml-->XML Catalog-->add

两个文件都添加完成后你的eclipse中有了这个dtd约束了，如果你的eclipse已经有了该dtd约束上面的步骤就可以忽略。

2）配置映射关系:User.hbm.xml

一般该文件的命名格式为（当然你可以随意命名）：类名.hbm.xml。且放在和该实体类同一个目录下。

xml简写版：

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

     <hibernate-mapping package="domain" >

     <class name="User" table="user" >
         <id name="uid"  >
             <generator class="native"></generator>
         </id>

     <property name="uname" column="uname" ></property>
     </class>
 </hibernate-mapping>

xml注释版：

 <?xml version="1.0" encoding="UTF-8"?>
 <!-- 1、导入dtd约束 -->
 <!DOCTYPE hibernate-mapping PUBLIC
     "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
     "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">

 <!-- 2、ORM元数据：配置表与实体对象的关系（映射关系） -->

    <!-- package属性:填写一个包名.在元素内部凡是需要书写完整类名的属性,可以直接写简答类名了. -->
     <hibernate-mapping package="domain" >

     <!--
         2.1 class元素: 配置实体与表的对应关系的
             name: 完整类名
             table:数据库表名
      -->
     <class name="User" table="user" >
         <!-- id元素:配置主键映射的属性
                 name: 填写主键对应属性名
                 column(可选): 填写表中的主键列名.默认值:列名会默认使用属性名
                 type(可选):填写列(属性)的类型.hibernate会自动检测实体的属性类型.
                         每个类型有三种填法: java类型|hibernate类型|数据库类型
                 not-null(可选):配置该属性(列)是否不能为空. 默认值:false
                 length(可选):配置数据库中列的长度. 默认值:使用数据库类型的最大长度
          -->
         <id name="uid"  >
             <!-- generator:主键生成策略(明天讲) -->
             <generator class="native"></generator>
         </id>
         <!-- 2.2property元素:除id之外的普通属性映射
                 name: 填写属性名
                 column(可选): 填写列名
                 type(可选):填写列(属性)的类型.hibernate会自动检测实体的属性类型.
                         每个类型有三种填法: java类型|hibernate类型|数据库类型
                 not-null(可选):配置该属性(列)是否不能为空. 默认值:false
                 length(可选):配置数据库中列的长度. 默认值:使用数据库类型的最大长度
          -->
         <property name="uname" column="uname" ></property>
     </class>
 </hibernate-mapping>

4、编写主配置文件

主配置文件一般是整体环境的配置一些数据库操作设置。主要分为：1、必要配置：数据库驱动等配置；2、可选配置；3、引入orm元数据：指定要操作的关系映射。

一般主配置文件都以hibernate.xfg.xml来命名（这样我们在使用时可以直接使用无参方法调用，比较方便）。且需要将文件放到src目录下。

hebernate.cfg.xml简写版:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-configuration PUBLIC
    "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
    "http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
    <session-factory>
        <!--
        #hibernate.dialect org.hibernate.dialect.MySQLDialect
        #hibernate.dialect org.hibernate.dialect.MySQLInnoDBDialect
        #hibernate.dialect org.hibernate.dialect.MySQLMyISAMDialect
        #hibernate.connection.driver_class com.mysql.jdbc.Driver
        #hibernate.connection.url jdbc:mysql:///test
        #hibernate.connection.username gavin
        #hibernate.connection.password
        <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">root</property>
        <property name="hibernate.connection.password">password</property>
        <property name="hibernate.dialect">org.hibernate.dialect.MySQLDialect</property>

        <property name="hibernate.show_sql">true</property>
        <property name="hibernate.format_sql">true</property>

        <property name="hibernate.hbm2ddl.auto">update</property>

        <mapping resource="domain/User.hbm.xml" />

    </session-factory>
</hibernate-configuration>

hebernate.cfg.xml注释版：

 <?xml version="1.0" encoding="UTF-8"?>
 <!-- 导入约束 -->
 <!DOCTYPE hibernate-configuration PUBLIC
     "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
     "http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">
 <!-- 主配置文件 -->
 <hibernate-configuration>
     <session-factory>
         <!--
         #hibernate.dialect org.hibernate.dialect.MySQLDialect
         #hibernate.dialect org.hibernate.dialect.MySQLInnoDBDialect
         #hibernate.dialect org.hibernate.dialect.MySQLMyISAMDialect
         #hibernate.connection.driver_class com.mysql.jdbc.Driver
         #hibernate.connection.url jdbc:mysql:///test
         #hibernate.connection.username gavin
         #hibernate.connection.password
          -->
          <!-- 数据库驱动 -->
         <property name="hibernate.connection.driver_class">com.mysql.jdbc.Driver</property>
          <!-- 数据库url -->
         <property name="hibernate.connection.url">jdbc:mysql:///hibernate</property>
          <!-- 数据库连接用户名 -->
         <property name="hibernate.connection.username">root</property>
          <!-- 数据库连接密码 -->
         <property name="hibernate.connection.password">password</property>
         <!-- 数据库方言
             不同的数据库中,sql语法略有区别. 指定方言可以让hibernate框架在生成sql语句时.针对数据库的方言生成.
             sql99标准: DDL 定义语言  库表的增删改查
                       DCL 控制语言  事务 权限
                       DML 操纵语言  增删改查
             注意: MYSQL在选择方言时,请选择最短的方言.
          -->
         <property name="hibernate.dialect">org.hibernate.dialect.MySQLDialect</property>

         <!-- #hibernate.show_sql true
              #hibernate.format_sql true
         -->
         <!-- 将hibernate生成的sql语句打印到控制台 -->
         <property name="hibernate.show_sql">true</property>
         <!-- 将hibernate生成的sql语句格式化(语法缩进) -->
         <property name="hibernate.format_sql">true</property>
         <!--
         ## auto schema export  自动导出表结构. 自动建表
         #hibernate.hbm2ddl.auto create        自动建表.每次框架运行都会创建新的表.以前表将会被覆盖,表数据会丢失.(开发环境中测试使用)
         #hibernate.hbm2ddl.auto create-drop 自动建表.每次框架运行结束都会将所有表删除.(开发环境中测试使用)
         #hibernate.hbm2ddl.auto update(推荐使用) 自动生成表.如果已经存在不会再生成.如果表有变动.自动更新表(不会删除任何数据).
         #hibernate.hbm2ddl.auto validate    校验.不自动生成表.每次启动会校验数据库中表是否正确.校验失败.
          -->
         <property name="hibernate.hbm2ddl.auto">update</property>
         <!-- 引入orm元数据
             路径书写: 填写src下的路径
          -->
         <mapping resource="domain/User.hbm.xml" />

     </session-factory>
 </hibernate-configuration>

到这里我们的hibernate环境就搭建完成了，刚开始感觉很多，用多了其实就很可以很快copy这些文件然后改改就o了。

三、hibernate简单测试

1)Demo测试类：

 package test;

 import org.hibernate.Session;
 import org.hibernate.SessionFactory;
 import org.hibernate.Transaction;
 import org.hibernate.cfg.Configuration;
 import org.junit.Test;

 import domain.User;

 public class Demo {

     @Test
     //使用hibernate框架，通过操作User对象往user表中插入一条数据。
     public void addUser(){
         //操作涉及的核心类
         Configuration config = new Configuration().configure();
         SessionFactory factory = config.buildSessionFactory();
         Session session = factory.openSession();
         Transaction tx = session.beginTransaction();

         //操作User
         //-----------------------
         User user = new User();
         user.setUid(1l);
         user.setUname("张三");

         session.save(user);//执行
         //-----------------------

         //关闭资源
         tx.commit();
         session.close();
         factory.close();
     }

2）执行结果：

四、测试涉及的api详解

 //1 创建,调用空参构造
 Configuration conf = new Configuration().configure();
 //2 根据配置信息,创建 SessionFactory对象
 SessionFactory sf = conf.buildSessionFactory();
 //3 获得session
 Session session = sf.openSession();
 //4 session获得操作事务的Transaction对象
 //获得操作事务的tx对象
 Transaction tx = session.getTransaction();
 tx.begin();
 //开启事务并获得操作事务的tx对象(建议使用)
 Transaction tx2 = session.beginTransaction();
 //----------------------------------------------
 //1 获得要修改的对象
User u = session.get(User.class, 1l);
 //2 调用delete删除对象
 session.delete(u);
 //----------------------------------------------
 tx2.commit();//提交事务
 session.close();//释放资源
 sf.close();//释放资源

除了虚线//-----------------之间的操作部分，上下两部分一般都是固定不变的。所以我们可以使用工具类进行抽取，以提高代码复用率：

HibernateUtils:

 package utils;

 import org.hibernate.HibernateException;
 import org.hibernate.Session;
 import org.hibernate.SessionFactory;
 import org.hibernate.cfg.Configuration;

 public class HibernateUtils {

     // 会话工厂，以单例方式管理
     private static SessionFactory sessionFactory;

     // ThreadLocal存储session
     private static ThreadLocal<Session> session = new ThreadLocal<Session>();

     // 以单例方式管理sessionFactory
     static {
         try {
             sessionFactory = new Configuration().configure("hibernate.cfg.xml").buildSessionFactory();
         } catch (HibernateException e) {
             e.printStackTrace();
             throw new HibernateException("初始化会话工厂失败！");
         }

     }
     //得到一个单例的会话工厂
     public static SessionFactory getSessionFactory(){
         return sessionFactory;
     }
     //获取一个新session
     public static Session openSession(){
         return sessionFactory.openSession();
     }

     public static Session getCurrentSession() throws HibernateException {
         return sessionFactory.getCurrentSession();
     }

     public static void closeSession() throws HibernateException {
         sessionFactory.getCurrentSession().close();
     }

 }