如何使用JPA @Query注解结合HQL编写指定条件的Book实体查询语句

核心写法说明 #

因为你用的是无关联的简单Book实体，直接基于实体属性编写HQL即可，不需要处理关联查询逻辑。需要注意你当前实体的yearOfPublish是String类型，HQL里可以用CAST函数转成整数做年份对比，避免字符串比较的异常。

完整Repository实现示例 #

你需要在继承了JpaRepository的Book持久层接口中添加如下方法，两种写法按需选择：

import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;
import org.springframework.data.jpa.repository.JpaRepository;
import java.util.List;

public interface BookRepository extends JpaRepository<Book, Integer> {

    // 写法1：位置参数绑定，参数顺序和?后的数字一一对应
    @Query("FROM Book b WHERE b.authorName = ?1 AND CAST(b.yearOfPublish AS integer) > ?2")
    List<Book> findByAuthorAfterYear(String authorName, Integer targetYear);

    // 写法2：命名参数绑定，用@Param匹配参数名，可读性更高，推荐使用
    @Query("FROM Book b WHERE b.authorName = :authorName AND CAST(b.yearOfPublish AS integer) > :targetYear")
    List<Book> findByAuthorAfterYear(@Param("authorName") String authorName, @Param("targetYear") Integer targetYear);
}

关键注意点 #

• HQL语句中使用的是实体类名Book和实体属性名authorName/yearOfPublish，不是数据库的表名和列名
• 如果你存储的yearOfPublish是固定4位数字的标准字符串（比如"2023"），也可以去掉CAST直接做字符串对比，此时入参的年份也用String类型即可
• 上面HQL省略了SELECT b是语法允许的，等价于查询Book的所有字段
• 方法调用时直接传入指定作者名和目标年份即可拿到符合要求的书籍列表

内容的提问来源于stack exchange，提问作者user2693135