spring cloud contract http实例

微服务很多时,服务之前相互调用,接口参数的一致性要变得很难维护。

spring cloud contract 提供了测试接口一致性的方法。

一 项目配置

bash 复制代码
plugins {
    id "groovy"
    id "org.springframework.cloud.contract" version "4.0.5"
    id "maven-publish"
}
 
String contractVersion = "1.0.0-contract-SNAPSHOT"
 
ext {
    set('springCloudVersion', "2022.0.5")
    set('groovyVersion', "4.0.20")
    set('contractVersion', "4.0.5")
    set('streamVersion', "4.0.5")
}
 
contracts {
    testMode = 'MockMvc'
    deleteStubsAfterTest = true
    baseClassForTests = "com.leve.${artifactId}.ContractTestBase"
    generatedTestJavaSourcesDir = project.file("src/contractTest/contract")
}
 
dependencies {
    testImplementation("org.apache.groovy:groovy-all:${groovyVersion}")
    testImplementation("org.springframework.cloud:spring-cloud-starter-contract-verifier")
    testImplementation("org.springframework.cloud:spring-cloud-starter-contract-stub-runner")
}
 
dependencyManagement {
    imports {
        mavenBom("org.springframework.cloud:spring-cloud-dependencies:${property("springCloudVersion")}")
        mavenBom "org.springframework.cloud:spring-cloud-contract-dependencies:${property("contractVersion")}"
        mavenBom ("org.springframework.cloud:spring-cloud-stream-dependencies:${property("streamVersion")}")
    }
}
 
publishing {
    publications {
        maven(MavenPublication) {
            artifact(tasks.named('verifierStubsJar'))
        }
        // 如果项目名称带有横杠的,比如说auth-ghost,那么需要像下面这样去掉横杠,不然openfign404
        // maven.artifactId = "authghost"
    }
    repositories {
        maven {
            url = uri("https://nexus.111.com/repository/leve-maven/")
            version = contractVersion
            credentials {
                username = nexusUsername
                password = nexusPassword
            }
            allowInsecureProtocol = false
        }
    }
}

二 基类

公共基类, 需要注意基类所在的路径,可以修改配置指定基类的名称和路径。

java 复制代码
 
/**
 * ContractTestBase
 */
@SpringBootTest(properties = {
        "spring.cloud.function.definition=",
})
@AutoConfigureStubRunner
public class ContractTestBase{
 
 
    @Autowired
    private WebApplicationContext applicationContext;
    @MockBean
    private UserInfoService userInfoService;

 
    @BeforeEach
    public void setUp() {
        RestAssuredMockMvc.webAppContextSetup(applicationContext);
    }
 
}

三 消费端配置

ids看你需要哪些服务,自行增改。版本号可以不要,会拉取最新的。

yaml 复制代码
stubrunner:
  ids:
    - "com.test:user"
    - "com.test:ghost"
  repositoryRoot: https://nexus.test.com/repository/leve-maven/
  stubsMode: REMOTE

在测试类上面使用 @AutoConfigureStubRunner

四 运行测试

User服务调用 ghost服务的 接口

4.1 生产端

在ghost服务按照上面的配置,写好contract.yml文件,构建测试通过后,然后publish到nexus上面


4.2 消费端

bootstrap.yml文件添加对应的生产端服务id

然后再对应的测试类上面添加 @AutoConfigureStubRunner

测试方法

方法中通过openfeign调用ghost服务

测试结果

相关推荐
guojl4 小时前
RestTemplate使用手册
spring cloud·微服务
guojl4 小时前
RestTemplate原理分析
spring cloud·微服务
booooooty4 小时前
基于Spring AI Alibaba的多智能体RAG应用
java·人工智能·spring·多智能体·rag·spring ai·ai alibaba
极光雨雨4 小时前
Spring Bean 控制销毁顺序的方法总结
java·spring
Ken_11154 小时前
SpringCloud系列(51)--SpringCloud Stream之使用分组解决消息重复消费问题
spring cloud
Spirit_NKlaus4 小时前
解决HttpServletRequest无法获取@RequestBody修饰的参数
java·spring boot·spring
2501_916013745 小时前
iOS 多线程导致接口乱序?抓包还原 + 请求调度优化实战
websocket·网络协议·tcp/ip·http·网络安全·https·udp
lwb_01185 小时前
SpringCloud——Gateway新一代网关
spring·spring cloud·gateway
路长且阻6 小时前
网络协议(TCP/IP、HTTP、HTTPS)
网络协议·tcp/ip·http
lxsy7 小时前
spring-ai-alibaba 1.0.0.2 学习(七)——集成阿里云百炼平台知识库
学习·spring·阿里云·spring-ai·ai-alibaba