org.springframework.cloud.contract.stubrunner

Class StubRunner

java.lang.Object

org.springframework.cloud.contract.stubrunner.StubRunner

All Implemented Interfaces:

Closeable, AutoCloseable, StubFinder, StubRunning, StubTrigger

public class StubRunner
extends Object
implements StubRunning

Represents a single instance of ready-to-run stubs. Can run the stubs and then will return the name of the collaborator together with its URI. Can also be queried if the current groupid and artifactid are matching the corresponding running stub.

Constructor Summary

Constructors

Constructor and Description
StubRunner(StubRunnerOptions stubRunnerOptions, String repositoryPath, StubConfiguration stubsConfiguration)
StubRunner(StubRunnerOptions stubRunnerOptions, String repositoryPath, StubConfiguration stubsConfiguration, MessageVerifier<?> contractVerifierMessaging)

Method Summary

Modifier and Type	Method and Description
void	close()
RunningStubs	findAllRunningStubs() Returns all running stubs
URL	findStubUrl(String ivyNotation) For the given Ivy notation groupId:artifactId tries to find the matching URL of the running stub.
URL	findStubUrl(String groupId, String artifactId) For the given groupId and artifactId tries to find the matching URL of the running stub.
Map<StubConfiguration,Collection<org.springframework.cloud.contract.spec.Contract>>	getContracts() Returns the list of Contracts
Map<String,Collection<String>>	labels() Returns a mapping of ivy notation of a dependency to all the labels it has.
RunningStubs	runStubs() Runs the stubs and returns the RunningStubs.
boolean	trigger() Triggers all possible events.
boolean	trigger(String labelName) Triggers an event by a given label.
boolean	trigger(String ivyNotation, String labelName) Triggers an event by a given label for a given groupid:artifactid notation.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

StubRunner

public StubRunner(StubRunnerOptions stubRunnerOptions,
                  String repositoryPath,
                  StubConfiguration stubsConfiguration)

StubRunner

public StubRunner(StubRunnerOptions stubRunnerOptions,
                  String repositoryPath,
                  StubConfiguration stubsConfiguration,
                  MessageVerifier<?> contractVerifierMessaging)

Method Detail

runStubs

public RunningStubs runStubs()

Description copied from interface: StubRunning

Runs the stubs and returns the RunningStubs. If the stubs were already started then a cached version will be returned.

Specified by:

runStubs in interface StubRunning

findStubUrl

public URL findStubUrl(String groupId,
                       String artifactId)

Description copied from interface: StubFinder

For the given groupId and artifactId tries to find the matching URL of the running stub.

Specified by:

findStubUrl in interface StubFinder

Parameters:

groupId - - might be null. In that case a search only via artifactId takes place

Returns:

URL of a running stub or null if not found

findStubUrl

public URL findStubUrl(String ivyNotation)

Description copied from interface: StubFinder

For the given Ivy notation groupId:artifactId tries to find the matching URL of the running stub. You can also pass only artifactId.

Specified by:

findStubUrl in interface StubFinder

Parameters:

ivyNotation - - Ivy representation of the Maven artifact

Returns:

URL of a running stub or null if not found

findAllRunningStubs

public RunningStubs findAllRunningStubs()

Description copied from interface: StubFinder

Returns all running stubs

Specified by:

findAllRunningStubs in interface StubFinder

getContracts

public Map<StubConfiguration,Collection<org.springframework.cloud.contract.spec.Contract>> getContracts()

Description copied from interface: StubFinder

Returns the list of Contracts

Specified by:

getContracts in interface StubFinder

trigger

public boolean trigger(String ivyNotation,
                       String labelName)

Description copied from interface: StubTrigger

Triggers an event by a given label for a given groupid:artifactid notation. You can use only artifactId too. Feature related to messaging.

Specified by:

trigger in interface StubTrigger

Returns:

true - if managed to run a trigger

trigger

public boolean trigger(String labelName)

Description copied from interface: StubTrigger

Triggers an event by a given label. Feature related to messaging.

Specified by:

trigger in interface StubTrigger

Returns:

true - if managed to run a trigger

trigger

public boolean trigger()

Description copied from interface: StubTrigger

Triggers all possible events. Feature related to messaging.

Specified by:

trigger in interface StubTrigger

Returns:

true - if managed to run a trigger

labels

public Map<String,Collection<String>> labels()

Description copied from interface: StubTrigger

Returns a mapping of ivy notation of a dependency to all the labels it has. Feature related to messaging.

Specified by:

labels in interface StubTrigger

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException