Java中如何用Cucumber实现BDD测试-Java-PHP中文网

Java中如何用Cucumber实现BDD测试

裘德小鎮的故事

发布： 2025-06-24 23:28:01

原创

962人浏览过

cucumber在java中通过gherkin语言实现bdd测试，使非技术人员可参与测试定义。1. 环境搭建：创建maven或gradle项目并添加cucumber依赖；2. 编写feature文件：使用gherkin描述测试场景并存放在指定目录；3. 编写step definitions：将feature步骤映射到java代码；4. 运行测试：创建runner类运行cucumber测试；5. 数据传递：使用scenario outline参数化测试或依赖注入共享状态；6. 异步测试：利用countdownlatch等待异步操作完成；7. ci/cd集成：通过执行maven或gradle命令运行测试并与流水线结合。

Java中如何用Cucumber实现BDD测试

Cucumber在Java中实现BDD（行为驱动开发）测试，简单来说，就是用可读性极高的Gherkin语言描述你的软件行为，然后用Java代码将这些描述转化为可执行的测试用例。这让非技术人员也能参与到测试的定义中，确保开发和业务目标一致。

Cucumber + Java，让测试更贴近业务！

步骤一：环境搭建，磨刀不误砍柴工

首先，你需要一个Java项目，Maven或者Gradle都行。然后在pom.xml或者build.gradle中添加Cucumber相关的依赖。

立即学习“Java免费学习笔记（深入）”；

Maven的依赖示例：

<dependency>
    <groupId>io.cucumber</groupId>
    <artifactId>cucumber-java</artifactId>
    <version>7.0.0</version> <!-- 使用最新版本 -->
    <scope>test</scope>
</dependency>

<dependency>
    <groupId>io.cucumber</groupId>
    <artifactId>cucumber-junit</artifactId>
    <version>7.0.0</version> <!-- 使用最新版本 -->
    <scope>test</scope>
</dependency>

登录后复制

记得刷新你的Maven或者Gradle，确保依赖下载成功。如果你用的是JUnit 5，那就引入对应的Cucumber JUnit Platform Engine。

步骤二：编写Feature文件，故事的开始

Feature文件用Gherkin语言描述你的测试场景。Gherkin是一种简单的、人类可读的语言，看起来就像故事一样。

例如，一个简单的登录场景：

Feature: 用户登录

  Scenario: 成功的登录
    Given 用户打开登录页面
    When 用户输入正确的用户名和密码
    And 点击登录按钮
    Then 用户应该看到欢迎信息

登录后复制

这个文件放在哪里？通常放在src/test/resources/features目录下。当然，目录结构可以自定义，在运行Cucumber时指定即可。

步骤三：编写Step Definitions，将故事变成现实

Step Definitions是将Feature文件中的步骤与Java代码关联起来的关键。每一个Given, When, Then, And, But 都需要对应一个Java方法。

import io.cucumber.java.en.Given;
import io.cucumber.java.en.When;
import io.cucumber.java.en.Then;
import io.cucumber.java.en.And;
import static org.junit.Assert.*;

public class LoginSteps {

    @Given("用户打开登录页面")
    public void 用户打开登录页面() {
        // 打开登录页面的代码
        System.out.println("打开登录页面");
    }

    @When("用户输入正确的用户名和密码")
    public void 用户输入正确的用户名和密码() {
        // 输入用户名和密码的代码
        System.out.println("输入用户名和密码");
    }

    @And("点击登录按钮")
    public void 点击登录按钮() {
        // 点击登录按钮的代码
        System.out.println("点击登录按钮");
    }

    @Then("用户应该看到欢迎信息")
    public void 用户应该看到欢迎信息() {
        // 验证是否显示欢迎信息的代码
        System.out.println("验证是否显示欢迎信息");
        assertTrue(true); // 假设验证通过
    }
}

登录后复制

这些Java类放在哪里？通常放在src/test/java目录下，和你的测试代码放在一起。注意，注解里的字符串要和Feature文件里的步骤完全一致。

步骤四：运行Cucumber测试，见证奇迹

最后，你需要一个Runner类来运行你的Cucumber测试。

import io.cucumber.junit.Cucumber;
import io.cucumber.junit.CucumberOptions;
import org.junit.runner.RunWith;

@RunWith(Cucumber.class)
@CucumberOptions(
        features = "src/test/resources/features", // Feature文件存放的目录
        glue = "com.example.steps" // Step Definitions所在的包
)
public class RunCucumberTest {
}

登录后复制

features 指定Feature文件的位置，glue 指定Step Definitions所在的包。运行这个Runner类，Cucumber就会自动找到Feature文件和对应的Step Definitions，并执行测试。

如何处理Cucumber测试中的数据传递？

Cucumber提供了一些机制来处理数据传递，例如使用Scenario Outline和Examples来参数化测试，或者使用Dependency Injection来共享状态。

Scenario Outline允许你使用不同的数据集运行同一个Scenario。

Scenario Outline: 使用不同的用户名和密码登录
    Given 用户打开登录页面
    When 用户输入用户名 "<username>" 和密码 "<password>"
    And 点击登录按钮
    Then 用户应该看到 "<message>"

    Examples:
      | username | password | message          |
      | validUser | validPass | 欢迎回来，validUser |
      | invalidUser | invalidPass | 登录失败          |

登录后复制

在Step Definitions中，你可以使用参数：

@When("用户输入用户名 {string} 和密码 {string}")
public void 用户输入用户名_和密码(String username, String password) {
    // 使用username和password进行登录操作
    System.out.println("用户名: " + username + ", 密码: " + password);
}

@Then("用户应该看到 {string}")
public void 用户应该看到(String message) {
    // 验证是否显示message
    System.out.println("消息: " + message);
}

登录后复制

Dependency Injection可以通过 PicoContainer, Spring, Guice 等框架来实现，允许你在不同的Step Definitions之间共享对象。

如何进行异步操作的测试？

测试异步操作会稍微复杂一些。你需要确保你的Step Definitions能够等待异步操作完成，然后再进行断言。

一种方法是使用CountDownLatch。

import java.util.concurrent.CountDownLatch;
import java.util.concurrent.TimeUnit;
import io.cucumber.java.en.Given;
import io.cucumber.java.en.When;
import io.cucumber.java.en.Then;
import static org.junit.Assert.*;

public class AsyncSteps {

    private CountDownLatch latch;
    private String result;

    @Given("异步任务开始")
    public void 异步任务开始() {
        latch = new CountDownLatch(1);
    }

    @When("异步任务执行")
    public void 异步任务执行() {
        new Thread(() -> {
            // 模拟异步任务
            try {
                Thread.sleep(2000); // 模拟耗时操作
                result = "任务完成";
            } catch (InterruptedException e) {
                e.printStackTrace();
            } finally {
                latch.countDown(); // 任务完成后减少计数器
            }
        }).start();
    }

    @Then("异步任务应该完成")
    public void 异步任务应该完成() throws InterruptedException {
        latch.await(5, TimeUnit.SECONDS); // 等待异步任务完成，最多等待5秒
        assertEquals("任务完成", result);
    }
}

登录后复制

在这个例子中，CountDownLatch用于等待异步任务完成。 latch.await() 会阻塞当前线程，直到计数器变为0，或者超时。