Qtest与Karate API自动化框架集成及Tokens类不存在问题求助

问题核心 #

你遇到的Tokens类不存在问题，是因为qtest-sdk-java 1.4.10版本已对认证模块进行了重构，旧示例代码中依赖的Tokens类已被移除，改用了更贴合OAuth2标准的认证实现。

集成步骤（适配1.4.10版本） #

1. 确认依赖配置

确保你的构建工具（Maven/Gradle）中依赖正确引入：

• Maven：

<dependency>
    <groupId>com.qasymphony.qtest</groupId>
    <artifactId>qtest-sdk-java</artifactId>
    <version>1.4.10</version>
</dependency>

• Gradle：

implementation 'com.qasymphony.qtest:qtest-sdk-java:1.4.10'

2. 初始化QTest客户端（替代Tokens类的认证方式）

1.4.10版本使用QtestClient结合API密钥或用户名密码完成认证，示例代码：

import com.qasymphony.qtest.client.QtestClient;
import com.qasymphony.qtest.client.QtestClientBuilder;

public class QTestIntegration {
    private static QtestClient qtestClient;

    public static void initQTestClient() {
        // 方式1：使用API密钥认证（推荐）
        qtestClient = QtestClientBuilder.newBuilder()
                .setBaseUrl("你的QTest实例地址，如https://your-domain.qtestnet.com")
                .setApiKey("你的QTest API密钥")
                .build();

        // 方式2：使用用户名密码认证
        // qtestClient = QtestClientBuilder.newBuilder()
        //         .setBaseUrl("你的QTest实例地址")
        //         .setUsername("你的QTest用户名")
        //         .setPassword("你的QTest密码")
        //         .build();
    }
}

3. 与Karate框架集成上报测试结果

在Karate的全局钩子（如单独的Java钩子类）中，添加测试结果上报逻辑：

import com.intuit.karate.core.ScenarioResult;
import com.qasymphony.qtest.client.QtestClient;
import com.qasymphony.qtest.model.TestCaseResult;
import com.qasymphony.qtest.model.TestCaseResult.Status;

public class KarateQTestHook {
    public static void afterScenario(ScenarioResult result) {
        // 初始化客户端（可提前在全局初始化）
        QTestIntegration.initQTestClient();
        QtestClient client = QTestIntegration.qtestClient;

        // 构造测试结果
        TestCaseResult testCaseResult = new TestCaseResult();
        testCaseResult.setTestCaseId("你的QTest测试用例ID"); // 需提前关联Karate用例与QTest用例ID
        testCaseResult.setStatus(result.isPassed() ? Status.PASS : Status.FAIL);
        testCaseResult.setExecutionDate(System.currentTimeMillis());
        testCaseResult.setNotes("测试结果详情：" + result.getErrorMessages());

        // 上报结果到QTest
        try {
            client.testCaseResults().create(testCaseResult);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

在Karate的特性文件中绑定钩子：

Feature: API测试示例
  Background:
    * configure afterScenario = com.example.KarateQTestHook.afterScenario

  Scenario: 测试API接口
    Given url 'https://api.example.com/users'
    When method get
    Then status 200

关键注意事项 #

• 用例ID关联：需要将Karate的测试场景与QTest中的测试用例ID对应，可通过配置文件或标签方式动态传入，避免硬编码。
• 权限验证：确保QTest的API密钥/账号拥有测试结果上报的权限，否则会返回403错误。
• 依赖冲突：检查项目中是否存在其他HTTP客户端依赖（如OkHttp），避免与qtest-sdk-java内置的依赖版本冲突。

内容的提问来源于stack exchange，提问作者Shruti Gupta