Cucumber7中如何实现Enum与String类型的Map参数映射？

Cucumber 7默认仅内置了Map<String, String>等基础类型的DataTable转换逻辑，当使用自定义枚举/对象作为Map的key时，需要手动注册自定义数据表格类型完成转换。

以下两种常用方案均可解决问题：

方案1：单独注册针对Map<Gender, String>的转换规则 #

1. 首先确保你的Gender枚举类定义正常，示例如下：

package com.test;

public enum Gender {
    MALE, FEMALE, OTHER
}

2. 在Cucumber的glue扫描路径下（和步骤定义类同包，或单独的配置类）添加@DataTableType注解定义转换逻辑：

import io.cucumber.java.DataTableType;
import java.util.Map;
import java.util.stream.Collectors;
import com.test.Gender;

public class CustomDataTableConfig {
    @DataTableType
    public Map<Gender, String> genderStringMapConverter(Map<String, String> rawTable) {
        return rawTable.entrySet().stream()
                .collect(Collectors.toMap(
                    // 可根据你的feature文件写法调整转换逻辑，比如大小写、空格处理
                    entry -> Gender.valueOf(entry.getKey().trim().toUpperCase()),
                    Map.Entry::getValue
                ));
    }
}

3. 保持原步骤定义方法不变，feature文件中的表格写法示例：

Then with the following Properties:
  | MALE   | 男性 |
  | FEMALE | 女性 |
  | OTHER  | 未知 |

方案2：注册全局枚举转换器（适配所有枚举类型的转换） #

如果项目中有多个枚举需要作为DataTable的参数/key，可以注册全局默认转换器，避免重复编写转换逻辑：

import io.cucumber.java.DefaultDataTableCellTransformer;
import io.cucumber.java.DefaultDataTableEntryTransformer;
import io.cucumber.java.DefaultParameterTransformer;
import java.lang.reflect.Type;

public class GlobalCucumberConfig {
    @DefaultParameterTransformer
    @DefaultDataTableEntryTransformer
    @DefaultDataTableCellTransformer
    public Object autoConvertEnum(Object rawValue, Type targetType) {
        if (targetType instanceof Class && ((Class<?>) targetType).isEnum()) {
            return Enum.valueOf((Class<Enum>) targetType, rawValue.toString().trim().toUpperCase());
        }
        // 其他类型转换逻辑可在此扩展
        return rawValue;
    }
}

该方案无需单独为Map<Gender, String>写转换规则，Cucumber会自动识别枚举类型完成转换。

• 所有带Cucumber注解的配置类必须放在你配置的glue扫描路径下，否则Cucumber无法识别注册的转换规则
• 转换逻辑要和feature文件中填写的内容匹配，比如feature文件中写的是小写male，转换时要统一转成大写再匹配枚举值

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