基于Poiji库实现Cucumber通用数据集加载的单类优化方案
单类通用Poiji测试数据加载改造方案
核心改造思路
原有架构的冗余根源是通过类继承传递实体Class类型:为了获取某个实体的Class对象,专门设计了抽象类、还为每个实体写专属读取子类,本质完全可以把Class对象作为方法入参直接传递,彻底废弃这套抽象继承结构,用一个无状态通用类承载所有Excel读取逻辑即可。
分步改造实现
1. 替换原有抽象读取类为通用单类
删除原有的抽象类ReadingExcelUsingPoiji,新建无状态通用Poiji加载器,全局仅需注册一次即可复用:
public class GenericPoijiExcelLoader { // 预构建固定配置,避免每次加载重复初始化 private static final PoijiOptions DEFAULT_POIJI_CONFIG = PoijiOptions.PoijiOptionsBuilder.settings() .addListDelimiter(";") .build(); /** * 通用Excel转实体方法 * @param filePath Excel文件路径 * @param targetClass 需映射的实体类型 * @return 映射完成的实体列表 * @param <T> 实体泛型 */ public <T> List<T> loadExcel(String filePath, Class<T> targetClass) { try { return Poiji.fromExcel(new File(filePath), targetClass, DEFAULT_POIJI_CONFIG); } catch (IOException e) { throw new RuntimeException("Excel文件读取失败: " + filePath, e); } } }
2. 改造通用步骤父类
原有的LoadDataStepDfn不再绑定专属读取类,直接注入通用加载器,对外暴露带实体类型参数的通用加载方法:
public abstract class LoadDataStepDfn<T> { // 存储当前步骤加载完成的实体数据 public List<T> data; // 全局注入通用加载器,无需和具体读取实现耦合 @Inject protected GenericPoijiExcelLoader excelLoader; /** * 子类调用的通用数据加载入口 * @param filePath Excel文件路径 * @param targetType 当前步骤对应的实体Class */ protected void loadTestData(String filePath, Class<T> targetType) throws Throwable { this.data = excelLoader.loadExcel(filePath, targetType); } }
3. 简化具体步骤定义类
原来需要构造函数注入专属读取类的步骤类,现在只需要在调用加载方法时传入对应的实体Class即可,原有的ReadingUserUsingPoiji这类专属子类可以直接删除:
public class LoadUserStepDfn extends LoadDataStepDfn<User> { @Given("^Data is loaded from \"([^\"]*)\"$") public void data_is_loaded_from(String filePath) throws Throwable { // 直接传入User.class即可完成加载,无需额外读取实现 super.loadTestData(filePath, User.class); } }
方案优势
- 彻底移除抽象读取类、各实体对应的专属读取子类,减少无效类定义
- 通用加载器无状态,仅需在依赖注入容器中注册一次,所有测试步骤均可复用
- 后续新增实体类型的测试步骤时,仅需在调用加载方法时传入对应实体Class,不需要编写任何读取相关的适配代码
- 保留原有的Cucumber步骤定义兼容逻辑,不需要修改已有的Gherkin场景语法
- 如果后续需要适配自定义读取规则(比如自定义行偏移、特殊分隔符),可以直接给通用加载器方法加重载参数,不需要调整类结构
内容的提问来源于stack exchange,提问作者zakaria janah
相关产品推荐
相关产品推荐

