笔记：Hibernate SQL 查询

Posted 2020-08-29 追寻自由的路途

Hibernate 支持使用原生的SQL查询，使用原生SQL查询可以利用某些数据库特性，原生SQL查询也支持将SQL语句放在配置文件中配置，从而提高程序的解耦,命名SQL查询还可以用于调用存储过程。

SQL查询是通过SQLQuery接口来表示的，SQLQuery接口是Query接口的子接口，完全可以使用Query接口的方法，SQLQuery增加了二个重载方法

• addEntity()：将查询到的记录与特定的实体关联
• addScalar()：江查询的记录关联标量值

执行SQL的步骤如下：

• 获取Hibernate Session对象
• 编写SQL语句
• 创建SQLQuery对象，调用Session的createSQLQuery方法创建
• 调用SQLQuery对象的 addScalar 或者 addEntity 方法将选出的结果与变量值或实体进行关联
• 如果SQL语句包含参数，则调用Query的setXxx方法为参数赋值
• 调用Query的list、uniqueResult方法返回查询的结果集

  ? ?

1. 标量查询

   如果希望仅仅让Hibernate选出某个字段的值，则可以使用标量查询，通过addScalar方法指定返回的字段值，示例如下：

   List list = curSession.createSQLQuery("select * FROM OneToMany_One")

   .addScalar("Total_Trade_Amt", StandardBasicTypes.LONG)

   .list();

2. 实体查询

   如果查询了某个数据表的全部数据列，且该数据表有对应的持久化类映射，可以通过 addEntity 指定持久化类型，将查询结果转换为实体，示例如下：

   List list = curSession.createSQLQuery("select * FROM OneToMany_One")

   .addEntity(OneToManyForOneModel.class)

   .list();

3. SQL参数

   SQL语句可以使用二种参数定义方式，参数Key和参数索引的方式

• 参数Key方式：在SQL语句中使用":参数名称"的方式定义参数，并使用 setParameter方法的参数名称来给参数赋值，并制定参数的类型，示例如下：

  List list = curSession.createSQLQuery("select * FROM OneToMany_One WHERE Record_ID = :reocrdId")

  .addEntity(OneToManyForOneModel.class)

  .setParameter("reocrdId", 1234, StandardBasicTypes.INTEGER)

  .list();

  ? ?

• 参数索引方式：在SQL语句中使用"?"来定义参数，并使用setParameter方法的索引重载来给参数赋值，并制定参数的类型，示例如下：

  List list = curSession.createSQLQuery("select * FROM OneToMany_One WHERE Record_ID = ?")

  .addEntity(OneToManyForOneModel.class)

  .setParameter(0, 1234, StandardBasicTypes.INTEGER)

  .list();

1. 存储过程

   Hibernate 当前仅支持存储过程返回标量和实体，调用存储过程还有如下需求注意的地方：

• 建议采用标准SQL92语法，如{?=call functionName(<parameters>)} 或 {call procedureName(<parameters>)}，不支持原生的调用语法。
• 调用存储过程进的查询无法使用setFirstResult()、setMaxResults()进行分页

1. 定制化SQL，Hibernate 需要保存、更新和删除持久化实体时，默认通过一套固定的SQL语句来完成这些功能，如果程序需要改变这套默认的SQL语句，就可以使用Hibernate所提供的定制SQL功能，
   1. 注解 @SQLInsert 定制插入记录的SQL语句；
   2. 注解 @SQLUpdate：定制更新记录的SQL语句；
   3. 注解 @SQLDelete：定制删除记录的SQL语句；
   4. 注解 @SQLDeleteAll：定制删除所有记录的SQL语句；
   5. 注解@Loader：定制查询的SQL语句

   他们都有二个参数，其参数sql 表示执行的定制SQL语句（存储过程），参数 callable 表示该语句是否为存储过程。如果使用存储过程时，参数的顺序很重要，可以将 org.hibernate.persister.entity 日志级别设置为 debug级别，从而允许查看Hibernate所期待的顺序，整个级别下，Hibernate将会输出 create、update和delete实体的静态SQL。因为Hibernate 会检查SQL语句是否执行成功，所以应该让存储过程能返回该存储过程影响的记录行数，Hibernate通常把CUD操作语句的第一个参数注册为数值型输出参数，所以应该让存储过程的第一个参数记录该存储过程所影响的记录条数（存储过程没有测试成功）