Hibernate框架基础——Hibernate入门

Hibernate入门

Hibernate介绍

Hibernate是一个基于jdbc的开源的持久化框架，是一个优秀的ORM实现，它很大程度的简化了dao层编码工作。Hibernate对JDBC访问数据库的代码做了封装，大大简化了数据访问层繁琐的重复性代码。
在分层结构中处于持久化层，封装对数据库的访问细节，使业务逻辑层更专注于实现业务逻辑。
Hibernate的主页为：http://www.hibernate.org/。
Hibernate的下载地址为：http://hibernate.org/orm/downloads/。
HibernateTools的下载地址为：http://www.jboss.org/tools/download/。在Eclipse中如何安装Hibernate Tools插件，请参看Eclipse在线配置Hibernate Tools。
本人使用的是hibernate-release-4.3.11.Final。

Hibernate的体系结构与开发步骤

Hibernate的体系结构：

Hibernate开发步骤

1. 创建持久化类
2. 创建对象-关系映射文件
3. 创建Hibernate配置文件
4. 通过Hibernate API编写访问数据库的代码

第一个Hibernate程序（HelloWorld）

创建Eclipse工程并引入相关的jar包

新建Java工程，并添加如下jar包：

1. {hibernate_home}/lib/required/*.jar
2. 数据库对应的JDBC驱动（例如mysql-connector-java-5.1.38-bin.jar）

还可以加入日志相关的jar包（不加也可以）：

1. log4j-1.x.x.jar
2. slf4j-log4j12-1.x.x.jar

创建持久化对象：User.java

在cn.itcast.a_helloworld包下创建User类，代码如下：

/**
 * 实体
 */
public class User {
    private int id;
    private String name;

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    @Override
    public String toString() {
        return "[User: id=" + id + ", name=" + name + "]";
    }

}

创建对象-关系映射文件：User.hbm.xml

首先在MySQL数据库里面创建一个t_user表，建表语句如下：

create database hibernate_20160926 default character set utf8;
use hibernate_20160926;
create table t_user( id int primary key auto_increment, name varchar(20) );

t_user表创建好之后，我们就要创建相对应的对象-关系映射文件：User.hbm.xml了，注意该映射配置文件与User类要在一起，即同一个包下。

<hibernate-mapping package="cn.itcast.a_helloworld">
    <class name="User" table="t_user">
        <id name="id" type="int" column="id">
            <generator class="native"/>
        id>
        <property name="name" type="string" column="name" />
    class>
hibernate-mapping>

关于此映射配置文件中的内容后面会慢慢详解。

创建Hibernate配置文件：hibernate.cfg.xml

我们要在类路径下(即src目录下)创建Hibernate配置文件——hibernate.cfg.xml。
初学者第一次学习Hibernate框架，肯定是不知道如何编写Hibernate配置文件的，但我们可以在{hibernate_home}/project/etc目录下找到开发包给我们提供的Hibernate配置文件，我们只须要拷贝进我们的项目，然后修修改改就可以了。
这样我们的Hibernate配置文件——hibernate.cfg.xml的内容就为：

<hibernate-configuration>
    <session-factory name="foo">
        
        
        <property name="dialect">org.hibernate.dialect.MySQLDialectproperty>
        <property name="connection.url">jdbc:mysql:///hibernate_20160926property>
        <property name="connection.driver_class">com.mysql.jdbc.Driverproperty>
        <property name="connection.username">rootproperty>
        <property name="connection.password">yeziproperty>

        
        
        <property name="hibernate.show_sql">trueproperty>

        
        <mapping resource="cn/itcast/a_helloworld/User.hbm.xml" />

    session-factory>
hibernate-configuration>

关于此配置文件中的内容后面会慢慢详解。

通过Hibernate API编写访问数据库的代码

编程步骤：

1. 获取Configuration对象
2. 获取SessionFactory对象
3. 获取Session，打开事务
4. 用面向对象的方式操作数据库
5. 关闭事务，关闭Session

由于是Hibernate入门，所以我不会搞得很复杂，就只是简单的向hibernate_20160926数据库中的t_user表中插入一条记录，然后再取出来而已。
我们在cn.itcast.a_helloworld包下创建一个App类，为了方便测试，我使用的是单元测试。

public class App {

    private static SessionFactory sessionFactory;

    static {
        Configuration cfg = new Configuration();
        cfg.configure("hibernate.cfg.xml"); // 读取指定的主配置文件
        sessionFactory = cfg.buildSessionFactory(); // 根据配置生成Session工厂
    }

