Cucumber-JVM的示例和运行解析

Cucumber-JVM 是一个支持 Behavior-Driven Development (BDD) 的 Java 框架。在 BDD 中，可以编写可读的描述来表达软件功能的行为，而这些描述也可以作为自动化测试。

Cucumber-JVM 的最小化环境

Cucumber-JVM是BDD的框架， 提供了GWT语法的相关库， 但是其本身没有提供断言库，需要借助其他的单元测试框架。

所以最小化环境需要导入Cucumber-JVM的库 + 单元测试框架（比如JUnit）。

1. 环境搭建

使用Maven 导入的方式如下：

        <dependency><groupId>io.cucumber</groupId><artifactId>cucumber-java</artifactId><version>7.15.0</version><scope>test</scope></dependency><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.12</version><scope>test</scope></dependency>

2.测试规格和代码

基本环境导入之后， 就可以开始编写BDD的规格和步骤函数了， 以最简单的Hello World入门示例来看，

1. 规格文件， 文件名是 hello_world.feature
   内容如下：

Feature: Hello WorldScenario: Running a simple hello world functionGiven the system is readyWhen I ask it to say helloThen it should answer with "Hello, World!"

2. 步骤函数类文件 HelloWorldSteps.java

/*** Description:* Author: XM Chen* Date: 2023-12-27*/
package com.osxm.bdd.usage;import io.cucumber.java.en.Given;
import io.cucumber.java.en.Then;
import io.cucumber.java.en.When;
import static org.junit.Assert.*;public class HelloWorldSteps {private String actualAnswer;@Given("the system is ready")public void the_system_is_ready() {// 在这里可以进行一些初始化操作}@When("I ask it to say hello")public void i_ask_it_to_say_hello() {actualAnswer = getHelloWorld();}@Then("it should answer with {string}")public void it_should_answer_with(String expectedAnswer) {assertEquals(expectedAnswer, actualAnswer);}private String getHelloWorld() {// 这里是你的 Hello World 函数实现return "Hello, World!";}
}

项目的目录结构如下：

3. 测试的运行

可以使用命令行的方式运行BDD 测试，

java -cp "path/to/each/jar:path/to/compiled/.class/files" io.cucumber.core.cli.Main /path/to/your/feature/files --glue hellocucumber --glue anotherpackage

该命令的解释如下：

• java: 运行Java虚拟机的命令。
• -cp: 设置classpath，用于指定要加载的类和包含依赖项的JAR文件的路径。
• "path/to/each/jar:path/to/compiled/.class/files": 指定JAR文件和编译后的.class文件的路径。多个路径用冒号分隔。
• io.cucumber.core.cli.Main: 指定要运行的Cucumber主类。
• /path/to/your/feature/files: 指定要运行的Cucumber特性文件的路径。
• --glue hellocucumber: 指定要运行的Cucumber步骤定义文件的包名。在这个例子中，hellocucumber是一个包含Cucumber步骤定义类的包。
• --glue anotherpackage: 指定另一个包含Cucumber步骤定义类的包。在这个例子中，anotherpackage是另一个包含Cucumber步骤定义类的包，可以在同一个测试中使用。

就本篇的例子来说， 要组成这个命令行，需要获取所有的需要的jar 档， 也就是 -cp 的选项的值， 获取的步骤如下：

1. 使用maven 将所有jar 复制到target\test-classes目录下
   方式是在pom.xml 加入以下配置：

    <build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-dependency-plugin</artifactId><version>3.1.2</version><executions><execution><id>copy-dependencies</id><phase>package</phase><goals><goal>copy-dependencies</goal></goals><configuration><outputDirectory>D:\devworkspace\vs\bdd-ency\target\test-classes\lib</outputDirectory></configuration></execution></executions></plugin></plugins></build>

2. 接下来是获取lib 目录下的文件名，并且以分号分隔， 这个使用python 可以很容易实现，
   python 的代码类似：

import os# 获取Windows目录
windows_dir = os.environ['lib']# 列出目录下的文件名
file_names = os.listdir(windows_dir)# 以 ; 分割文件名
file_names_str = ';'.join(file_names)print(file_names_str)

使用bat 命令也可以做到
dir lib /b /a-d > files.txt
汇总后的Java命令行是：

java  -cp lib/apiguardian-api-1.1.2.jar;lib/ci-environment-10.0.0.jar;lib/cucumber-core-7.15.0.jar;lib/cucumber-expressions-17.0.1.jar;lib/cucumber-gherkin-7.15.0.jar;lib/cucumber-gherkin-messages-7.15.0.jar;lib/cucumber-java-7.15.0.jar;lib/cucumber-plugin-7.15.0.jar;lib/datatable-7.15.0.jar;lib/docstring-7.15.0.jar;lib/gherkin-26.2.0.jar;lib/hamcrest-core-1.3.jar;lib/html-formatter-20.4.0.jar;lib/junit-4.12.jar;lib/junit-xml-formatter-0.2.0.jar;lib/messages-22.0.0.jar;lib/tag-expressions-6.0.0.jar;./ io.cucumber.core.cli.Main  features --glue com.osxm

执行的结果如下图：

在JUnit 4中导入 cucumber-junit 更便捷的运行测试

上面的命令行运行方式很麻烦， cucumber其实提供了很便捷的运行方式， 在使用JUnit 4的项目中， 可以导入cucumber-junit。

         <dependency><groupId>io.cucumber</groupId><artifactId>cucumber-junit</artifactId><version>7.15.0</version><scope>test</scope></dependency>

导入之后， 新增一个RunCucumberTest.java 文件，内容如下：

/*** Description:* Author: XM Chen* Date: 2023-12-27*/
package com.osxm.bdd.usage;import io.cucumber.junit.Cucumber;
import io.cucumber.junit.CucumberOptions;
import org.junit.runner.RunWith;@RunWith(Cucumber.class)
@CucumberOptions(features = "src/test/resources", plugin = {"pretty"})
public class RunCucumberTest {// 不需要添加代码，这个类作为配置和测试运行的入口点
}

创建之后在IDE中就可以直接运行这个文件了， 比如在VS Code 中执行及结果如下：

---

---