JPA中如何使用@Param注解调用对象内嵌套参数值

Spring Data JPA 支持通过 SpEL 表达式读取参数对象的属性，可直接实现你需要的封装对象传参需求，完整实现示例如下：

1. 定义参数封装POJO类 #

首先创建用于存储所有查询参数的普通Java类，必须包含对应属性的getter方法：

public class Parameters {
    private String a;
    private String b;
    private String c;
    private String d;
    private String e;
    private String f;

    // 全参构造方法，方便快速创建参数对象
    public Parameters(String a, String b, String c, String d, String e, String f) {
        this.a = a;
        this.b = b;
        this.c = c;
        this.d = d;
        this.e = e;
        this.f = f;
    }

    // 必须添加getter方法，JPA需要通过getter读取属性值
    public String getA() { return a; }
    public String getB() { return b; }
    public String getC() { return c; }
    public String getD() { return d; }
    public String getE() { return e; }
    public String getF() { return f; }

    // 按需补充setter方法
    public void setA(String a) { this.a = a; }
    public void setB(String b) { this.b = b; }
    public void setC(String c) { this.c = c; }
    public void setD(String d) { this.d = d; }
    public void setE(String e) { this.e = e; }
    public void setF(String f) { this.f = f; }
}

2. 编写Repository查询方法 #

在Repository接口中定义查询方法，@Query注解内使用:#{#参数名.属性名}的SpEL语法读取对象属性：

public interface ResultRepository extends JpaRepository<Result, Long> {
    // JPQL查询示例
    @Query("SELECT r FROM Result r WHERE " +
            "r.fieldA = :#{#params.a} " +
            "AND r.fieldB = :#{#params.b} " +
            "AND r.fieldC = :#{#params.c} " +
            "AND r.fieldD = :#{#params.d} " +
            "AND r.fieldE = :#{#params.e} " +
            "AND r.fieldF = :#{#params.f}")
    List<Result> getResults(@Param("params") Parameters params);

    // 原生SQL查询示例，仅需添加nativeQuery = true即可
    @Query(value = "SELECT * FROM result_table WHERE " +
            "field_a = :#{#params.a} " +
            "AND field_b = :#{#params.b} " +
            "AND field_c = :#{#params.c} " +
            "AND field_d = :#{#params.d} " +
            "AND field_e = :#{#params.e} " +
            "AND field_f = :#{#params.f}", nativeQuery = true)
    List<Result> getResultsByNativeSql(@Param("params") Parameters params);
}

3. 方法调用示例 #

业务层直接构造Parameters对象传入即可：

// 构造参数对象
Parameters queryParams = new Parameters("a的取值", "b的取值", "c的取值", "d的取值", "e的取值", "f的取值");
// 执行查询
List<Result> resultList = resultRepository.getResults(queryParams);

注意事项 #

• 实际使用时请将示例中的实体类属性名r.fieldA、数据库表字段名field_a替换为你自己业务对应的字段
• JPA本身没有最多4个查询参数的限制，之前传参失效多为拼写错误或版本兼容问题，封装为对象传参的兼容性更高，也更利于后续参数扩展维护

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