org.springframework.cloud.contract.stubrunner.spring

Annotation Type AutoConfigureStubRunner

@Target(value=TYPE)
 @Retention(value=RUNTIME)
 @Documented
 @ImportAutoConfiguration
 @AutoConfigureMessageVerifier
 @PropertyMapping(value="stubrunner",
                 skip=ON_DEFAULT_VALUE)
public @interface AutoConfigureStubRunner

Author:

Dave Syer

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
String	classifier The classifier to use by default in ivy co-ordinates for a stub.
String	consumerName You can override the default spring.application.name of this field by setting a value to this parameter.
boolean	deleteStubsAfterTest If set to false will NOT delete stubs from a temporary folder after running tests
String[]	ids The ids of the stubs to run in "ivy" notation ([groupId]:artifactId[:version][:classifier][:port]).
String	mappingsOutputFolder For debugging purposes you can output the registered mappings to a given folder.
int	maxPort Max value of a port for the automatically started WireMock server
int	minPort Min value of a port for the automatically started WireMock server
String[]	properties Properties in form key=value
String	repositoryRoot The repository root to use (where the stubs should be downloaded from)
StubRunnerProperties.StubsMode	stubsMode The way stubs should be found and registered.
boolean	stubsPerConsumer On the producer side the consumers can have a folder that contains contracts related only to them.

Element Detail

minPort

public abstract int minPort

Min value of a port for the automatically started WireMock server

Default:

10000

maxPort

public abstract int maxPort

Max value of a port for the automatically started WireMock server

Default:

15000

repositoryRoot

public abstract String repositoryRoot

The repository root to use (where the stubs should be downloaded from)

Default:

""

ids

public abstract String[] ids

The ids of the stubs to run in "ivy" notation ([groupId]:artifactId[:version][:classifier][:port]). groupId, version, classifier and port can be optional.

Default:

{}

classifier

public abstract String classifier

The classifier to use by default in ivy co-ordinates for a stub.

Default:

"stubs"

stubsPerConsumer

public abstract boolean stubsPerConsumer

On the producer side the consumers can have a folder that contains contracts related only to them. By setting the flag to true we no longer register all stubs but only those that correspond to the consumer application's name. In other words we'll scan the path of every stub and if it contains the name of the consumer in the path only then will it get registered. Let's look at this example. Let's assume that we have a producer called foo and two consumers baz and bar. On the foo producer side the contracts would look like this src/test/resources/contracts/baz-service/some/contracts/... and src/test/resources/contracts/bar-service/some/contracts/.... Then when the consumer with spring.application.name or the consumerName() annotation parameter set to baz-service will define the test setup as follows @AutoConfigureStubRunner(ids = "com.example:foo:+:stubs:8095", stubsPerConsumer=true) then only the stubs registered under src/test/resources/contracts/baz-service/some/contracts/... will get registered and those under src/test/resources/contracts/bar-service/some/contracts/... will get ignored.

See Also:

issue 224

Default:

false

consumerName

public abstract String consumerName

You can override the default spring.application.name of this field by setting a value to this parameter.

See Also:

issue 224

Default:

""

mappingsOutputFolder

public abstract String mappingsOutputFolder

For debugging purposes you can output the registered mappings to a given folder. Each HTTP server stub will have its own subfolder where all the mappings will get stored.

See Also:

issue 355

Default:

""

stubsMode

public abstract StubRunnerProperties.StubsMode stubsMode

The way stubs should be found and registered. Defaults to StubRunnerProperties.StubsMode.CLASSPATH.

Returns:

the type of stubs mode

Default:

org.springframework.cloud.contract.stubrunner.spring.StubRunnerProperties.StubsMode.CLASSPATH

properties

public abstract String[] properties

Properties in form key=value

Returns:

the properties to add

Default:

{}

deleteStubsAfterTest

public abstract boolean deleteStubsAfterTest

If set to false will NOT delete stubs from a temporary folder after running tests

Default:

true