69、Spring Data JPA 的 @Query查询和命名查询（半自动：提供 SQL 或 JPQL 查询）

news2025/1/6 19:46:39

1、方法名关键字查询（全自动，既不需要提供sql语句，也不需要提供方法体）
2、@Query查询（半自动：提供 SQL 或 JPQL 查询）
3、自定义查询（全手动）

@Query查询和命名查询的区别：
命名查询与直接用@Query来定义查询的本质是一样，只不过它们定义SQL或JPQL语句的位置不同。
直接用 @Query来定义查询 ，写SQL或JPQL语句的位置在 DAO 组件，
命名查询，写SQL或JPQL语句的位置在 实体类 上面

★ @Query查询（半自动：提供SQL或JPQL）

让开发者指定JPQL或SQL查询，剩下的事情由Spring Data来负责完成：帮你生成查询方法、实现查询功能。

▲ @Query注解

通过使用@Query注解修饰查询方法，可以让查询方法使用自定义的JPQL或SQL执行查询，
该注解可以指定如下常用属性：

- name：指定使用哪个命名查询。
        命名查询的本质就是为JPQL或SQL语句起个名字，
        因此指定使用哪个命名查询也就是指定了JPQL或SQL语句。

- nativeQuery：指定是否为SQL查询，如果该属性为true，表明是原生SQL查询，否则就是JPQL查询。

- value：指定自定义的JPQL或SQL语句。

@Query(nativeQuery = true , value=" "）这个指定为 SQL 语句查询，也叫命名查询，也就是指定使用 SQL 命名查询

代码演示：

jpa 的 @Query 的 JPQL 不能用 select * from  ，就是不能用 * ，但可以用表的别名代替：
比如：select * from table  ------->  select t from Table t

需求：根据学生的姓名和教室的名字查询学生，使用 @Query 指定 JPQL 语句查询
( JPQL 是 @Query 默认原生方法)
在这里插入图片描述
测试结果：

需求：根据班级名称name模糊查询Clazz对象
使用 @Query 指定 SQL 语句，nativeQuery = true 说明是使用 SQL 查询
在这里插入图片描述

测试结果：
在这里插入图片描述

▲ Modifying注解

如果@Query注解指定的查询语句要对底层数据进行修改，还需要使用@Modifying注解修饰该方法，

该注解修饰的方法可以修改底层的数据。


【提示：】 Spring Boot有一个很优秀的设计，当你在测试DAO组件的方法时，
          测试完成后方法的测试结果会自动回滚。

如果你确实想在测试DAO组件时，测试结束后提交事务，而不是回滚事务（默认设置）。
—— 只要将测试方法添加@Rollback(false)

代码演示

需求：修改指定年龄的指定name值，把年龄大于500的学生的name改成"张三"
如果使用 JPQL语句或 SQL语句要修改数据库数据，该方法需要添加 @Modifying 注解

在这里插入图片描述
测试结果：

如果想在测试DAO组件时，测试结束后提交事务，而不是回滚事务（默认设置）。
—— 只要在测试方法上添加@Rollback(false)

在这里插入图片描述

★ 命名查询

@Query(nativeQuery = true , value=" "）这个指定为 SQL 语句查询，也叫命名查询，也就是指定使用 SQL 命名查询

甚至不再需要使用@Query注解
——只要让@NamedQuery或@NamedNativeQuery所定义的命名查询的查询名等于实体类的类名+DAO组件的查询方法的方法名
    中间以点号（.)隔开。
    
@NamedQuery或@NamedNativeQuery一般用在实体类上定义查询语句。

不难发现，命名查询与直接用@Query来定义查询的本质是一样，
只不过它们定义SQL或JPQL语句的位置不同。

直接用 @Query来定义查询 ，写SQL或JPQL语句的位置在 DAO 组件，
命名查询，写SQL或JPQL语句的位置在 实体类 上面

在这里插入图片描述