cucumber java 教程 Cucumber 是什么？如何使用 Cucumber Java 进行 API 测试？

cucumber java 教程 Cucumber 是什么？如何使用 Cucumber Java 进行 API 测试？

大家好，我是磊磊落落，目前我在技术上主要关注：Java、、架构设计、云原生和自动化测试。欢迎来我的博客（）获取我的最近更新！

是一个支持 BDD（- ，行为驱动开发）的自动化测试工具。

本文首先会对 BDD 进行介绍，接着对 中用到的概念进行介绍，最后以样例的方式演示如何使用 Java 进行 API 测试。

1 何为 BDD？

BDD 是一种软件开发流程cucumber java 教程 Cucumber 是什么？如何使用 Cucumber Java 进行 API 测试？，是 TDD（Test- ，测试驱动开发）的延伸，其强调技术团队与业务团队进行紧密协作，以确保开发出的软件满足业务需求。

BDD 的根基是在客户与开发团队之间使用一种「通用语言」来描述同一个系统，这样即可以避免因表达不一致而带来的问题（表达不一致是软件开发中常见的问题，由此造成的结果是开发人员的最终交付并不是客户所期望的）。使用通用语言，客户和开发人员可以一起定义出系统的行为，从而做出符合客户需求的设计。但光有设计cucumber java 教程 Cucumber 是什么？如何使用 Cucumber Java 进行 API 测试？，没有验证手段，也无法确定实现是否符合设计要求。所以，BDD 要求与测试进行结合，用系统行为的定义来验证实现代码。

BDD 关注的核心是设计，定义系统的行为是其主要工作，对系统行为的描述即是测试标准。

接下来了解一下 BDD 中的几个核心概念。

1.1 核心概念

接着看一下 BDD 的具体实施步骤。

1.2 BDD 的实施步骤

下面看一下 BDD 能带来哪些好处。

1.3 BDD 带来的好处

了解了 BDD 的基本概念，并且知道 是一个支持 BDD 测试的工具后。下面看一下如何使用 编写测试用例。

2 如何使用 编写测试用例？

特性文件由多个场景组成，每个场景使用 Given-When-Then 格式编写， 使用的这种语法格式称作 。

下面即是一个用于测试用户登录功能的 特性文件组成：

Feature: 登录功能
  用户可以成功登录系统
  Scenario: 用户输入正确的用户名和密码后可以成功登录系统
    Given 用户打开登录页面
    When 用户输入用户名 "test" 和密码 "password"
    And 用户点击登录按钮
    Then 用户成功登录系统

支持为 Given-When-Then 对应的每个步骤编写相应的测试代码（称作 Step ）。

一段使用 Java 语言编写的 Step 代码如下：

@Given("用户打开登录页面")
public void openLoginURL() {
    driver.get(URLConstants.LOGIN_URL);
}

执行完成后 会生成一个报告来展示每个场景执行成功或失败，从而验证软件是否满足需求。

介绍完 BDD 与 的基础知识后，下面尝试使用 进行一下 API 测试。

3 如何使用 进行 API 测试？

下面以测试「」为例来演示如何使用 进行 API 测试。

示例工程所使用的 JDK、Maven 与 版本如下：

JDK：BellSoft Liberica 17.0.7
Maven：3.9.2
Cucumber Java：7.17.0

因 仅支持特性文件的编写与代码的黏合，具体的测试代码编写还需要借助相应的工具。本文对 API 测试所使用的工具包为 REST （关于 REST 的具体使用，请参看本人之前写的一篇文章「如何使用 REST 做 API 测试？」）。

3.1 项目结构与 Maven 依赖

该示例测试项目使用 Maven 管理，其结构如下：

cucumber-api-test-demo
├─ src/test
│   ├─ java
│   │    └─ com.example.tests
│   │       ├─ stepdefs
│   │       │   └─ CreateIssueStep.java
│   │       ├─ utils
│   │       │   └─ ConfigUtil.java
│   │       └─ TestRunner.java
│   └─ resources
│       ├─ features
│       │   └─ github-issues.feature
│       └─ config.properties
└─ pom.xml

可以看到， 特性描述文件位于 src/test// 文件夹下，源码位于 src/test/java/com//tests 文件夹下。.java 为程序的入口文件；utils 包下的 .java 为配置文件工具类； 包下的 Java 类负责对 目录下的各个特性文件中定义的步骤作具体实现。

该示例项目用到的依赖如下：

