Spring Cloud Contract 2.0 Migration Guide

Spring Cloud Contract 2.0 Migration Guide

IMPORTANT: This migration guide is a work in progress

Migrations

StubMode introduction

Related to https://github.com/spring-cloud/spring-cloud-contract/issues/287.

Stub Runner

Change workOffline in @AutoConfigureStubRunner to stubsMode = StubRunnerProperties.StubsMode.LOCAL.

Maven Plugin

Change contractsWorkOffline to <contractsMode>LOCAL</contractsMode>

Gradle Plugin

Change contractsWorkOffline = true to contractsMode = "LOCAL"

StubsDownloaderBuilder modification

Related to https://github.com/spring-cloud/spring-cloud-contract/pull/596

• StubDownloaderBuilder extends ProtocolResovler. By default the ProtocolResolver methods return null.
• stubRunnerOptions.stubRepositoryRoot is a Resource not a String
• generateWireMockClientStubs Gradle task got removed
• if folder with contracts has a subfolder called contracts, we will pick contracts from the subfolder

Pact upgrade to 3.5.13

Related to https://github.com/spring-cloud/spring-cloud-contract/pull/569

• PactConverter returns a collection of Pact contracts instead of one (see https://github.com/spring-cloud/spring-cloud-contract/commit/d942bfd9d127489c447ebae3221e063099420492#diff-3c9a6ccf897ca28d932eb2bef60dc2e9R27)
• The testMatchers and stubMatchers have been deprecated in favour of bodyMatchers that should be called in request and response closures