英文原文：https://spring.io/projects/spring-cloud-contract

概述

特性

Spring Boot配置

Server / Producer方面

Client / Consumer方面

快速开始

学习

文档

示例

概述

Spring Cloud Contract是一个总体项目，其中包含帮助用户成功实施消费者驱动合同方法的解决方案。目前，Spring Cloud Contract包含Spring Cloud Contract Verifier项目。

Spring Cloud Contract Verifier是一个支持基于JVM的应用程序的消费者驱动合同（CDC）开发的工具。它附带了用Groovy或YAML编写的合同定义语言（DSL）。合同定义用于生成以下资源：

默认情况下，在对客户端代码（客户端测试）进行集成测试时，WireMock（HTTP Server Stub）将使用JSON存根定义。测试代码仍然必须手工编写，测试数据由Spring Cloud Contract Verifier生成。
如果你使用消息路由消息路由。我们正在与Spring Integration，Spring Cloud Stream和Apache Camel集成。但是，如果您愿意，可以设置自己的集成。
验证测试（默认情况下，在JUnit或Spock中）用于验证API的服务器端实现是否符合合同（服务器测试）。 Spring Cloud Contract Verifier生成完整测试。

Spring Cloud Contract Verifier将TDD提升到软件架构的水平。

要了解Spring Cloud Contract如何支持其他语言，请查看此博客文章。

特性

在尝试测试与其他服务通信的应用程序时，我们可以执行以下两项操作之一：

部署所有微服务并执行端到端测试
模拟单元/集成测试中的其他微服务

两者都有其优点，但也有很多缺点。让我们关注后者。
部署所有微服务并执行端到端测试

好处：

模拟生产
测试服务之间的真实通信

缺点：

为了测试一个微服务，我们必须部署6个微服务，几个数据库等。
将进行测试的环境将被锁定用于单个测试套件（即，在此期间没有其他人能够运行测试）。
很长时间跑
很晚的反馈
非常难以调试

在单元/集成测试中模拟其他微服务

好处：

非常快速的反馈
无基础设施要求

缺点：

服务的实现者创建存根，因此他们可能与现实无关
你可以通过测试和生产失败去生产

为了解决上述问题，创建了带有Stub Runner的Spring Cloud Contract Verifier。他们的主要想法是给你非常快速的反馈，而不需要建立整个微服务世界。

Spring Cloud Contract Verifier功能：

确保HTTP / Messaging存根（在开发客户端时使用）正在执行实际的服务器端实现
促进验收测试驱动开发方法和微服务架构风格
提供一种方法来发布在通信双方立即可见的合同中的更改
生成服务器端使用的样板测试代码

Spring Boot配置

有关详细的分步指南，请查看文档。您可以在下面找到简化版本。

Server / Producer方面

在服务器（HTTP）/生产者（消息传递）方面添加Spring Cloud Contract Verifier Maven / Gradle插件。我们假设我们项目的组ID是com.example，工件id是http-server。

在配置中传递的测试的基类可能看起来像这样（我们假设我们正在使用[Rest Assured]（http://rest-assured.io/）并且我们想要为FraudDetectionController执行CDC 你在写）

package com.example;// importspublic class MvcTest {@Beforepublic void setup() {RestAssuredMockMvc.standaloneSetup(new FraudDetectionController());}}

在src/test/resources/contracts中添加一个Contract定义。例如名为shouldMarkClientAsFraud.groovy

org.springframework.cloud.contract.spec.Contract.make {request {method 'PUT'url '/fraudcheck'body("""{"clientId":"1234567890","loanAmount":99999}""")headers {header('Content-Type', 'application/vnd.fraud.v1+json')}}
response {status 200body("""{"fraudCheckStatus": "FRAUD","rejectionReason": "Amount too high"}""")headers {header('Content-Type': 'application/vnd.fraud.v1+json')}}
}

如果你必须添加一个插件，将为你生成测试和存根。

Maven

<build><plugins><plugin><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-contract-maven-plugin</artifactId><version>${spring-cloud-contract.version}</version><extensions>true</extensions><configuration><baseClassForTests>com.example.MvcTest</baseClassForTests></configuration></plugin></plugins></build>

Gradle

