首页 > 代码库 > ( 转)Hibernate常用API

( 转)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的核心配置文件它有两种方式:

  1. hibernate.cfg.xml
  2. 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.得到SessionFactorySessionFactory sessionFactory = config.buildSessionFactory();

 

 

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

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

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

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

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

  1. 通过SessionFactory获得Session方式一: 
    技术分享
    注意:这是从连接池中获取一个连接。
  2. 通过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连接池?

  1. 我们要导入c3p0的相关jar包。 
    在lib/options下有关于c3p0连接池所需jar包,如下: 
    技术分享
  2. 在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>
  3. 这当然是不可取的,以上配置是在设置连接池提供者,如没设置,默认为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可以更加面向对象地去操作,它非常适合进行多条件组合查询。但感觉没什么鸟用!

( 转)Hibernate常用API