( 转）Hibernate常用API

http://blog.csdn.net/yerenyuan_pku/article/details/65103203

可在度娘上摘抄如下文字：

Hibernate的核心类和接口一共有6个，分别为：Session、SessionFactory、Transaction、Query、Criteria和Configuration。这6个核心类和接口在任何开发中都会用到。

还记得上一篇文章讲的是《Hibernate的配置详解》，本文继续在其基础之上讲解Hibernate常用的API。

Configuration

Configuration类主要是用于加载Hibernate的核心配置文件。
为了和之前写的单元测试类——HibernateTest1.java相区分，我们这儿在cn.itheima.test包下再创建一个单元测试类——HibernateTest2.java。像之前写的这样的代码：

public class HibernateTest2 {

    @Test

    public void test1() {

        // 创建Configuration来加载配置文件

        Configuration config = new Configuration().configure();

        .......

    }

}

主要是加载src目录下的hibernate.cfg.xml配置文件。
如果现在有人标新立异，他不是将Hibernate的核心配置文件命名为hibernate.cfg.xml，而是将其命名为比如说是my.xml，假设该文件同样是位于src目录下。那么应该像这样加载该文件：

public class HibernateTest2 {

    @Test

    public void test1() {

        // 创建Configuration来加载配置文件

        Configuration config = new Configuration().configure("my.xml"); // 加载指定名称的配置文件

        .......

    }

}

可归纳为：

Configuration config=new Configuration().config(核心配置文件名称); // 加载指定名称的配置文件

但我们又何必这么写昵？你说是不是？
由于我们将实体类(Customer.java)的映射配置文件配置在Hibernate的核心配置文件中：

<hibernate-configuration>

    <session-factory>

        ......

        <!-- 配置hibernate的映射文件所在的位置 -->

        <mapping resource="cn/itheima/domain/Customer.hbm.xml" />

    </session-factory>

</hibernate-configuration>

所以在编写程序代码的时候，勿须手动加载映射配置文件——Customer.hbm.xml。映射配置文件一般情况下是放置在实体类所在包下的，但是不这样做也是可以的，因为可以指定路径。所以即使在Hibernate的核心配置文件中没有映射文件的配置，也是可以手动加载映射配置文件的。

public class HibernateTest2 {

    // 测试手动加载映射配置文件

    @Test

    public void test1() {

        // 1.创建Configuration来加载配置文件

        Configuration config = new Configuration().configure();

        // 手动加载映射

        config.addResource("cn/itheima/domain/Customer.hbm.xml"); // 直接加载映射配置文件

        // 2.得到SessionFactory

        SessionFactory sessionFactory = config.buildSessionFactory();

        // 3.得到Session

        Session session = sessionFactory.openSession();

        // 开启事务

        session.beginTransaction();

        Customer c = session.get(Customer.class, 1);

        System.out.println(c);

        // 事务提交

        session.getTransaction().commit();

        // 关闭Session

        session.close();

        // 关闭SessionFactory

        sessionFactory.close();

    }

}

当然了，我们还可以这样做：

public class HibernateTest2 {

    // 测试手动加载映射配置文件

    @Test

    public void test1() {

        // 1.创建Configuration来加载配置文件

        Configuration config = new Configuration().configure();

        // 手动加载映射

        config.addClass(Customer.class); // 这种方式它会直接在实体类所在包下查找规范的映射配置文件

        // 2.得到SessionFactory

        SessionFactory sessionFactory = config.buildSessionFactory();

        // 3.得到Session

        Session session = sessionFactory.openSession();

        // 开启事务

        session.beginTransaction();

        Customer c = session.get(Customer.class, 1);

        System.out.println(c);

        // 事务提交

        session.getTransaction().commit();

        // 关闭Session

        session.close();

        // 关闭SessionFactory

        sessionFactory.close();

    }

}

只是这种情况下，Customer.hbm.xml映射配置文件须放置在实体类所在包下。
我们之前也说过对于Hibernate的核心配置文件它有两种方式：

hibernate.cfg.xml
hibernate.properties

假如Hibernate的核心配置文件采用的是hibernate.properties这种方式，那么如何加载该配置文件昵？

public class HibernateTest2 {

    @Test

    public void test1() {

        Configuration config = new Configuration();

        .......

    }

}

结论：

Configuration config=new Configuration(); // 主要加载的是src目录下的hibernate.properties配置文件

那么问题来了，我们是在hibernate.cfg.xml文件中有(映射)了xxx.hbm.xml文件的位置。但如果我们使用的是hibernate.properties这种核心配置文件，那么它又如何加载映射配置文件昵？不用我说，大家应该都知道了。

SessionFactory

首先SessionFactory它的获取是通过Configuration得到：

// 1.创建Configuration来加载配置文件

Configuration config = new Configuration().configure();

// 2.得到SessionFactory

SessionFactory sessionFactory = config.buildSessionFactory();

可在度娘上摘抄如下有关SessionFactory的文字：

SessionFactory接口负责初始化Hibernate。它充当数据存储源的代理，并负责创建Session对象。这里用到了工厂模式。需要注意的是SessionFactory并不是轻量级的，因为一般情况下，一个项目通常只需要一个SessionFactory就够，当需要操作多个数据库时，可以为每个数据库指定一个SessionFactory。

下面我们来着重分析以上这段话，我是从这几句话入手的。

它充当数据存储源的代理，并负责创建Session对象。

我们通过查看Hibernate的帮助文档，可发现通过SessionFactory可以得到Session有两种方式：

通过SessionFactory获得Session方式一：

注意：这是从连接池中获取一个连接。
通过SessionFactory获得Session方式二：

注意：这是获取一个与线程绑定的Session(即线程安全的Session)。

需要注意的是SessionFactory并不是轻量级的，因为一般情况下，一个项目通常只需要一个SessionFactory就够

我的理解——SessionFactory它不是轻量级的，所以不要频繁创建关闭它。在一个项目中有一个SessionFactory就可以了，通过SessionFactory来获取Session进行操作。那么问题来了，怎样可以保证在一个项目中所使用的SessionFactory是同一个哪？
可在cn.itheima.utils包下创建一个工具类——HibernateUtils.java，其代码为：

public class HibernateUtils {

    private static Configuration config;

    private static SessionFactory sessionFactory;

    static {

        config = new Configuration().configure();

        sessionFactory = config.buildSessionFactory();

    }

    public static Session openSession() {

        return sessionFactory.openSession();

    }

}

好了，来测试HibernateUtils工具类的使用吧！

public class HibernateTest2 {

    // 测试HibernateUtils工具使用

    @Test

    public void test2() {

        // 得到Session

        Session session = HibernateUtils.openSession();

        // 开启事务

        session.beginTransaction();

        Customer c = session.get(Customer.class, 1);

        System.out.println(c);

        // 事务提交

        session.getTransaction().commit();

        // 关闭Session

        session.close();

        // 注意：SessionFactory不要关闭，它开启就别关了，除非说你的项目结束了，否则，我们就不关闭它

    }

}

SessionFactory内部还维护了一个连接池，如果我们要想使用c3p0连接池，应该怎样做昵？也即在Hibernate中如何使用c3p0连接池？

我们要导入c3p0的相关jar包。
在lib/options下有关于c3p0连接池所需jar包，如下：

在hibernate.cfg.xml文件中配置c3p0连接池。

<property name="hibernate.connection.provider_class">org.hibernate.connection.C3P0ConnectionProvider</property>

<!-- C3P0连接池的配置  -->

<property name="hibernate.c3p0.max_size">20</property> <!-- 最大连接数 -->

<property name="hibernate.c3p0.min_size">5</property> <!-- 最小连接数 -->

<property name="hibernate.c3p0.timeout">120</property> <!-- 超时时间 -->

<property name="hibernate.c3p0.idle_test_period">3000</property> <!-- 空闲连接(等待)时间，以秒为单位 -->

注意：有些童鞋可能忘记了这样的配置：

<property name="hibernate.connection.provider_class">org.hibernate.connection.C3P0ConnectionProvider</property>

这当然是不可取的，以上配置是在设置连接池提供者，如没设置，默认为org.hibernate.connection.DriverManagerConnectionProvider，它会帮助我们从Hibernate本身维护的连接池里面获取连接。但是现在我们要用C3P0连接池，所以这样的设置是必不可少的，这样的话，Hibernate才知道你现在要用的是C3P0连接池！

当需要操作多个数据库时，可以为每个数据库指定一个SessionFactory。

我觉得这是要涉及分布式数据库的节奏，对此我也是小白。只是知道怎么配置而已，大概类似于一下配置吧！

<hibernate-configuration>

    <session-factory>

        ......

    </session-factory>

    <session-factory name="xxx">

        ......

    </session-factory>

</hibernate-configuration>

Session

从度娘摘抄如下：

Session接口负责执行被持久化对象的CRUD操作(CRUD的任务是完成与数据库的交流，包含了很多常见的SQL语句)。但需要注意的是Session对象是非线程安全的。

那么问题来了，我们如何解决session的安全问题？我们只需要在方法内部来使用Session就可以。
那么问题又来了，Session如何获取到昵？在讲SessionFactory接口时，我们就介绍了通过SessionFactory获得Session的两种方式，虽然这两种方式都可以获取到一个Session对象，那么这两种方式有什么区别呢？

SessionFactory.openSession();：相当于直接通过SessionFactory创建一个新的Session，使用完成后要手动调用close()方法来关闭。
SessionFactory.getCurrentSession();：获取一个与线程绑定的Session，当我们提交事务或事务回滚后会自动关闭。

Session的常用方法

save()：保存对象
update ()：修改操作
delete()：删除
get()/load()：根据id进行查询
avenOrUpdate()：执行save或update操作
createQuery()：获取一个Query对象
CreateSQLQUery()：获取一个可以操作SQL的SQLQuery对象
createCriteria()：取一个Criteria对象，它可以完成条件查询

以上的许多方法，我们都已接触过，不过后面随着我们学习的精进，还会对他们越来越熟悉。

Transaction

Transaction接口主要用于管理事务，它是Hibernate的事务接口，对底层的事务进行了封装。使用它可以进行事务操作。例如：

事务提交：commit()
事务回滚：rollback()

问题一：如何获取一个Transaction对象昵？可通过如下代码获得：

Transaction transaction = session.beginTransaction();

问题二：如果在程序中没有开启事务，是否存在事务？存在事务，默认session的每一个操作就会开启一个事务。并且默认情况下事务是不会自动提交的。相当于在Hibernate的核心配置文件中又如下配置：

<!-- 用于设置事务提交方式，默认是不自动提交的 -->

<property name="hibernate.connection.autocommit">false</property>

如果我们将其修改为：

<property name="hibernate.connection.autocommit">true</property>

则此时事务就会自动提交。

Query

从度娘上可摘抄到这样的文字：

Query接口让你方便地对数据库及持久对象进行查询，它可以有两种表达方式：HQL语言或本地数据库的SQL语句。Query经常被用来绑定查询参数、限制查询记录数量，并最终执行查询操作。

我们主要通过Query完成查询操作。通过Query即可以执行hql语句，如下：

Query query = session.createQuery("hql语句");

又可以执行本地sql语句：

SQLQuery sqlQuery = session.createSQLQuery("本地sql语句");

注意：SQLQuery是Query的子类。

查询所有操作——使用HQL

为了和之前写的单元测试类——HibernateTest1.java和HibernateTest2.java相区分，我们这儿在cn.itheima.test包下准备再创建一个单元测试类——HibernateTest3.java。
使用HQL语句完成查询所有客户的操作，代码如下：

public class HibernateTest3 {

    // 使用hql完成查询所有操作

    @Test

    public void test1() {

        Session session = HibernateUtils.openSession();

        Query query = session.createQuery("from Customer"); // from后面是类名

        List<Customer> list = query.list();

        System.out.println(list);

        session.close();

    }

}

注意：from后面是类名。

分页查询

在执行分页查询时，我们试着向t_customer表中插入100条记录。代码如下：

public class HibernateTest3 {

    // 向表中插入100条记录

    @Test

    public void test2() {

        Session session = HibernateUtils.openSession();

        // 不要忘记开事务

        session.beginTransaction();

        for (int i = 0; i < 100; i++) {

            Customer c = new Customer();

            c.setName("姓名" + i);

            c.setSex("男");

            c.setAddress("北京");

            session.save(c);

        }

        session.getTransaction().commit();

        session.close();

    }

}

接下来，就来分页查询，要求：一页显示10条，但我们要得到第二页的数据。

public class HibernateTest3 {

    // 分页查询

    // 一页显示10条，要得到第二页数据

    @Test

    public void test3() {

        Session session = HibernateUtils.openSession();

        session.beginTransaction();

        // 一页显示10条，要得到第二页数据

        Query query = session.createQuery("from Customer");

        query.setFirstResult(10); // 从第几条开始，即开始位置，从0开始计数

        query.setMaxResults(10); // 本次查询结果回显的条数

        List<Customer> list = query.list();

        System.out.println(list);

        session.getTransaction().commit();

        session.close();

    }

}

查询指定列信息

如果想如下这样子查询指定列的信息：

public class HibernateTest3 {

    // 查询指定列信息

    @Test

    public void test4() {

        Session session = HibernateUtils.openSession();

        session.beginTransaction();

        Query query = session.createQuery("select name,address from Customer"); // 这时我们得到的不再是Customer对象，而是Object[]

        List<Object[]> list = query.list();

        System.out.println(list); 

        session.getTransaction().commit();

        session.close();

    }

}

可以发现select name,address from Customer得到的是List<Object[]>结果，我们可不可以得到List<Customer>这样的结果昵？我们要想得到这个结果，可以使用Hibernate中的投影查询。我们只须在Customer类中提供name与address作为参数的构造方法就可以了，注意无参数构造也要有。而且HQL语句要写成select new Customer(name,address) from Customer。

public class HibernateTest3 {

    // 查询指定列信息

    @Test

    public void test4() {

        Session session = HibernateUtils.openSession();

        session.beginTransaction();

        Query query = session.createQuery("select new Customer(name,address) from Customer");

        List<Customer> list = query.list();

        System.out.println(list);

        session.getTransaction().commit();

        session.close();

    }

}

条件查询

条件查询，可以使用where关键字。
例，需求：查询name=姓名0的客户。
首先通过无名称参数来完成这个需求。

public class HibernateTest3 {

    // 条件查询，可以使用where关键字

    @Test

    public void test5() {

        Session session = HibernateUtils.openSession();

        session.beginTransaction();

        // 查询name=姓名0的信息

        Query query = session.createQuery("from Customer where name=?"); // 这是一种无名称参数

        // 要对参数进行赋值

        query.setParameter(0, "姓名0");

        List<Customer> list = query.list();

        System.out.println(list);

        session.getTransaction().commit();

        session.close();

    }

}

虽然我们可以查询出来，但我们有没有想过name=姓名0的客户即使查出来也只有一个，我们有必要把它放在List集合中嘛？如果查询结果可以保证就是唯一的，我们可以使用query. uniqueResult()来得到一个单独对象。

public class HibernateTest3 {

    // 条件查询，可以使用where关键字

    @Test

    public void test5() {

        Session session = HibernateUtils.openSession();

        session.beginTransaction();

        // 查询name=姓名0的信息

        Query query = session.createQuery("from Customer where name=?"); // 这是一种无名称参数

        // 要对参数进行赋值

        query.setParameter(0, "姓名0");

        // 如果能保证结果就是唯一的，那么可以使用另外一种方法

        Customer customer = (Customer) query.uniqueResult();

        System.out.println(customer);

        session.getTransaction().commit();

        session.close();

    }

}

然后再通过有名称参数来完成这个需求。

public class HibernateTest3 {

    // 条件查询，可以使用where关键字

    @Test

    public void test5() {

        Session session = HibernateUtils.openSession();

        session.beginTransaction();

        // 查询name=姓名0的信息

        Query query = session.createQuery("from Customer where name=:myname"); // 这是一种有名称参数

        // 对有名称参数进行赋值

        query.setParameter("myname", "姓名0");

        // 如果能保证结果就是唯一的，那么可以使用另外一种方法

        Customer customer = (Customer) query.uniqueResult();

        System.out.println(customer);

        session.getTransaction().commit();

        session.close();

    }

}

执行本地SQL

要想执行本地sql，可以这样子做：

SQLQuery sqlQuery=session.createSqlQuery(String sql);

需求一：执行本地sql，查询全部客户。
我想初次写代码完成这个需求，许多人都会这么写吧！

public class HibernateTest3 {

    // 执行本地sql，查询全部

    @Test

    public void test6() {

        Session session = HibernateUtils.openSession();

        session.beginTransaction();

        // 执行 select * from t_customer;

        SQLQuery sqlQuery = session.createSQLQuery("select * from t_customer");

        List<Object[]> list = sqlQuery.list();

        System.out.println(list);

        session.getTransaction().commit();

        session.close();

    }

}

可以发现select * from t_customer得到的是List<Object[]>结果，我们可不可以得到List<Customer>这样的结果昵？可以，代码如下：

public class HibernateTest3 {

    // 执行本地sql，查询全部

    @Test

    public void test6() {

        Session session = HibernateUtils.openSession();

        session.beginTransaction();

        // 执行 select * from t_customer;

        SQLQuery sqlQuery = session.createSQLQuery("select * from t_customer");

        // 想要将结果封装到Customer对象中

        sqlQuery.addEntity(Customer.class);

        List<Customer> list = sqlQuery.list();

        System.out.println(list);

        session.getTransaction().commit();

        session.close();

    }

}

需求二：执行本地sql，条件查询。例如查询name=姓名1的客户。

public class HibernateTest3 {

    // 执行本地sql，条件查询

    @Test

    public void test7() {

        Session session = HibernateUtils.openSession();

        session.beginTransaction();

        // 执行 select * from t_customer where name=?;

        SQLQuery sqlQuery = session.createSQLQuery("select * from t_customer where name=?");

        // 对参数进行赋值

        sqlQuery.setParameter(0, "姓名1");

        // 想要将结果封装到Customer对象中

        sqlQuery.addEntity(Customer.class);

        /*

        List<Customer> list = sqlQuery.list();

        System.out.println(list);

        */

        Customer customer = (Customer) sqlQuery.uniqueResult();

        System.out.println(customer);

        session.getTransaction().commit();

        session.close();

    }

}

Criteria

根据度娘所得：

Criteria接口与Query接口非常类似，允许创建并执行面向对象的标准化查询。值得注意的是Criteria接口也是轻量级的，它不能在Session之外使用。

首先我要想使用Criteria，必须得到Criteria。可这么做：

Criteria criteria = session.createCriteria(Xxx.class);

需求一：查询所有客户。

public class HibernateTest3 {

    // 测试Criteria

    @Test

    public void test8() {

        Session session = HibernateUtils.openSession();

        session.beginTransaction();

        // 得到Criteria

        Criteria criteria = session.createCriteria(Customer.class);

        // 查询所有

        List<Customer> list = criteria.list();

        System.out.println(list);

        session.getTransaction().commit();

        session.close();

    }

}

需求二：分页查询。
分页查询操作与query的方法一样。通者自通。
需求三：多条件查询。例如查询name=”姓名1”并且address=”上海”的客户。

public class HibernateTest3 {

    // 测试Criteria

    @Test

    public void test8() {

        Session session = HibernateUtils.openSession();

        session.beginTransaction();

        // 得到Criteria

        Criteria criteria = session.createCriteria(Customer.class);

        // 多条件查询

        // 1.查询name='姓名1'

        criteria.add(Restrictions.eq("name", "姓名1")); // where name="姓名1";

        // 2.查询address='上海'

        criteria.add(Restrictions.eq("address", "上海")); // where name="姓名1" and address="上海"

        Customer customer = (Customer) criteria.uniqueResult();

        session.getTransaction().commit();

        session.close();

    }

}

需求四：多条件查询。例如查询name=’姓名1’或者address=’上海’的客户。

public class HibernateTest3 {

    // 测试Criteria

    @Test

    public void test8() {

        Session session = HibernateUtils.openSession();

        session.beginTransaction();

        // 得到Criteria

        Criteria criteria = session.createCriteria(Customer.class);

        // 多条件查询

        // 查询name='姓名1'或者address='上海'

        criteria.add(Restrictions.or(Restrictions.eq("name", "姓名1"),Restrictions.eq("address", "上海")));

        List<Customer> list = criteria.list();

        System.out.println(list);

        session.getTransaction().commit();

        session.close();

    }

}

总结：我们使用Criteria可以更加面向对象地去操作，它非常适合进行多条件组合查询。但感觉没什么鸟用！