Spring Data JPA中的@Query注解使用方式

使用@Query的方式

       这种查询可以声明在继承JpaRepository接口方法中,可以在自定义的查询方法上使用@Query,来指定该方法要执行的自定义的查询语句,比如:

例子1:

@Query("select o from UserModel o where o.uuid=?1")

public List<UserModel> findByUuidOrAge(int uuid);

注意:

1:方法的参数个数必须和@Query里面需要的参数个数一致

2:如果是like,后面的参数需要前面或者后面加“%”,比如下面都对:

@Query("select o from UserModel o where o.name like ?1%")

public List<UserModel> findByUuidOrAge(String name);

@Query("select o from UserModel o where o.name like %?1")

public List<UserModel> findByUuidOrAge(String name);

@Query("select o from UserModel o where o.name like %?1%")

public List<UserModel> findByUuidOrAge(String name);

当然,这样在传递参数值的时候就可以不加‘%’了,当然加了也不会错

例子2:

还可以使用@Query来指定本地查询,参数nativeQuery = true才是表明了使用原生的sql,只要设置nativeQuery为true,比如:

@Query(value="select * from tbl_user where name like %?1" ,nativeQuery=true)

public List<UserModel> findByUuidOrAge(String name);

注意:当前版本的本地查询不支持翻页和动态的排序

使用命名化参数,使用@Param即可,比如:

@Query(value="select o from UserModel o where o.name like %:nn")

public List<UserModel> findByUuidOrAge(@Param("nn") String name);

例子3:

同样支持更新类的Query语句(delete或update的sql)时,添加@Modifying即可配合,配合@Modifying注解一同使用,则可以完成数据的删除、添加、更新操作,比如:

@Modifying

@Query(value="update UserModel o set o.name=:newName where o.name like %:nn")

public int findByUuidOrAge(@Param("nn") String name,@Param("newName") String newName);

注意:

1:方法的返回值应该是int,表示更新语句所影响的行数

2:在调用的地方必须加事务(可以使用注解方式@Transactional),没有事务不能正常执行

<think>好的,我需要回答用户关于Spring Data JPA@Query注解支持的所有属性的问题。首先,我应该回忆一下相关的知识,或者查找官方文档来确认属性列表。记得用户提到引用[1]和引用[2],可能需要结合这些内容。 首先,@Query注解主要用于自定义JPQL或原生SQL查询。它的常见属性包括value、nativeQuery、countQuery、name等。用户想了解所有支持的属性,我需要详细列出每个属性的作用及其用法示例。 接下来,我需要确保每个属性的描述准确,并且给出对应的例子,比如设置nativeQuery为true时使用SQL语句。此外,countQuery用于分页查询时自定义计数查询,这也是重要的点。 还要注意是否有其他属性,比如在Spring Data JPA的更新版本中是否有新增的属性。例如,是否有与锁定模式相关的属性,或者flushAutomatically等。需要确认这些信息是否正确,避免遗漏或错误。 然后,结合用户提供的引用内容,引用[1]提到了@Query的基本使用和优先级,引用[2]提到了处理空值的方法。可能需要将这些信息整合到回答中,比如在解释属性时提到如何处理空值的情况。 最后,按照用户的格式要求,使用中文回答,结构清晰,分点列出属性,并给出示例代码。同时,生成相关问题,确保问题与主题相关,帮助用户深入理解。</think>### Spring Data JPA @Query 注解支持的属性列表 Spring Data JPA 的 `@Query` 注解提供了多个属性,用于灵活定义查询逻辑。以下是支持的主要属性及其作用: 1. **value** - **作用**:定义 JPQL 或原生 SQL 查询语句。 - **示例**: ```java @Query("SELECT u FROM User u WHERE u.age > :age") List<User> findByAgeGreaterThan(@Param("age") int age); ``` 2. **nativeQuery** - **作用**:标识是否为原生 SQL 查询(默认为 `false`,即使用 JPQL)。 - **示例**: ```java @Query(value = "SELECT * FROM users WHERE status = 1", nativeQuery = true) List<User> findActiveUsers(); ``` 3. **countQuery** - **作用**:为分页查询(`Pageable`)提供自定义的计数查询(仅在 `nativeQuery = true` 时有效)。 - **示例**: ```java @Query( value = "SELECT * FROM users WHERE department = :dept", countQuery = "SELECT COUNT(*) FROM users WHERE department = :dept", nativeQuery = true ) Page<User> findByDepartment(@Param("dept") String department, Pageable pageable); ``` 4. **name** - **作用**:关联预定义的命名查询(需配合 `@NamedQuery` 使用),优先级低于直接通过 `value` 定义的查询[^1]。 - **示例**: ```java @Query(name = "User.findByEmail") // 引用@NamedQuery定义的查询 List<User> findByEmail(String email); ``` 5. **countProjection** - **作用**(已弃用):早期版本中用于自定义计数查询的投影字段,现更推荐使用 `countQuery` 属性。 --- ### 其他注意事项 - **空值处理**:在动态查询中,若参数可能为 `null`,需结合 `COALESCE` 或 `IS NULL` 条件处理,例如: ```java @Query("SELECT u FROM User u WHERE (:name IS NULL OR u.name = :name)") List<User> findByName(@Param("name") String name); ``` 这种方式可避免因参数为空导致查询语法错误[^2]。 - **修改查询**:若 `@Query` 用于更新/删除操作,需额外添加 `@Modifying` 注解: ```java @Modifying @Query("UPDATE User u SET u.status = :status WHERE u.id = :id") int updateUserStatus(@Param("id") Long id, @Param("status") String status); ``` ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值