<dependencies>
    
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-java</artifactId>
        <version>${cucumber.version}</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>cucumber-junit</artifactId>
        <version>${cucumber.version}</version>
        <scope>test</scope>
    </dependency>
    
    <dependency>
        <groupId>io.rest-assured</groupId>
        <artifactId>rest-assured</artifactId>
        <version>${rest-assured.version}</version>
        <scope>test</scope>
    </dependency>
    
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-databind</artifactId>
        <version>2.17.1</version>
        <scope>test</scope>
    </dependency>
    
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-api</artifactId>
        <version>${junit.version}</version>
        <scope>test</scope>
    </dependency>
</dependencies>

可以看到，除了使用 的两个核心包 -java、-junit 以及 JUnit 5 外，还使用 rest- 作 API 的请求发起与响应收集，使用 – 作 rest- 的请求体 JSON 序列化。

此外，还使用一个插件 maven– 来作 HTML 报告生成。

<plugin>
    <groupId>net.masterthought</groupId>
    <artifactId>maven-cucumber-reporting</artifactId>
    <version>5.8.1</version>
</plugin>

3.2 文件

该示例工程针对 API 的测试只有一个场景：新增一个 Issue。-. 特性文件内容如下：

# src/test/resources/features/github-issues.feature
Feature: GitHub Issues API 测试
  Scenario: 新增一个 Issue
    Given 新增一个标题为 "Cucumber API Test" 的 Issue
    Then 响应码为 201，响应体中的 Issue 标题为 "Cucumber API Test"

可以看到，针对「新增一个 Issue」的场景，我们使用 Given 来设定条件并发起请求，使用 Then 来验证响应结果。

3.3 Step 源码文件

如下为 -. 特性文件所列步骤对应的 Java 源码：

// src/test/java/com/example/tests/stepdefs/CreateIssueStep.java
package com.example.tests.stepdefs;
// ...
public class CreateIssueStep {
    private int statusCode;
    private String responseBody;
    @Given("新增一个标题为 {string} 的 Issue")
    public void createAnIssue(String title) {
        // request
        Map requestBody = prepareRequestBody(title);
        // response
        Response response = given().contentType(ContentType.JSON)
                .accept(ContentType.JSON)
                .header("Authorization", "Bearer " + ConfigUtil.getProperty("GITHUB_TOKEN"))
                .body(requestBody)
                .post("/issues")
                .then()
                .extract().response();
        // extract
        this.statusCode = response.getStatusCode();
        this.responseBody = response.asString();
    }
    @Then("响应码为 {int}，响应体中的 Issue 标题为 {string}")
    public void responseShouldBeValid(int statusCode, String title) {
        // extract fields
        String issueTitle = from(responseBody).getString("title");
        // assertions
        assertThat(statusCode, equalTo(this.statusCode));
        assertThat(title, equalTo(issueTitle));
    }
    private Map prepareRequestBody(String title) {
        Map requestBody = new HashMap();
        requestBody.put("title", title);
        requestBody.put("body", "test");
        return requestBody;
    }
}

可以看到，我们为特性文件中对应步骤的实现方法加上了关键字 @Given、@Then，然后在 @Given 方法中使用 REST 组装和发起请求，在 @Then 方法中校验了响应结果。

3.4 程序启动文件

下面为该测试项目的启动文件：

// src/test/java/com/example/tests/TestRunner.java
package com.example.tests;
// ...
@RunWith(Cucumber.class)
@CucumberOptions(
        features = "src/test/resources/features",
        plugin = {"json:target/cucumber.json"}
)
public class TestRunner {
    @BeforeClass
    public static void setUp() {
        baseURI = ConfigUtil.getProperty("GITHUB_BASE_URI");
    }
}

可以看到，我们为该类加上了注解 @(.class)，表示其执行由 来负责；还在该类上使用了注解 @ 指定了特性文件所在目录以及生成的测试结果 JSON 文件所在目录。

静态 setUp() 方法负责设置全局的 REST ，这样在 Step 中发起请求时就不必写完整 URL 了。

3.5 执行测试与报告展示

测试用例编写完成后，可以使用如下 Maven 命令执行测试：

mvn clean verify

其会在如下文件夹生成 HTML 测试报告：

target/cucumer-report-html

使用浏览器打开，效果如下：

可以看到，我们在特性文件中定义的各个步骤都运行正常cucumber java 教程，测试通过。

4 小结

本文为 的初探。因 为一个支持 BDD 的测试工具cucumber java 教程cucumber java 教程，本文首先介绍了 BDD 的基本概念，接着介绍了 的基础知识，最后以测试一个 API 为例演示了 的具体使用。

本文完整示例工程已提交至本人 ，欢迎关注或 Fork。

参考资料

: – .io/docs/…

百度百科：行为驱动开发 – /item/行为驱动开发

磊磊落落：如何使用 REST 做 API 测试？ – /posts/how-t…

Docs: REST API for – /en/rest/iss…