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入门示例来看,
- 规格文件, 文件名是 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!"
- 步骤函数类文件 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 的选项的值, 获取的步骤如下:
- 使用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>
- 接下来是获取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 中执行及结果如下: