此版本仍在开发中，尚不被认为是稳定的。对于最新的稳定版本，请使用 spring-cloud-contract 4.3.0！spring-doc.cadn.net.cn

从某个位置获取存根或合同定义

而不是从 Artifactory、Nexus 或 Git，您可以指向驱动器或类路径上的位置。这样做在多模块项目中特别有用，其中一个模块想要重用另一个模块中的存根或合约，而无需需要在本地 Maven 中实际安装这些存储库将这些更改提交到 Git。spring-doc.cadn.net.cn

为了实现这一点，您可以使用stubs://协议，当存储库根参数设置为在 Stub Runner 或 Spring Cloud Contract 插件中。spring-doc.cadn.net.cn

在此示例中，producer项目已成功构建并在target/stubs文件夹。作为消费者，可以使用stubs://协议。spring-doc.cadn.net.cn

注解

@AutoConfigureStubRunner(
stubsMode = StubRunnerProperties.StubsMode.REMOTE,
		repositoryRoot = "stubs://file://location/to/the/producer/target/stubs/",
		ids = "com.example:some-producer")

JUnit 4 规则

@Rule
	public StubRunnerRule rule = new StubRunnerRule()
			.downloadStub("com.example:some-producer")
			.repoRoot("stubs://file://location/to/the/producer/target/stubs/")
			.stubsMode(StubRunnerProperties.StubsMode.REMOTE);

JUnit 5 扩展

@RegisterExtension
	public StubRunnerExtension stubRunnerExtension = new StubRunnerExtension()
			.downloadStub("com.example:some-producer")
			.repoRoot("stubs://file://location/to/the/producer/target/stubs/")
			.stubsMode(StubRunnerProperties.StubsMode.REMOTE);

合约和存根可以存储在某个位置，每个生产者都有自己的专用文件夹来存储合约和存根映射。在该文件夹下，每个使用者都可以有自己的设置。要使 Stub Runner 从提供的 ID 中找到专用文件夹，您可以将stubs.find-producer=true属性或stubrunner.stubs.find-producer=true系统属性。以下列表显示了合同和存根的排列：spring-doc.cadn.net.cn

└── com.example (1)
    ├── some-artifact-id (2)
    │   └── 0.0.1
    │       ├── contracts (3)
    │       │   └── shouldReturnStuffForArtifactId.groovy
    │       └── mappings (4)
    │           └── shouldReturnStuffForArtifactId.json
    └── some-other-artifact-id (5)
        ├── contracts
        │   └── shouldReturnStuffForOtherArtifactId.groovy
        └── mappings
            └── shouldReturnStuffForOtherArtifactId.json

1	使用者的组 ID
2	具有项目 ID 的消费者 [some-artifact-id]
3	具有工件 ID 的使用者的契约 [some-artifact-id]
4	具有工件 ID 的使用者映射 [some-artifact-id]
5	具有工件 ID 的消费者 [some-other-artifact-id]

注解

@AutoConfigureStubRunner(
stubsMode = StubRunnerProperties.StubsMode.REMOTE,
		repositoryRoot = "stubs://file://location/to/the/contracts/directory",
		ids = "com.example:some-producer",
		properties="stubs.find-producer=true")

JUnit 4 规则

	static Map<String, String> contractProperties() {
		Map<String, String> map = new HashMap<>();
		map.put("stubs.find-producer", "true");
		return map;
	}

@Rule
	public StubRunnerRule rule = new StubRunnerRule()
			.downloadStub("com.example:some-producer")
			.repoRoot("stubs://file://location/to/the/contracts/directory")
			.stubsMode(StubRunnerProperties.StubsMode.REMOTE)
			.properties(contractProperties());

JUnit 5 扩展

	static Map<String, String> contractProperties() {
		Map<String, String> map = new HashMap<>();
		map.put("stubs.find-producer", "true");
		return map;
	}

@RegisterExtension
	public StubRunnerExtension stubRunnerExtension = new StubRunnerExtension()
			.downloadStub("com.example:some-producer")
			.repoRoot("stubs://file://location/to/the/contracts/directory")
			.stubsMode(StubRunnerProperties.StubsMode.REMOTE)
			.properties(contractProperties());