首页 > Java > java教程 > 正文

如何在Java Pact契约中动态注入Body ID

花韻仙語
发布: 2025-11-11 13:20:19
原创
413人浏览过

如何在java pact契约中动态注入body id

本文详细介绍了在Java中使用Pact进行契约测试时,如何动态注入请求体中的ID。通过结合Pact Provider的@State注解和Consumer端PactDslJsonBody的valueFromProviderState方法,实现了在测试前创建数据并将其动态ID传递给Consumer契约,确保契约测试的灵活性和真实性,避免硬编码ID带来的问题。

在微服务架构中,契约测试是确保服务间兼容性的关键环节。Pact作为一种流行的契约测试框架,允许消费者和生产者独立验证它们之间的API契约。然而,当API请求体中的某些字段(如ID)是动态生成时,如何有效地在Pact契约中处理这些动态值成为了一个挑战。本文将深入探讨在Java Pact契约中动态注入请求体ID的方法。

动态ID注入的挑战与Pact解决方案

在实际应用中,许多API操作(例如更新资源)需要一个预先存在的ID。在测试环境中,为了保证测试的隔离性和数据清洁,我们通常会在每次测试前创建新的数据,这意味着其ID是动态的。如果Pact契约中硬编码了这些ID,那么在Provider端执行契约验证时,这些硬编码的ID可能不再有效,导致测试失败。

Pact通过Provider States(生产者状态)机制解决了这一问题。Provider States允许生产者在运行契约验证之前,根据消费者定义的状态设置其系统,包括创建必要的测试数据并提供动态生成的数据(如ID)给消费者契约。

立即学习Java免费学习笔记(深入)”;

1. 生产者(Provider)端的配置

生产者需要定义一个或多个状态,这些状态会在契约验证之前执行,用于准备测试数据。

1.1 数据准备与状态定义

在Provider类中,我们使用@BeforeEach注解来设置测试前的数据,并使用@State注解来定义一个Provider State。

千面视频动捕
千面视频动捕

千面视频动捕是一个AI视频动捕解决方案,专注于将视频中的人体关节二维信息转化为三维模型动作。

千面视频动捕 27
查看详情 千面视频动捕
@Slf4j
@Provider("Assignments API")
@Consumer("LTI-AGS-Tool")
@VerificationReports(value = {"console", "markdown"}, reportDir = "target/pacts")
class PactProviderLTIAGSIT {

    private HashMap<String, String> headers = new HashMap<>();
    private String updateAssignmentId; // 用于存储动态生成的ID
    private final String SERVICE_TOKEN = "myToken";

    @BeforeEach
    void createTeacherAssignment() {
        // ... (省略创建assignmentBody的逻辑) ...
        String assignmentBody = createBodyStringForStudentAssignmentSetup(); // 假设此方法生成初始body
        assignmentBody = assignmentBody.replace("CPWAG", "OTHER_TEXT_RESOURCE");

        headers.put("Content-Type", "application/json");
        headers.put("Authorization", SERVICE_TOKEN); // 使用SERVICE_TOKEN

        // 假设 Util.getRequestSpecification() 提供了一个可配置的 RequestSpecification
        RequestSpecification rq = Util.getRequestSpecification().baseUri(baseAssignmentUrl).headers(headers);
        Response response = rq.body(assignmentBody).post();
        assertEquals(201, response.getStatusCode());

        // 从响应中提取动态生成的ID
        updateAssignmentId = response.jsonPath().get("assignments[0].refId");
        log.info("assignment id is " + updateAssignmentId);
    }

    // 定义一个Provider State,用于将动态ID传递给消费者
    @State("Scoring info is passed between ags-tool and assignmentapi")
    Map<String, Object> getScoringInfo() {
        Map<String, Object> map = new HashMap<>();
        // 将动态生成的ID放入map中,Pact将通过此map传递给消费者契约
        map.put("assignmentId", updateAssignmentId);
        return map;
    }

    @BeforeEach
    void before(PactVerificationContext context) {
        // 设置Pact验证的目标服务
        context.setTarget(new HttpsTestTarget(BASE_PACT_TEACHER_ASSIGNMENTS_URL, 443, ""));
    }

    @TestTemplate
    @ExtendWith(PactVerificationInvocationContextProvider.class)
    void pactTestTemplate(PactVerificationContext context, HttpRequest request) {
        request.addHeader("Authorization", SERVICE_TOKEN);
        // logCurlFromPact(context, request); // 可选:打印CURL请求
        context.verifyInteraction();
    }
}
登录后复制

关键点说明:

  • @BeforeEach void createTeacherAssignment(): 在每次测试模板执行前,此方法会创建一个新的assignment并获取其生成的refId。这个refId就是我们需要动态注入的ID。
  • @State("Scoring info is passed between ags-tool and assignmentapi") Map<String, Object> getScoringInfo():
    • @State注解的字符串值必须与消费者契约中builder.given()方法使用的状态名称完全匹配。
    • 该方法返回一个Map<String, Object>,其中包含了需要传递给消费者契约的动态数据。在这里,我们将updateAssignmentId放入map中,键名为"assignmentId"。Pact框架会在Provider验证时,将这个map中的数据提供给消费者契约。

2. 消费者(Consumer)契约的定义

消费者契约需要声明它依赖于特定的Provider State,并且在请求体中使用Pact提供的DSL来引用Provider State中传递的动态值。

2.1 引用Provider State中的动态值

在消费者契约中,我们使用PactDslJsonBody的valueFromProviderState方法来动态地填充请求体中的ID。