    @Test
    public void testSave() {
        User user = new User();
        user.setName("张三");

        // 保存
        Session session = sessionFactory.openSession(); // 打开一个新的Session
        Transaction tx = session.beginTransaction(); // 开启事务

        session.save(user);

        tx.commit(); // 提交事务
        session.close(); // 关闭Session，释放资源(不一定是真正的关闭)
    }

    @Test
    public void testGet() {
        Session session = sessionFactory.openSession();
        Transaction tx = session.beginTransaction();

        User user = (User) session.get(User.class, 1); // 获取？
        System.out.println(user);

        tx.commit();
        session.close();
    }
}

测试第一个Hibernate程序

编写完第一个Hibernate程序之后，我们就要来测试了，先测试向hibernate_20160926数据库中的t_user表中插入一条记录，发现报如下异常：

org.hibernate.engine.jndi.JndiException: Error parsing JNDI name [foo]
    at org.hibernate.engine.jndi.internal.JndiServiceImpl.parseName(JndiServiceImpl.java:141)
    at org.hibernate.engine.jndi.internal.JndiServiceImpl.bind(JndiServiceImpl.java:157)
    at org.hibernate.internal.SessionFactoryRegistry.addSessionFactory(SessionFactoryRegistry.java:103)
    at org.hibernate.internal.SessionFactoryImpl.(SessionFactoryImpl.java:497)
    at org.hibernate.cfg.Configuration.buildSessionFactory(Configuration.java:1859)
    at org.hibernate.cfg.Configuration.buildSessionFactory(Configuration.java:1930)
    at cn.itcast.a_helloworld.App.(App.java:16)
    at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)
    at sun.reflect.NativeConstructorAccessorImpl.newInstance(Unknown Source)
    at sun.reflect.DelegatingConstructorAccessorImpl.newInstance(Unknown Source)
    at java.lang.reflect.Constructor.newInstance(Unknown Source)
    at org.junit.runners.BlockJUnit4ClassRunner.createTest(BlockJUnit4ClassRunner.java:217)
    at org.junit.runners.BlockJUnit4ClassRunner$1.runReflectiveCall(BlockJUnit4ClassRunner.java:266)
    at org.junit.internal.runners.model.ReflectiveCallable.run(ReflectiveCallable.java:12)
    at org.junit.runners.BlockJUnit4ClassRunner.methodBlock(BlockJUnit4ClassRunner.java:263)
    at org.junit.runners.BlockJUnit4ClassRunner.runChild(BlockJUnit4ClassRunner.java:78)
    at org.junit.runners.BlockJUnit4ClassRunner.runChild(BlockJUnit4ClassRunner.java:57)
    at org.junit.runners.ParentRunner$3.run(ParentRunner.java:290)
    at org.junit.runners.ParentRunner$1.schedule(ParentRunner.java:71)
    at org.junit.runners.ParentRunner.runChildren(ParentRunner.java:288)
    at org.junit.runners.ParentRunner.access$000(ParentRunner.java:58)
    at org.junit.runners.ParentRunner$2.evaluate(ParentRunner.java:268)
    at org.junit.runners.ParentRunner.run(ParentRunner.java:363)
    at org.eclipse.jdt.internal.junit4.runner.JUnit4TestReference.run(JUnit4TestReference.java:86)
    at org.eclipse.jdt.internal.junit.runner.TestExecution.run(TestExecution.java:38)
    at org.eclipse.jdt.internal.junit.runner.RemoteTestRunner.runTests(RemoteTestRunner.java:459)
    at org.eclipse.jdt.internal.junit.runner.RemoteTestRunner.runTests(RemoteTestRunner.java:675)
    at org.eclipse.jdt.internal.junit.runner.RemoteTestRunner.run(RemoteTestRunner.java:382)
    at org.eclipse.jdt.internal.junit.runner.RemoteTestRunner.main(RemoteTestRunner.java:192)
Caused by: javax.naming.NoInitialContextException: Need to specify class name in environment or system property, or as an applet parameter, or in an application resource file:  java.naming.factory.initial
    at javax.naming.spi.NamingManager.getInitialContext(Unknown Source)
    at javax.naming.InitialContext.getDefaultInitCtx(Unknown Source)
    at javax.naming.InitialContext.getURLOrDefaultInitCtx(Unknown Source)
    at javax.naming.InitialContext.getNameParser(Unknown Source)
    at org.hibernate.engine.jndi.internal.JndiServiceImpl.parseName(JndiServiceImpl.java:135)
    ... 28 more

