Cucumber 6.8.1相同句式不同参数类型步骤定义歧义解决咨询

问题根因 #

歧义的核心原因是第二个步骤定义的正则^(.+) has a value (.+)$中的.+可以匹配任意非空字符，包括true和false，所以当步骤里的值是true/false时，两个步骤定义的正则都能匹配到，Cucumber无法判断该调用哪个方法，就会抛出AmbiguousStepDefinitionsException。

解决方案 #

方案1：调整正则匹配规则，明确边界 #

给字符串类型的步骤定义加负向预查，排除值为true/false的场景，让两类步骤的正则没有重叠匹配范围，同时不要使用方法重载，避免额外的识别冲突：

Map<String, Object> values = new HashMap<>();

@And("^(.+) has a value (false|true)$")
public void addBooleanValues(String key, Boolean value) {
    values.put(key, value);
}

// 新增负向预查，只有值不是true/false时才匹配该方法
@And("^(.+) has a value (?!true$|false$)(.+)$")
public void addStringValues(String key, String value) {
    values.put(key, value);
}

方案2：合并为一个方法，自行处理类型转换（更推荐，维护成本更低） #

不用写两个步骤定义，只保留一个通用方法，内部根据值的内容判断类型再存储，完全避免正则匹配冲突：

Map<String, Object> values = new HashMap<>();

@And("^(.+) has a value (.+)$")
public void addValues(String key, String value) {
    if ("true".equals(value) || "false".equals(value)) {
        values.put(key, Boolean.valueOf(value));
        return;
    }
    values.put(key, value);
}

后续如果要新增数字等其他类型的转换，只要在方法内补充判断逻辑即可，扩展性更好。

方案3：使用Cucumber参数类型定义 #

Cucumber 6.x支持自定义参数类型，可以通过注册专属参数类型区分匹配逻辑：

// 注册参数类型，可放在步骤定义类的静态块或者配置类中
@ParameterType("true|false")
public Boolean booleanValue(String value) {
    return Boolean.valueOf(value);
}

@ParameterType("(?!true$|false$).+")
public String stringValue(String value) {
    return value;
}

// 步骤定义直接引用参数类型
@And("{string} has a value {booleanValue}")
public void addBooleanValues(String key, Boolean value) {
    values.put(key, value);
}

@And("{string} has a value {stringValue}")
public void addStringValues(String key, String value) {
    values.put(key, value);
}

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