如何在Helidon 4 SE的DbClient查询中传递参数集合

不需要更换其他库，Helidon DbClient完全可以处理这种场景，下面提供两种可行方案：

方案一：动态生成占位符，逐个绑定参数 #

这是JDBC通用做法，适配所有数据库。核心逻辑是根据集合大小生成对应数量的?占位符，再将集合元素逐个作为参数传入：

@Override
public List<Foo> getFooList(Set<Long> barIds) {
    if (barIds.isEmpty()) {
        return Collections.emptyList();
    }
    // 根据集合元素数量生成占位符，比如3个元素生成"?,?"
    String placeholders = String.join(",", Collections.nCopies(barIds.size(), "?"));
    var query = String.format("SELECT * FROM foo WHERE bar_id IN (%s)", placeholders);
    
    return dbClient.execute()
            .createQuery(query)
            .addParams(barIds) // 传入集合，自动逐个绑定参数
            .execute()
            .stream()
            .map(row -> {
                // 此处编写结果解析逻辑，示例：
                Foo foo = new Foo();
                foo.setId(row.get("id", Long.class));
                foo.setBarId(row.get("bar_id", Long.class));
                // 其他字段赋值
                return foo;
            })
            .toList();
}

注意：必须处理集合为空的情况，避免生成IN ()这类无效SQL语句。

方案二：利用PostgreSQL数组特性（推荐） #

PostgreSQL原生支持数组类型，可使用= ANY(?)替代IN，直接绑定数组参数，代码更简洁：

@Override
public List<Foo> getFooList(Set<Long> barIds) {
    if (barIds.isEmpty()) {
        return Collections.emptyList();
    }
    Long[] barIdArray = barIds.toArray(new Long[0]);
    var query = "SELECT * FROM foo WHERE bar_id = ANY(?)";
    
    return dbClient.execute()
            .createQuery(query)
            .addParam(barIdArray, Types.ARRAY) // 明确指定参数类型为数组
            .execute()
            .stream()
            .map(row -> {
                // 结果解析逻辑
                Foo foo = new Foo();
                foo.setId(row.get("id", Long.class));
                foo.setBarId(row.get("bar_id", Long.class));
                return foo;
            })
            .toList();
}

这种方式无需动态拼接SQL，既简洁又能规避SQL注入风险（两种方案均安全，但该方案更优雅）。

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