首页 > Java > java教程 > 正文

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

DDD
发布: 2025-11-11 12:40:33
原创
239人浏览过

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

本文详细介绍了在Java中使用Pact框架处理动态ID的策略。当API请求体中的ID在测试过程中需要动态生成时,可以通过Provider端的`@State`方法提供数据,并在Consumer端的契约定义中使用`valueFromProviderState`结合`${}`语法进行注入,从而确保契约测试的灵活性和准确性。

引言

在构建微服务架构时,契约测试(Contract Testing)是确保服务间兼容性的关键环节。Pact作为一种流行的契约测试工具,允许开发者定义消费者与生产者之间的API交互契约。然而,在实际应用中,API请求或响应体中常常包含动态生成的数据,例如数据库ID、时间戳等。如何有效地在Pact契约中处理这些动态数据,特别是动态ID的注入,是许多开发者面临的挑战。本文将以Java为例,深入探讨如何在Pact契约中实现动态ID的注入,以适应数据清理后ID变化等场景。

理解Pact的Provider State

Pact的Provider State(生产者状态)机制是处理动态数据的基础。它允许生产者在每次契约验证之前,根据消费者定义的状态描述,设置一个特定的环境。这个环境可以包括创建特定的数据库记录、设置缓存等,从而确保生产者服务在验证契约时处于消费者期望的状态。同时,Provider State也可以向消费者提供动态生成的数据。

生产者端配置

在生产者(Provider)端,我们需要定义一个方法,通过@State注解来标识,该方法将返回一个Map,其中包含消费者所需的所有动态数据。

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

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

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

千面视频动捕 27
查看详情 千面视频动捕
import au.com.dius.pact.provider.junit5.PactVerificationContext;
import au.com.dius.pact.provider.junitsupport.Provider;
import au.com.dius.pact.provider.junitsupport.State;
import au.com.dius.pact.provider.junitsupport.loader.PactBroker;
import au.com.dius.pact.provider.junitsupport.loader.PactBrokerAuth;
import au.com.dius.pact.provider.junitsupport.verification.VerificationReports;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.TestTemplate;
import org.junit.jupiter.api.extension.ExtendWith;
import java.util.HashMap;
import java.util.Map;
import lombok.extern.slf4j.Slf4j;

@Slf4j
@Provider("Assignments API") // 定义生产者名称
//@PactBroker(url = "YOUR_PACT_BROKER_URL", authentication = @PactBrokerAuth(token = "${pactbroker.auth.token}"))
@VerificationReports(value = {"console", "markdown"}, reportDir = "target/pacts")
class PactProviderLTIAGSIT {

    private String updateAssignmentId; // 存储动态生成的ID

    @BeforeEach
    void createAssignmentBeforeEachTest() {
        // 模拟在测试前创建资源,并获取其ID
        // 实际场景中,这里会调用API或数据库操作来创建数据
        // 假设我们通过某种方式获得了动态ID
        this.updateAssignmentId = "dynamic-assignment-id-" + System.currentTimeMillis();
        log.info("动态生成的 assignment id 是: " + updateAssignmentId);
    }

    @State("Scoring info is passed between ags-tool and assignmentapi")
    public Map<String, Object> getScoringInfo() {
        Map<String, Object> map = new HashMap<>();
        // 将动态ID放入Map中,供消费者契约使用
        map.put("assignmentId", updateAssignmentId);
        return map;
    }

    // 其他Pact验证相关的配置和测试方法
    @BeforeEach
    void before(PactVerificationContext context) {
        // 设置目标服务,例如:
        // context.setTarget(new HttpsTestTarget(BASE_PACT_TEACHER_ASSIGNMENTS_URL, 443, ""));
    }

    @TestTemplate
    @ExtendWith(PactVerificationInvocationContextProvider.class)
    void pactTestTemplate(PactVerificationContext context) {
        context.verifyInteraction();
    }
}
登录后复制

在上述代码中:

  • createAssignmentBeforeEachTest() 方法(或类似的初始化方法)模拟了在测试执行前动态创建数据并获取其ID的过程。在实际应用中,这通常涉及调用实际的API或直接操作数据库。
  • @State("Scoring info is passed between ags-tool and assignmentapi") 注解定义了一个Provider State。当消费者契约请求这个状态时,getScoringInfo() 方法会被调用。
  • getScoringInfo() 方法返回一个Map,其中"assignmentId"作为键,updateAssignmentId作为值。这个updateAssignmentId就是我们在@BeforeEach中动态生成的ID。

消费者端契约定义

消费者(Consumer)端需要定义契约,并指明它依赖于哪个Provider State。在请求体中,我们需要使用Pact DSL提供的valueFromProviderState方法来引用生产者提供的动态数据。

import au.com.dius.pact.consumer.dsl.DslPart;
import au.com.dius.pact.consumer.dsl.PactDslJsonBody;
import au.com.dius.pact.consumer.junit5.PactConsumerTestExt;
import au.com.dius.pact.consumer.junit5.PactTestFor;
import au.com.dius.pact.core.model.RequestResponsePact;
import au.com.dius.pact.core.model.annotations.Pact;
import au.com.dius.pact.core.model.PactSpecVersion;
import au.com.dius.pact.consumer.MockServer;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import java.util.HashMap;
import java.util.Map;
import static org.junit.jupiter.api.Assertions.assertEquals;

@ExtendWith(PactConsumerTestExt.class)
class PactConsumerSendScoreIT {

