Cucumber：跨步骤定义调用方法的最佳实践及Web服务自动化问题

针对你在Web服务自动化中需要跨步骤共享生成的URL并执行后续请求的场景，结合你已有的StepDefinitionBase文件，以下是几个经过实践验证的最佳实践：

1. 基于现有基类（StepDefinitionBase）共享方法与上下文 #

这是最贴合你当前架构的方案，因为你已经有了负责上下文初始化、存储和清理的基类。我们可以把通用方法（比如生成运行时URL的逻辑）也放在基类中，让所有步骤定义类继承它，这样就能在任意步骤里调用这些方法，同时通过上下文共享数据。

举个具体实现示例：
首先在StepDefinitionBase中添加URL生成方法和上下文引用：

public class StepDefinitionBase {
    // 确保TestContext是线程安全的，比如用ThreadLocal存储数据，避免并行场景数据污染
    protected TestContext testContext;

    public StepDefinitionBase(TestContext testContext) {
        this.testContext = testContext;
    }

    // 封装生成运行时URL的通用方法
    protected String generateRuntimeUrl(String resourceId) {
        return "api/test/" + resourceId;
    }
}

然后在Given步骤的实现类中继承基类，调用方法生成URL并存入上下文：

public class ResourceSetupSteps extends StepDefinitionBase {

    public ResourceSetupSteps(TestContext testContext) {
        super(testContext);
    }

    @Given("^我有一个ID为(\\d+)的测试资源$")
    public void setupTestResource(int resourceId) {
        String runtimeUrl = generateRuntimeUrl(String.valueOf(resourceId));
        // 将URL存入上下文供后续步骤使用
        testContext.put("targetResourceUrl", runtimeUrl);
    }
}

最后在执行PUT请求的步骤类中，同样继承基类，从上下文取出URL：

public class ResourceUpdateSteps extends StepDefinitionBase {
    private final RestClient restClient; // 假设你有封装的HTTP客户端

    public ResourceUpdateSteps(TestContext testContext, RestClient restClient) {
        super(testContext);
        this.restClient = restClient;
    }

    @When("^我对该资源执行PUT请求$")
    public void executePutRequest() {
        String targetUrl = testContext.get("targetResourceUrl");
        restClient.put(targetUrl, /* 请求体数据 */);
    }
}

2. 利用依赖注入（DI）共享工具类 #

如果你的项目使用了Spring、Guice这类DI框架，推荐把通用方法封装成独立的工具类，通过DI注入到各个步骤定义类中，这种方式更符合单一职责原则，也避免了过度依赖继承。

比如创建专门的UrlGenerator工具类：

@Component // 如果用Spring的话添加该注解
public class UrlGenerator {
    public String generateRuntimeUrl(String resourceId) {
        return "api/test/" + resourceId;
    }
}

然后在步骤类中通过构造函数注入该工具类和上下文：

public class ResourceSetupSteps {
    private final TestContext testContext;
    private final UrlGenerator urlGenerator;

    // 构造函数注入依赖
    public ResourceSetupSteps(TestContext testContext, UrlGenerator urlGenerator) {
        this.testContext = testContext;
        this.urlGenerator = urlGenerator;
    }

    @Given("^我有一个ID为(\\d+)的测试资源$")
    public void setupTestResource(int resourceId) {
        String runtimeUrl = urlGenerator.generateRuntimeUrl(String.valueOf(resourceId));
        testContext.put("targetResourceUrl", runtimeUrl);
    }
}

3. 绝对要避免的做法：直接调用其他步骤类的方法 #

很多新手会尝试在一个步骤类中直接实例化另一个步骤类并调用其方法，比如：

// 不推荐！！！
@When("^我对该资源执行PUT请求$")
public void executePutRequest() {
    ResourceSetupSteps setupSteps = new ResourceSetupSteps(testContext);
    String url = setupSteps.someMethodToGetUrl(); // 直接调用其他步骤类的方法
    // ...执行请求
}

这种做法会导致步骤间严重耦合，一旦某个步骤的实现逻辑修改，所有依赖它的步骤都要跟着调整，完全违背了Cucumber“测试用例与实现逻辑松耦合”的设计初衷，后期维护成本极高。

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