错误原因：
在hibernate.cfg.xml文件内容的配置

"foo">
...

中添加了name属性。
解决办法：
去掉

"foo">
...

中的name属性。
修改之后，测试，通过，大发！

第二个Hibernate程序——完整的数据库操作(CRUD)

前面我们写了一个Hibernate入门的小程序，但也只是简单的向hibernate_20160926数据库中的t_user表中插入一条记录，然后再取出来而已。现在我们来写第二个Hibernate程序——实现对数据库完整的操作(CRUD)。
我们首先在cn.itcast.b_dao包下创建一个工具类——HibernateUtils.java，该工具类的作用专门用来获取全局唯一的SessionFactory，以及从全局唯一的SessionFactory中打开一个Session。

public class HibernateUtils {

    // SessionFactory全局只需要有一个就可以了，因为它的创建和销毁需要消耗大量的资源，初始化信息会比较多，并且它是线程安全的，可以在多线程的环境下使用它
    private static SessionFactory sessionFactory;

    static {
        // 初始化SessionFactory方式一：
        /*
        Configuration cfg = new Configuration(); // 代表配置文件的一个对象
        cfg.configure(); // 读取默认的配置文件(hibernate.cfg.xml)
        // cfg.configure("hibernate.cfg.xml"); // 读取指定位置的配置文件
        sessionFactory = cfg.buildSessionFactory();
        */

        // 初始化SessionFactory方式二：
        sessionFactory = new Configuration() //
                .configure() //
                .buildSessionFactory(); // 方法链
    }

    /**
     * 获取全局唯一的SessionFactory
     * 
     * @return
     */
    public static SessionFactory getSessionFactory() {
        return sessionFactory;
    }

    /**
     * 从全局唯一的SessionFactory中打开一个Session
     * 
     * @return
     */
    public static Session openSession() {
        return sessionFactory.openSession();
    }

}

思考一个问题，若我们要编写代码实现对数据库完整的操作，那么就必定涉及到分页查询，要实现分页查询，我们一定要弄清楚分页设计结构图，要是有人不知道，可翻阅我的记录客户关系管理系统之分页查询。所以我们还要在cn.itcast.b_dao包下创建一个类——QueryResult.java，用于封装查询结果。

public class QueryResult {

    private int count; // 总记录数
    private List list; // 一页的数据

    public QueryResult(int count, List list) {
        this.count = count;
        this.list = list;
    }

    public int getCount() {
        return count;
    }
    public void setCount(int count) {
        this.count = count;
    }
    public List getList() {
        return list;
    }
    public void setList(List list) {
        this.list = list;
    }

}

最后，我们在cn.itcast.b_dao包下创建一个类——UserDao.java。UserDao类里面编写代码实现对数据库完整的操作(CRUD)。

public class UserDao {

    /*
     * 保存
     */
    public void save(User user) {
        Session session = HibernateUtils.openSession();
        try {
            Transaction tx = session.beginTransaction(); // 开启事务
            session.save(user);
            tx.commit(); // 提交事务
        } catch (RuntimeException e) {
            session.getTransaction().rollback(); // 回滚事务
            throw e;
        } finally {
            session.close(); // 关闭session
        }
    }

    /*
     * 更新
     */
    public void update(User user) {
        Session session = HibernateUtils.openSession();
        Transaction tx = null;
        try {
            tx = session.beginTransaction();

            session.update(user);// 操作

            tx.commit();
        } catch (RuntimeException e) {
            tx.rollback();
            throw e;
        } finally {
            session.close();
        }
    }

    /*
     * 删除
     */
    public void delete(int id) {
        Session session = HibernateUtils.openSession();
        Transaction tx = null;
        try {
            tx = session.beginTransaction();

            Object user = session.get(User.class, id); // 要先获取到这个对象
            session.delete(user); // 删除的是实体对象

            tx.commit();
        } catch (RuntimeException e) {
            tx.rollback();
            throw e;
        } finally {
            session.close();
        }
    }

    /*
     * 根据id查询一个User数据
     */
    public User getById(int id) {
        Session session = HibernateUtils.openSession();
        Transaction tx = null;
        try {
            tx = session.beginTransaction();
            User user = (User) session.get(User.class, id);// 操作
            tx.commit();
            return user;
        } catch (RuntimeException e) {
            tx.rollback();
            throw e;
        } finally {
            session.close();
        }
    }