    private static final String PACT_PROVIDER = "Assignments API";
    private static final String PACT_CONSUMER = "LTI-AGS-Tool";
    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 requestBody = new PactDslJsonBody()
                // 关键:使用valueFromProviderState来动态注入ID
                // 第一个参数是JSON字段名,第二个参数是Provider State中对应的键名,
                // 第三个参数是消费者端测试时的默认值(当Provider State不活跃时使用)
                .valueFromProviderState("assignmentId", "${assignmentId}", "c1ef3bbf-55a2-4638-8f93-22b2916fe085")
                .stringType("timestamp", "2023-10-27T10:00:00.000+08:00") // 示例时间戳
                .decimalType("scoreGiven", 75.00)
                .decimalType("scoreMaximum", 100.00)
                .stringType("comment", "Good work!")
                .stringType("status", "IN_PROGRESS")
                .stringType("userId", "c2ef3bbf-55a2-4638-8f93-22b2916fe085");

        return builder
                .given("Scoring info is passed between ags-tool and assignmentapi") // 引用生产者状态
                .uponReceiving("Send scoring info to assignmentapi")
                .path(path)
                .method("POST")
                .body(requestBody)
                .headers(headers)
                .willRespondWith()
                .status(201)
                .body(requestBody) // 响应体也可以包含动态ID,如果需要的话
                .toPact();
    }

    @Test
    @PactTestFor(pactMethod = "scoreConsumerPact", providerName = PACT_PROVIDER, port = "8080", pactVersion = PactSpecVersion.V3)
    void runTest(MockServer mockServer) {
        // 消费者端测试时,需要提供一个具体的ID值来与MockServer交互
        // 这个ID值通常是契约中定义的默认值,或者是一个固定的测试值
        String testAssignmentId = "c1ef3bbf-55a2-4638-8f93-22b2916fe085";

        Map<String, Object> requestMap = new HashMap<>();
        requestMap.put("assignmentId", testAssignmentId);
        requestMap.put("timestamp", "2023-10-27T10:00:00.000+08:00");
        requestMap.put("scoreGiven", 75.00);
        requestMap.put("scoreMaximum", 100.00);
        requestMap.put("comment", "Good work!");
        requestMap.put("status", "IN_PROGRESS");
        requestMap.put("userId", "c2ef3bbf-55a2-4638-8f93-22b2916fe085");

        // 模拟调用生产者服务
        // RequestSpecification rq = Util.getRequestSpecification().baseUri(mockServer.getUrl()).headers(headers);
        // Response response = rq.body(requestMap).post(path);
        // assertEquals(201, response.getStatusCode());
        // 简化示例,实际应使用HTTP客户端发起请求
        // 假设这里调用了一个客户端方法,并验证结果
        System.out.println("Consumer test simulating request to MockServer with ID: " + testAssignmentId);
        // 实际的HTTP请求和断言
        // ...
        assertEquals(201, 201); // 模拟成功
    }
}
登录后复制

在上述消费者契约中,最关键的部分是:

.valueFromProviderState("assignmentId", "${assignmentId}", "c1ef3bbf-55a2-4638-8f93-22b2916fe085")
登录后复制
  • "assignmentId": 这是JSON请求体中期望的字段名。
  • "${assignmentId}": 这是引用Provider State中键名为assignmentId的值的表达式。请注意,对于字符串类型的动态值,必须使用${}语法进行包裹,Pact才能正确解析并进行字符串替换。如果Provider State中的值是数字或布尔类型,则不需要${}。
  • "c1ef3bbf-55a2-4638-8f93-22b2916fe085": 这是当Pact在消费者端运行(即与MockServer交互,没有实际的Provider State上下文)时使用的默认值。这个值确保了消费者测试能够独立运行,即使没有连接到真实的生产者服务。

工作原理总结

  1. 消费者测试阶段: 当消费者运行其@PactTestFor注解的测试时,它会启动一个MockServer。此时,valueFromProviderState的第三个参数("c1ef3bbf-55a2-4638-8f93-22b2916fe085")作为默认值被MockServer使用,响应消费者请求。
  2. 生产者验证阶段: 当Pact Broker或生产者服务验证契约时:
    • 生产者会根据契约中定义的given("Scoring info is passed between ags-tool and assignmentapi")找到对应的@State方法(getScoringInfo())。
    • getScoringInfo()方法被执行,返回一个包含动态ID的Map。
    • Pact框架将这个动态ID注入到消费者契约中定义的请求体中,替换掉${assignmentId}占位符。
    • 生产者服务接收到包含真实动态ID的请求,并进行处理和验证。

注意事项与最佳实践

  • Provider State名称匹配: 确保消费者契约中given()方法里的字符串与生产者@State注解中的字符串完全匹配。
  • ${}语法: 牢记对于字符串类型的动态值,在valueFromProviderState的第二个参数中必须使用${}包裹Provider State的键名。
  • 默认值的重要性: valueFromProviderState的第三个参数(默认值)对于消费者独立测试至关重要。它允许消费者在没有生产者上下文的情况下,依然能够模拟请求和响应。
  • 数据清理: 在生产者端,@BeforeEach方法中创建的动态数据应在测试结束后进行清理,以避免测试间的相互影响。
  • 复杂对象注入: 如果需要注入的是一个复杂的JSON对象,可以考虑使用PactDslJsonBody.objectFromProviderState()或类似的方法。

结论

通过巧妙地结合Pact的Provider State机制和valueFromProviderState方法,我们可以在Java中有效地处理契约测试中的动态ID注入问题。这种方法不仅保证了契约的灵活性,使得测试能够适应不断变化的测试数据,而且也加强了消费者与生产者之间的协作,确保了服务的兼容性和稳定性。遵循本文提供的指导和最佳实践,开发者可以构建出更加健壮和可维护的契约测试套件。

以上就是如何使用Pact在Java契约中动态注入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号