Spring Data JPA - 如何创建查询（10）应用Query Hints

本文介绍了如何使用JPA中的@QueryHint注解来自定义查询，以优化查询性能并利用特定供应商的特性。通过实例展示了如何在实体类及repository接口中应用查询提示。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

作者简介

陈喆，现就职于中科院某研究所担任副研究员，专注于工业云平台、MES系统的设计与研发。

内容来源：https://docs.spring.io/spring-data/jpa/docs/2.0.9.RELEASE/reference/html/#jpa.query-hints

先解释一下什么是Query Hint。参考Orcale官方文档。默认情况下，@NameQuery或@NameNativeQuery完全按照查询String指定的方式执行。使用@QueryHint注解指定供应商特定的JPA查询扩展，以提高查询性能和利用供应商的JPA持续性提供程序实现中的特定特性。

@QueryHing有两个属性，name和value。name指定提示名称,value指定提示的值。如下例：

@Entity
@NamedQuery(
name="findAllEmployees",
query="SELECT * FROM EMPLOYEE WHERE MGR=1"
hints={@QueryHint={name="toplink.refresh", value="true"}}
)
public class Employee implements Serializable {
    ...
}

使用 @QueryHint 批注自定义查询以利用由 TopLink Essentials 提供的供应商 JPA 扩展：在该示例中，提示确保在执行查询时始终刷新 TopLink 缓存。

在repository接口中通过@QueryHints注解使用JPA 查询提示。它提供了一组JPA @QueryHint注解外加一个布尔标识，默认禁止在分页时需要调用的计数查询上使用查询提示，如下例：

public interface UserRepository extends Repository<User, Long> {

  @QueryHints(value = { @QueryHint(name = "name", value = "value")},
              forCounting = false)
  Page<User> findByLastname(String lastname, Pageable pageable);
}