如何在Java的Rest Assured中使用多种组合的查询参数？

我有6个可选的查询参数，需要覆盖所有组合来使用它们。我尝试了以下代码：

do {
    Response searchbyfield = given()
   .headers("Cookie", cookies)
   .queryParam("search","test")
   .queryParam("is_phone_verified",String.valueOf(is_phone_verified))
   .queryParam("is_mail_verified",String.valueOf(is_mail_verified))
   .queryParam("is_doc_verified",String.valueOf(is_doc_verified))
   .queryParam("taxform",String.valueOf(taxform))
   .queryParams("page", String.valueOf(page))
   .when().get("")
   page = page + 1;
    }
 while (next.contains("page"));

但这种方法不够通用，我想知道如何编写一个通用函数来覆盖所有参数组合？

通用解决方案 #

要实现参数组合的全覆盖，核心思路是先抽象参数与可选值，再生成所有可能的组合，最后遍历组合发起请求，以下是具体实现：

1. 编写参数组合生成工具类

这个工具类可以根据传入的参数键值对列表，生成所有可能的参数组合（包括空组合）：

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

public class ParamCombinationGenerator {
    public static List<Map<String, Object>> generateAllCombinations(Map<String, List<Object>> paramOptions) {
        List<Map<String, Object>> combinations = new ArrayList<>();
        combinations.add(new HashMap<>()); // 初始添加空组合

        for (Map.Entry<String, List<Object>> entry : paramOptions.entrySet()) {
            String paramKey = entry.getKey();
            List<Object> paramValues = entry.getValue();
            List<Map<String, Object>> tempCombinations = new ArrayList<>();

            // 遍历现有组合，为每个组合添加当前参数的所有可能值
            for (Map<String, Object> existingComb : combinations) {
                for (Object value : paramValues) {
                    Map<String, Object> newComb = new HashMap<>(existingComb);
                    newComb.put(paramKey, value);
                    tempCombinations.add(newComb);
                }
            }
            combinations.addAll(tempCombinations);
        }

        // 如果不需要空组合，可移除第一个元素
        // combinations.remove(0);
        return combinations;
    }
}

2. 结合接口请求逻辑使用

通过定义参数的可选值列表，生成所有组合后，遍历每个组合发起请求，并处理分页逻辑：

// 1. 定义所有可选参数及其可能的值
Map<String, List<Object>> paramOptions = new HashMap<>();
paramOptions.put("search", List.of("test")); // 固定值仅需传入一个元素
paramOptions.put("is_phone_verified", List.of(true, false));
paramOptions.put("is_mail_verified", List.of(true, false));
paramOptions.put("is_doc_verified", List.of(true, false));
paramOptions.put("taxform", List.of("formA", "formB", null)); // 支持null值参数
paramOptions.put("page", List.of(1)); // 分页初始值

// 2. 生成所有参数组合
List<Map<String, Object>> allCombinations = ParamCombinationGenerator.generateAllCombinations(paramOptions);

// 3. 遍历每个组合发起请求，处理分页
for (Map<String, Object> paramComb : allCombinations) {
    int currentPage = (int) paramComb.getOrDefault("page", 1);
    boolean hasNextPage;
    do {
        // 初始化请求
        RequestSpecification request = given()
                .headers("Cookie", cookies);

        // 为请求添加当前组合的所有参数
        for (Map.Entry<String, Object> entry : paramComb.entrySet()) {
            String key = entry.getKey();
            Object value = entry.getValue();
            if (value != null) { // 跳过null值参数，避免无效请求
                request.queryParam(key, String.valueOf(value));
            }
        }
        // 覆盖当前页参数
        request.queryParam("page", String.valueOf(currentPage));

        // 发起请求并获取响应
        Response response = request.when().get("/your-api-endpoint");

        // 判断是否存在下一页（根据实际响应结构调整）
        String nextLink = response.jsonPath().getString("next");
        hasNextPage = nextLink != null && nextLink.contains("page");

        currentPage++;
    } while (hasNextPage);
}

关键优势

• 扩展性强：新增或修改参数时，只需更新paramOptions的配置，无需修改核心逻辑
• 通用性高：生成组合的工具类可复用在任何需要参数全组合的场景
• 灵活可控：可自由选择是否包含空组合、是否允许null值参数

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