@ExtendWith(PactConsumerTestExt.class)
class PactConsumerSendScoreIT {

    private final Map<String, String> headers = new HashMap<>();
    private final String path = "/v5/assignmentStatus/update";

    @Pact(provider = PACT_PROVIDER, consumer = PACT_CONSUMER)
    public RequestResponsePact scoreConsumerPact(PactDslWithProvider builder) {

        headers.put("Content-Type", "application/json");

        DslPart body = new PactDslJsonBody()
                // 关键:使用 valueFromProviderState 动态注入 ID
                // 第一个参数: 契约中此字段的名称
                // 第二个参数: 引用Provider State中map的键,对于字符串类型需要使用 ${} 进行插值
                // 第三个参数: 消费者端测试时使用的示例值(当没有真实Provider时)
                .valueFromProviderState("assignmentId", "${assignmentId}", "c1ef3bbf-55a2-4638-8f93-22b2916fe085")
                .stringType("timestamp", DateTime.now().plusHours(3).toString())
                .decimalType("scoreGiven", 75.00)
                .decimalType("scoreMaximum", 100.00)
                .stringType("comment", "Good work!")
                .stringType("status", "IN_PROGRESS")
                .stringType("userId", "c2ef3bbf-55a2-4638-8f93-22b2916fe085")
                .close();

        return builder
                // 声明此契约依赖于名为 "Scoring info is passed between ags-tool and assignmentapi" 的Provider State
                .given("Scoring info is passed between ags-tool and assignmentapi")
                .uponReceiving("Scoring info is passed between ags-tool and assignmentapi")
                .path(path)
                .method("POST")
                .body(body)
                .headers(headers)
                .willRespondWith()
                .status(201)
                .body(body) // 响应体中也可能包含动态ID,此处示例与请求体相同
                .toPact();
    }

    @Test
    @PactTestFor(pactMethod = "scoreConsumerPact", providerName = PACT_PROVIDER, port = "8080", pactVersion = PactSpecVersion.V3)
    void runTest(MockServer mockServer) {
        // 消费者测试时,使用示例值或者自行模拟一个ID
        String updateAssignmentId = "c2ef3bbf-55a2-4638-8f93-22b2916fe085";

        HashMap<String, Object> map = new HashMap<>();
        map.put("timestamp", DateTime.now().plusHours(3).toString());
        map.put("scoreGiven", 75.00);
        map.put("scoreMaximum", 100.00);
        map.put("comment", "Good work!");
        map.put("status", "IN_PROGRESS");
        map.put("userId", "c2ef3bbf-55a2-4638-8f93-22b2916fe085");
        map.put("assignmentId", updateAssignmentId); // 消费者测试时使用此ID

        RequestSpecification rq = Util.getRequestSpecification().baseUri(mockServer.getUrl()).headers(headers);

        Response response = rq.body(map)
                .post(path);

        assertEquals(201, response.getStatusCode());
    }
}
登录后复制

关键点说明:

  • builder.given("Scoring info is passed between ags-tool and assignmentapi"): 消费者契约通过此方法声明它依赖于Provider端定义的特定状态。状态名称必须与Provider端@State注解的值完全一致。
  • DslPart body = new PactDslJsonBody().valueFromProviderState("assignmentId", "${assignmentId}", "c1ef3bbf-55a2-4638-8f93-22b2916fe085"):
    • 这是实现动态ID注入的核心。
    • 第一个参数 "assignmentId": 这是请求体中期望的JSON字段名。
    • 第二个参数 "${assignmentId}": 这是引用Provider State中值的表达式。特别注意:当引用Provider State中的字符串类型值时,需要使用${}语法进行插值。Pact框架会解析这个表达式,并用Provider State中assignmentId键对应的值替换它。
    • 第三个参数 "c1ef3bbf-55a2-4638-8f93-22b2916fe085": 这是一个示例值。当消费者独立运行契约测试(即没有连接到真实的Provider)时,Pact Mock Server会使用这个示例值来模拟响应。这确保了消费者测试的独立性。
  • @PactTestFor 和 runTest: 消费者测试方法在本地使用Pact Mock Server运行,它会根据契约中定义的示例值来模拟请求和响应。当Provider验证契约时,valueFromProviderState的动态特性才会真正发挥作用。

注意事项与总结

  1. 状态名称匹配: 确保消费者契约中builder.given()方法使用的状态名称与生产者端@State注解的值完全一致。
  2. valueFromProviderState语法: 对于字符串类型的动态值,引用Provider State中的键时,务必使用${keyName}的格式。如果是非字符串类型(如数字),可以直接使用keyName。
  3. 示例值的提供: valueFromProviderState的第三个参数是必不可少的,它为消费者独立测试提供了模拟数据,保证了消费者测试的独立性和稳定性。
  4. 数据清理: 生产者端@BeforeEach中创建的数据,通常需要在测试完成后进行清理,以避免数据污染和影响后续测试。虽然本示例未展示清理逻辑,但在实际项目中,应考虑使用@AfterEach或事务回滚等机制。
  5. 日志记录: 在生产者端打印动态生成的ID(如log.info("assignment id is " + updateAssignmentId);)对于调试非常有帮助。

通过上述方法,我们成功地在Java Pact契约中实现了动态ID的注入。这种机制使得契约测试能够更好地适应真实世界中数据动态变化的场景,提高了测试的鲁棒性和实用性,是编写高质量契约测试的关键实践。

以上就是如何在Java Pact契约中动态注入Body ID的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号