buildscript {repositories {mavenCentral()}dependencies {classpath "org.springframework.boot:spring-boot-gradle-plugin:${springBootPluginVersion}"classpath "org.springframework.cloud:spring-cloud-contract-gradle-plugin:${springCloudContractVersion}"}
}apply plugin: 'spring-boot'
apply plugin: 'spring-cloud-contract'dependencyManagement {imports {mavenBom "org.springframework.cloud:spring-cloud-contract-dependencies:${springCloudDependencies}"}
}dependencies {testCompile "org.springframework.cloud:spring-cloud-starter-contract-verifier"
}contracts {baseClassForTests = 'com.example.MvcTest'
}

一旦您尝试从合同构建应用程序，将在/generated-test-sources/contracts下的输出文件夹中生成测试。

package org.springframework.cloud.contract.verifier.tests;// importspublic class ContractVerifierTest extends MvcTest {@Testpublic void validate_shouldMarkClientAsFraud() throws Exception {// given:MockMvcRequestSpecification request = given().header("Content-Type", "application/vnd.fraud.v1+json").body("{\"clientId\":\"1234567890\",\"loanAmount\":99999}");// when:ResponseOptions response = given().spec(request).put("/fraudcheck");// then:assertThat(response.statusCode()).isEqualTo(200);assertThat(response.header("Content-Type")).isEqualTo("application/vnd.fraud.v1+json");// and:DocumentContext parsedJson = JsonPath.parse(response.getBody().asString());assertThatJson(parsedJson).field("fraudCheckStatus").isEqualTo("FRAUD");assertThatJson(parsedJson).field("rejectionReason").isEqualTo("Amount too high");}
}

一旦您通过并重新运行工件的构建和安装，Spring Cloud Contract Verifier就会将合同转换为HTTP服务器存根定义。目前我们正在支持WireMock。存根将出现在stubs/mappings/下的输出文件夹中，如下所示：

{"uuid" : "6c509a40-18f3-498c-a19c-c9f8b56957de","request" : {"url" : "/fraudcheck","method" : "PUT","headers" : {"Content-Type" : {"equalTo" : "application/vnd.fraud.v1+json"}},"bodyPatterns" : [ {"matchesJsonPath" : "$[?(@.loanAmount == 99999)]"}, {"matchesJsonPath" : "$[?(@.clientId == '1234567890')]"} ]},"response" : {"status" : 200,"body" : "{\"fraudCheckStatus\":\"FRAUD\",\"rejectionReason\":\"Amount too high\"}","headers" : {"Content-Type" : "application/vnd.fraud.v1+json"}}
}

CDC（消费者驱动合同）背后的想法是分享通信双方之间的合同。 Gradle和Maven插件通过使用存根分类器生成带有存根和合约定义的jar来帮助您实现这一点。只需将其上传到某个中央存储库，其他人可以将其重新用于集成测试。

Client / Consumer方面

在客户端（HTTP）/使用者（消息传递）方面，它足以为正确的Spring Cloud Contract Stub Runner实现提供依赖性。在这种情况下，因为我们的示例包含与WireMock的HTTP通信作为HTTP Server Stub。我们将选择以下依赖项：

Maven

<dependencyManagement><dependencies><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-dependencies</artifactId><version>${spring-cloud-dependencies.version}</version><type>pom</type><scope>import</scope></dependency></dependencies>
</dependencyManagement><dependencies><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-contract-stub-runner</artifactId><scope>test</scope></dependency>
</dependencies>

Gradle

buildscript {repositories {mavenCentral()}dependencies {classpath "org.springframework.boot:spring-boot-gradle-plugin:${springBootPluginVersion}"}
}apply plugin: 'spring-boot'dependencyManagement {imports {mavenBom "org.springframework.cloud:spring-cloud-contract-dependencies:${springCloudDependencies}"}
}dependencies {testCompile "org.springframework.cloud:spring-cloud-starter-contract-stub-runner"
}

最后一步是在测试中设置Stub Runner以自动下载所需的存根。要实现这一点，您必须传递@AutoConfigureStubRunner注释。该注释具有一组您可以设置的属性。如果您不喜欢这种方法，您也可以在测试属性中设置这些值。

对于Spring Cloud Contract 1.2.x

