Hibernate -- 其他 API

本是古典何须时尚 2022-05-30 02:14 205阅读 0赞

# Query #

Query 代表面向对象的一个 Hibernate 查询操作。在 Hibernate 中，通常使用`session.createQuery()`方法接受一个 HQL 语句，然后调用`Query#list()`或`Query#umqueResult()`方法执行查询。所谓的HQL是 Hibernate Query Language 缩写，其语法很像 SQL 语法，但它是完全面向对象的。  
在 Hibernate 中使用 Query 对象的步骤，具体所示：  
1. 获得 Hibernate 的 Session 对象。  
2. 编写 HQL 语句。  
3. 调用`session.createQuery`创建查询对象。  
4. 如果 HQL 语句包含参数，则调用 Query 的 setXxx 设置参数。  
5. 调用`Query#list()`或`Query#umqueResult()`方法执行查询。  
了解了使用 Query 对象的步骤后，接下来，通过具体示例来演示 Query 对象的查询操作。

// 1.查询所有记录
    Query query = session.createQuery("from Customer");
    List<Customer> customerList = query.list();
    
    // 2.条件查询
    Query query = session.createQuery("from Customer where name = ?");
    query.setString(0,"张三");
    List<Customer> customerList = query.list();
    
    // 3.条件查询
    Query query = session.createQuery("from Customer where name = :aaa and age = :bbb");
    query.setString(aaa,"张三");
    query.setString(bbb,"38");
    List<Customer> customerList = query.list();
    
    // 4.分页查询
    Query query = session.createQuery("from Customer");
    query.setFirstResult(3);
    query.setMaxResult(3);
    List<Customer> customerList = query.list();

程序通过使用 Query 接口，将 customer 表中的三条数据全部输出。  
Query 中除了使用 list() 方法查询全部数据外，还有其它一些常用方法，具体如下：

*  setter 方法：Query 接口中提供了一系列的 setter 方法用于设置查询语句中的参数，针对不同的数据类型，需要用到不同的 setter 方法。
 *  iterator() 方法：该方法用于查询语句，返回的记过是一个 Iterator 对象，在读取时只能按照顺序方式读取，它仅把使用到的数据转换成 Java 实体对象。
 *  uniqueResult() 方法：该方法用于返回唯一的记过，在确保只有一条记录的查询时可以使用该方法。
 *  executeUpdate() 方法：该方法是 Hibernate 3 的新特性，它支持 HQL 语句的更新和删除操作。
 *  setFirstResult() 方法：该方法可以设置获取第一个记录的位置，也就是它表示从第几条记录开始查询，默认从 0 开始计算。
 *  setMaxResult() 方法：该方法用于设置结果集最大的记录数，通常与 setFirstResult() 方法结合使用，用于限制结果集的范围，以实现分页功能。

# Criteria #

Criteria 是一个完全面向对象，可扩展的条件查询 API，通过它完全不需要考虑数据库底层如何实现，以及 SQL 语句如何编写，它是 Hibernate 框架的核心查询对象。Criteria 查询，又称为 QBC 查询（ Query By Criteria)，它是 Hibernate 的另一种对象检索方式。  
`org.hibernate.criterion.Criterion`是 Hibernate 提供的一个面向对象查询条件接口，一个单独的查询就是 Criterion 接口的一个实例，用于限制 Criteria 对象的查询，在 Hibernate 中 Criterion 对象的创建通常是通过 Restrictions 工厂类完成的，它提供了条件查询方法。  
通常，使用 Criteria 对象查询数据的主要步骤，具体如下：  
1. 获得 Hibernate 的 Session 对象。  
2. 通过 Session 获得 Criteria 对象。  
3. 使用 Restrictions 的静态方法创建 Criterion 条件对象。Restrictions 类中提供了一系列用于  
设定查询条件的静态方法，这些静态方法都返回 Criterion 实例，每个 Criterion 实例代表一  
个查询条件。  
4. 向 Criteria 对象中添加 Criterion 查询条件。Criteria 的 add() 方法用于加入查询条件。  
5. 执行 Criterita 的 list() 或 uniqueResult() 获得结果。  
了解了 Criterita 对象的使用步骤后，接下来，通过具体示例来演示 Criterita 对象的查询操作。

// 1.查询所有记录
    Criteria criteria = session.createCriteria(Customer.class);
    List<Customer> customerList = criteria.list();
    
    // 2.条件查询
    Criteria criteria = session.createCriteria(Customer.class);
    criteria.add(Restrictions.eq("name","张三"));
    List<Customer> customerList = criteria.list();
    
    // 3.条件查询
    Criteria criteria = session.createCriteria(Customer.class);
    criteria.add(Restrictions.eq("name","张三"));
    criteria.add(Restrictions.eq("age","38"));
    List<Customer> customerList = criteria.list();
    
    // 4.分页查询
    Criteria criteria = session.createCriteria(Customer.class);
    criteria.setFirstResult(3);
    criteria.setMaxResult(3);
    List<Customer> customerList = criteria.list();

在 Criteria 对象中，除了使用`criteria.list()`方法查询全部数据外，还有其它一些常用方法：如果只返回一个值时，可以使用`criteria.uniqueResult()`方法；如果需要分页时可以使用`setFirstResult()`和`setMaxResult()`两个方法，`setFirstResult()`方法表示从第几条记录开始查询，`setMaxResult()`方法表示查询几条记录。

# SQLQuery #

SQLQuery 这个接口用于接收一个 SQL 语句进行查询，然后调用 list() 或者 uniqueResult() 方法进行查询。但是 SQL 语句不会直接封装到实体对象中，需要我们手动写代码差可以封装到实体中。

SQLQuery sqlQuery = session.createSQLQuery("select * from sct_customer");
    List<Customer> customerList = sqlQuery.list();
    
    for (Customer customer: customerList){
        SQLQuery sqlQuery = session.createSQLQuery("select * from sct_customer");
        // 封装到对象中
        sqlQuery.addEntiy(Customer.class);
        List<Customer> customerList = sqlQuery.list();
    }