本文探讨了如何在java程序中编程式地调用karate特性文件，以实现测试步骤的复用和数据交互。我们将介绍karate提供的`runner.path().parallel()` api，详细说明其使用方法，并讨论从特性文件获取变量的机制。同时，文章强调了karate的设计哲学，并提醒用户避免直接调用junit测试方法，以确保测试的正确执行和报告生成。
引言：Karate与Java集成的需求
在软件测试和自动化开发中，我们有时会遇到这样的场景：希望在Java应用程序中复用Karate定义的API测试逻辑，例如执行一个API请求、获取响应数据并进行处理。一个典型的需求是，Karate场景负责调用API并将其响应保存到文件中，而Java代码则需要进一步处理这个文件或直接使用Karate场景中获取的响应数据。然而，直接调用Karate的JUnit测试方法（如@Karate.Test注解的方法）并不能达到预期效果，因为这些方法主要是为JUnit测试框架集成和报告生成而设计的。
理解Karate的执行机制
Karate是一个API测试框架，其核心设计理念是提供一种简洁、易读的方式来定义API测试场景。JUnit Runner（如@Karate.Test注解的类和方法）主要用于将Karate测试集成到Java的测试生态系统中，负责测试的发现、执行调度和最终的报告生成。因此，直接通过Java代码实例化并调用@Karate.Test方法，实际上绕过了Karate和JUnit的内部执行机制，导致无法正确运行特性文件或获取执行结果。
使用Runner.path().parallel() API编程式调用Karate特性文件
Karate提供了一个专门的Java API，允许开发者在Java程序中编程式地执行特性文件，并获取执行结果，包括特性文件中定义的变量。这个API是com.intuit.karate.Runner类中的path().parallel()方法。
1. Karate特性文件示例
假设我们有一个Karate特性文件 RandomUser.feature，其内容如下：
立即学习“Java免费学习笔记（深入）”；
Feature: Random Users
Background:
* url 'https://askuser.me'
@get-user
Scenario: Get Random User data
Given path 'api'
When method get
Then status 200
* string json = response
* def Util = Java.type('com.example.mobiletest.utils.TestUtils')
* def SaveResponse = Util.writeToJSONFile(json,'randomuser.json')这个特性文件会向 https://askuser.me/api 发送GET请求，验证响应状态码为200，并将完整的响应体保存到一个名为 json 的Karate变量中。此外，它还调用了一个Java工具类 TestUtils 将响应写入 randomuser.json 文件。
2. Java代码编程式调用特性文件
现在，我们可以在Java代码中通过 Runner.path().parallel() 方法来执行这个特性文件：
import com.intuit.karate.Results;
import com.intuit.karate.Runner;
import java.io.File;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.util.Map;
public class ProgrammaticKarateExecutor {
public static void main(String[] args) {
// 定义特性文件的路径。
// 如果特性文件位于classpath下（例如 src/test/resources 或 src/test/java 的某个包内），
// 使用 "classpath:包路径/特性文件名.feature" 的格式。
// 假设 RandomUser.feature 位于 com/example/mobiletest 包下。
String featurePath = "classpath:com/example/mobiletest/RandomUser.feature";
System.out.println("开始执行Karate特性文件: " + featurePath);
// 使用 Runner.path().parallel(1) 来编程式执行特性文件。
// parallel(1) 表示以单线程模式执行，适用于需要顺序执行或不涉及并行测试的场景。
Results results = Runner.path(featurePath).parallel(1);
System.out.println("Karate特性文件执行完毕。");
// 检查执行结果
if (results.getFailCount() > 0) {
System.err.println("Karate特性文件执行失败，失败数量: " + results.getFailCount());
results.getErrors().forEach(e -> System.err.println("错误信息: " + e.getMessage()));
} else {
System.out.println("Karate特性文件执行成功，耗时: " + results.getElapsedTime() + " 毫秒。");
}
// 访问特性文件内部定义的变量
// results.getVariables() 返回一个Map，包含特性文件中通过 'def' 或 'string' 定义的变量。
Map<String, Object> featureVariables = results.getVariables();
if (featureVariables != null && featureVariables.containsKey("json")) {
String responseJson = (String) featureVariables.get("json");
System.out.println("从Karate特性文件中获取的JSON响应（部分内容）: \n" +
responseJson.substring(0, Math.min(responseJson.length(), 500)) + "...");
// 此时，Java程序可以对 responseJson 进行进一步的解析、验证或业务处理
} else {
System.out.println("未在Karate特性文件中找到名为'json'的变量。");
}
// 验证特性文件是否按预期生成了文件
File savedFile = new File("randomuser.json");
if (savedFile.exists()) {
System.out.println("Karate特性文件已将响应保存到文件: " + savedFile.getAbsolutePath());
try {
String fileContent = new String(Files.readAllBytes(Paths.get(savedFile.getAbsolutePath())));
System.out.println("文件内容（部分）: \n" +
fileContent.substring(0, Math.min(fileContent.length(), 500)) + "...");
} catch (IOException e) {
System.err.println("读取保存的文件时发生错误: " + e.getMessage());
}
} else {
System.out.println("Karate特性文件未生成 randomuser.json 文件。");
}
}
}在上述代码中：
- Runner.path(featurePath) 用于指定要执行的特性文件路径。Karate支持多种路径格式，包括 classpath: (从类路径加载) 和文件系统路径。
- .parallel(1) 指示Karate以单线程模式执行指定的特性文件。parallel() 方法的参数表示并行线程数。
- Results 对象包含了执行的统计信息（成功/失败数量、耗时等）以及特性文件中定义的变量。
- results.getVariables() 方法返回一个 Map<String, Object>，其中包含了特性文件中通过 * def 或 * string 等关键字定义的变量及其值。通过这个Map，Java代码可以访问Karate场景中生成或处理的数据。
注意事项与最佳实践
- Karate的设计哲学：Karate主要设计用于API测试和自动化，而非作为通用的Java工具库。如果您的核心需求是生成数据供Java代码使用，可以考虑让Karate作为独立的测试阶段运行，将结果输出到文件，然后Java代码再消费这些文件。过度地将Karate场景作为Java函数调用，可能会导致架构上的耦合和维护复杂性。
- 测试报告：Runner.path().parallel() 方法的执行结果会返回 Results 对象，但它不会自动生成标准的JUnit XML或HTML报告。如果需要完整的测试报告，通常应通过JUnit Runner来执行Karate测试。对于需要并行执行且生成报告的场景，Karate提供了更高级的并行执行API，如 Runner.builder().path(...).parallel(threads)，它能更好地集成报告机制。
- 路径配置：确保特性文件的路径配置正确无误。classpath: 前缀是推荐的方式，因为它使得特性文件与部署环境无关。
- 变量类型：从 results.getVariables() 获取的变量是 Object 类型，需要根据Karate特性文件中定义的实际类型进行适当的强制类型转换。
- 错误处理：在编程式调用Karate时，务必检查 Results 对象的 getFailCount()，并处理可能出现的错误，以确保程序的健壮性。
总结
通过com.intuit.karate.Runner类的path().parallel() API，开发者可以在Java程序中灵活地编程式调用Karate特性文件，实现测试逻辑的复用和数据交互。这种方式尤其适用于需要将Karate的API调用能力集成到更复杂的Java自动化流程或业务逻辑中的场景。然而，理解Karate的设计哲学并遵循最佳实践，对于构建可维护、高效的自动化解决方案至关重要。