@RunWith(SpringRunner.class)
@SpringBootTest
@AutoConfigureStubRunner(ids = {"com.example:http-server:+:stubs:8080"}, workOffline = true)
public class LoanApplicationServiceTests {

对于从2.0.x开始的Spring Cloud Contract

@RunWith(SpringRunner.class)
@SpringBootTest
@AutoConfigureStubRunner(ids = {"com.example:http-server:+:stubs:8080"}, stubsMode = StubRunnerProperties.StubsMode.LOCAL)
public class LoanApplicationServiceTests {

这样，具有组ID com.example的工件，工件id http-server，在最新版本中，具有存根分类器将在端口8080处注册。由于传递了workOffline标志，因此将不从远程存储库下载存根 - 它将在当地的Maven回购中搜索。一旦您的测试上下文启动，执行以下代码将不会导致404，因为Spring Cloud Contract Stub Runner将自动启动测试中的WireMock服务器并使用从服务器端生成的存根来提供它。

HttpHeaders httpHeaders = new HttpHeaders();
httpHeaders.add("Content-Type", "application/vnd.fraud.v1+json");
String response = restTemplate.exchange("http://localhost:8080/fraudcheck", HttpMethod.PUT,new HttpEntity<>("{\"clientId\":\"1234567890\",\"loanAmount\":99999}", httpHeaders),String.class);
assertThat(response).isEqualTo("{\"fraudCheckStatus\":\"FRAUD\",\"rejectionReason\":\"Amount too high\"}");

快速开始

使用Spring Initializr引导您的应用程序。

学习

文档

每个Spring项目都有自己的; 它详细解释了如何使用项目功能以及使用它们可以实现的功能。

2.1.0 RC3 PRE CURRENT	Reference Doc.	API Doc.
2.0.3 SNAPSHOT CURRENT	Reference Doc.	API Doc.
2.0.2 CURRENT GA	Reference Doc.	API Doc.
1.2.6 SNAPSHOT CURRENT	Reference Doc.	API Doc.
1.2.5 CURRENT GA	Reference Doc.	API Doc.
1.1.6 SNAPSHOT	Reference Doc.	API Doc.
1.1.5 GA	Reference Doc.	API Doc.
1.0.5 SNAPSHOT	Reference Doc.	API Doc.
1.0.4 GA	Reference Doc.	API Doc.

示例

尝试一些例子：

Spring Cloud Contract Samples (Edgware) 使用Boot 1.5和Edgware版本列的Spring Cloud Contract样本
Spring Cloud Contract Samples (Finchley) 使用Boot 2.x和Finchley发布列表进行Spring Cloud Contract的示例
Spring Cloud Contract workshops 与Spring Cloud合同的研讨会
Spring Cloud Contract with NodeJS 您可以在此处阅读有关Polyglot方法的更多信息https://spring.io/blog/2018/02/13/spring-cloud-contract-in-a-polyglot-world

Spring系列学习之Spring Cloud Contract测试消息传递相关推荐

Spring系列学习之Spring Cloud Pipelines微服务管道
英文原文:https://spring.io/projects/spring-cloud-pipelines 目录概述特性 Spring Boot配置运行Cloud Foundry的演示 Con ...
Spring系列学习之Spring Cloud Stream App Starters 应用程序启动器
英文原文:https://cloud.spring.io/spring-cloud-stream-app-starters/ 目录 Spring Cloud Stream App Starters 特 ...
Spring系列学习之Spring Cloud Connectors微服务连接器
英文原文:https://spring.io/projects/spring-cloud-connectors 概述 Spring Cloud Connectors简化了云平台(如Cloud Foun ...
Spring系列学习之Spring Integration
英文原文:https://spring.io/projects/spring-integration 目录概述介绍特性例子 Spring Boot配置快速开始学习文档指南示例概述 ...
Spring系列学习之Spring Vault
英文原文:https://spring.io/projects/spring-vault 目录概述快速开始学习文档示例概述 Spring Vault提供熟悉的Spring抽象和客户端支持, ...
Spring系列学习之Spring Data Elasticsearch数据访问
英文原文:https://spring.io/projects/spring-data-elasticsearch 目录概述特性快速开始学习文档概述 Elasticsearch的Sprin ...
Spring系列学习之Spring Mobile
英文原文:https://projects.spring.io/spring-mobile/ 目录特性快速开始设备检测网站偏好设备感知视图分辨率 Sample Projects Gettin ...
Spring系列学习之Spring Web Services
英文原文:https://spring.io/projects/spring-ws 目录概述特性 Spring Boot配置快速开始学习文档概述 Spring Web Services(S ...
Spring系列学习之Spring Roo
英文原文:https://projects.spring.io/spring-roo/ 目录令人兴奋的功能 - Spring Boot,Spring Data,...... 零风险 - 没有妥协的生 ...

Spring系列学习之Spring Cloud Contract测试消息传递

概述

特性

Spring Boot配置

Server / Producer方面

Client / Consumer方面

快速开始

学习

文档

示例

Spring系列学习之Spring Cloud Contract测试消息传递相关推荐

最新文章

热门文章