    /*
     * 查询所有
     */
    public List findAll() {
        Session session = HibernateUtils.openSession();
        Transaction tx = null;
        try {
            tx = session.beginTransaction();

            // 方式一：使用HQL语句
            List list = session.createQuery("FROM User").list(); // 使用HQL查询

            tx.commit();
            return list;
        } catch (RuntimeException e) {
            tx.rollback();
            throw e;
        } finally {
            session.close();
        }
    }

    /**
     * 分页的查询数据列表
     * @param firstResult 从结果列表中的哪个索引开始取数据
     * @param maxResults 最多取多少条数据
     * @return 一页的数据列表
     */
    @SuppressWarnings("unchecked")
    public QueryResult findAll(int firstResult, int maxResults) {
        Session session = HibernateUtils.openSession();
        Transaction tx = null;
        try {
            tx = session.beginTransaction();
            // 查询一页的数据列表
            // 方式一：
            // Query query = session.createQuery("FROM User");
            // query.setFirstResult(firstResult);
            // query.setMaxResults(maxResults);
            // List list = query.list(); // 使用HQL查询

            // 方式二：方法链
            List list = session.createQuery( //
                    "FROM User") //
                    .setFirstResult(firstResult) // 
                    .setMaxResults(maxResults) //
                    .list();

            // 查询总记录数
            // session.createQuery("SELECT COUNT(*) FROM User").list().get(0);
            // Long count = (Long) session.createQuery("SELECT COUNT(*) FROM User").uniqueResult();
            Long count = (Long) session.createQuery( //
                    "SELECT COUNT(*) FROM User") //
                    .uniqueResult();
            tx.commit();

            // 返回结果
            return new QueryResult(count.intValue(), list);
        } catch (RuntimeException e) {
            tx.rollback();
            throw e;
        } finally {
            session.close();
        }
    }

}

在如下两个方法中：

• public List findAll()
• public QueryResult findAll(int firstResult, int maxResults)

我们使用到了Hibernate查询语句——HQL(Hibernate Query Language)，后面将会详细讲解，这里稍微了解一下即可，我们只要会用就好。
HQL(Hibernate Query Language)与SQL相似，查询的是对象和对象中的属性，关键字不区分大小写，但类名与属性名区分大小写；而SQL查询的是表和表中的字段，同样也不区分大小写。
接下来，为方便测试，我们使用单元测试来测试以上编写的代码。我们只要右键点击UserDao类→New→JUnit Test Case，如下：

接下来会弹出如下对话框：

这是要帮我们自动创建UserDao测试类的节奏。
接着点击Next按钮，在弹出的对话框中选中我们要测试的UserDao类中的方法。

最后点击Finish完成，这时Eclipse就帮我们自动创建UserDao类的测试类
——UserDaoTest.java了，然后我们再在其中编写测试代码。

public class UserDaoTest {

    private UserDao userDao = new UserDao();

    @Test
    public void testSave_1() {
        User user = new User();
        user.setName("张三");

        // 保存
        userDao.save(user);
    }

    @Test
    public void testGetById() {
        User user = userDao.getById(1);
        System.out.println(user);
    }

    @Test
    public void testUpdate() {
        // 从数据库中获取一条存在的数据
        User user = userDao.getById(1);
        user.setName("李四");
        // 更新
        userDao.update(user);
    }

    @Test
    public void testDelete() {
        userDao.delete(1);
    }

    // -------------------------

    @Test
    public void testSave_25() {
        for (int i = 1; i <= 25; i++) {
            User user = new User();
            user.setName("test_" + i);

            userDao.save(user); // 保存
        }
    }

    @Test
    public void testFindAll() {
        List list = userDao.findAll();
        for (User user : list) {
            System.out.println(user);
        }
    }

    @Test
    public void testFindAllIntInt() {
        // 查询
        // QueryResult qr = userDao.findAll(0, 10); // 第1页，每页10条
        // QueryResult qr = userDao.findAll(10, 10); // 第2页，每页10条
        QueryResult qr = userDao.findAll(20, 10); // 第3页，每页10条

        // 显示结果
        System.out.println("总记录数：" + qr.getCount());
        for (User user : (List) qr.getList()) {
            System.out.println(user);
        }

    }

}

测试，全部通过，大发！