Package org.springframework.cloud.contract.stubrunner.junit

Class StubRunnerExtension

java.lang.Object

org.springframework.cloud.contract.stubrunner.junit.StubRunnerExtension

All Implemented Interfaces:

org.junit.jupiter.api.extension.AfterAllCallback, org.junit.jupiter.api.extension.AfterEachCallback, org.junit.jupiter.api.extension.BeforeAllCallback, org.junit.jupiter.api.extension.BeforeEachCallback, org.junit.jupiter.api.extension.Extension, StubFinder, StubTrigger

Direct Known Subclasses:

StubRunnerExtension.PortStubRunnerExtension

public class StubRunnerExtension
extends Object
implements org.junit.jupiter.api.extension.BeforeAllCallback, org.junit.jupiter.api.extension.AfterAllCallback, org.junit.jupiter.api.extension.BeforeEachCallback, org.junit.jupiter.api.extension.AfterEachCallback, StubFinder

JUnit 5 extension that allows to download and run stubs.

Since:

2.1.0

Author:

Olga Maciaszek-Sharma

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	StubRunnerExtension.PortStubRunnerExtension	Helper class with additional port, related methods once you pick a stub to download.

Constructor Summary

Constructors

Constructor	Description
StubRunnerExtension()

Method Summary

Modifier and Type	Method	Description
void	afterAll(org.junit.jupiter.api.extension.ExtensionContext extensionContext)
void	afterEach(org.junit.jupiter.api.extension.ExtensionContext context)
void	beforeAll(org.junit.jupiter.api.extension.ExtensionContext extensionContext)
void	beforeEach(org.junit.jupiter.api.extension.ExtensionContext context)
StubRunnerExtension.PortStubRunnerExtension	downloadLatestStub(String groupId, String artifactId, String classifier)
StubRunnerExtension.PortStubRunnerExtension	downloadStub(String ivyNotation)
StubRunnerExtension.PortStubRunnerExtension	downloadStub(String groupId, String artifactId)
StubRunnerExtension.PortStubRunnerExtension	downloadStub(String groupId, String artifactId, String version)
StubRunnerExtension.PortStubRunnerExtension	downloadStub(String groupId, String artifactId, String version, String classifier)
StubRunnerExtension	downloadStubs(String... ivyNotations)
StubRunnerExtension	downloadStubs(List<String> ivyNotations)
StubRunnerExtension	failOnNoStubs(boolean failOnNoStubs)
RunningStubs	findAllRunningStubs()
URL	findStubUrl(String ivyNotation)	For the given Ivy notation [groupId]:artifactId:[version]:[classifier] 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()
Map<String,Collection<String>>	labels()	Feature related to messaging.
StubRunnerExtension	maxPort(int maxPort)
StubRunnerExtension	messageVerifier(org.springframework.cloud.contract.verifier.messaging.MessageVerifier messageVerifier)
StubRunnerExtension	minPort(int minPort)
StubRunnerExtension	options(StubRunnerOptions stubRunnerOptions)
StubRunnerExtension	repoRoot(String repoRoot)
StubRunnerExtension	stubsMode(StubRunnerProperties.StubsMode stubsMode)
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.
StubRunnerExtension	withConsumerName(String consumerName)
StubRunnerExtension	withDeleteStubsAfterTest(boolean deleteStubsAfterTest)
StubRunnerExtension	withGenerateStubs(boolean generateStubs)
StubRunnerExtension	withHttpServerStubConfigurer(Class<? extends HttpServerStubConfigurer> httpServerStubConfigurer)
StubRunnerExtension	withMappingsOutputFolder(String mappingsOutputFolder)
StubRunnerExtension	withProperties(Map<String,String> properties)
StubRunnerExtension	withStubPerConsumer(boolean stubPerConsumer)

Methods inherited from class java.lang.Object

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

Constructor Detail

StubRunnerExtension

public StubRunnerExtension()

Method Detail

afterAll

public void afterAll(org.junit.jupiter.api.extension.ExtensionContext extensionContext)

Specified by:

afterAll in interface org.junit.jupiter.api.extension.AfterAllCallback

afterEach

public void afterEach(org.junit.jupiter.api.extension.ExtensionContext context)
               throws Exception

Specified by:

afterEach in interface org.junit.jupiter.api.extension.AfterEachCallback

Throws:

Exception

beforeAll

public void beforeAll(org.junit.jupiter.api.extension.ExtensionContext extensionContext)

Specified by:

beforeAll in interface org.junit.jupiter.api.extension.BeforeAllCallback

beforeEach

public void beforeEach(org.junit.jupiter.api.extension.ExtensionContext context)
                throws Exception

Specified by:

beforeEach in interface org.junit.jupiter.api.extension.BeforeEachCallback

Throws:

Exception

findStubUrl

public URL findStubUrl(String groupId,
                       String artifactId)
                throws StubNotFoundException

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

artifactId - - artifact id of the stub

Returns:

URL of a running stub or throws exception if not found

Throws:

StubNotFoundException - in case of not finding a stub

findStubUrl

public URL findStubUrl(String ivyNotation)
                throws StubNotFoundException

Description copied from interface: StubFinder

For the given Ivy notation [groupId]:artifactId:[version]:[classifier] 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 throws exception if not found

Throws:

StubNotFoundException - in case of not finding a stub

findAllRunningStubs

public RunningStubs findAllRunningStubs()

Specified by:

findAllRunningStubs in interface StubFinder

Returns:

all running stubs

getContracts

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

Specified by:

getContracts in interface StubFinder

Returns:

the list of Contracts

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

Parameters:

ivyNotation - ivy notation of a stub

labelName - name of the label to trigger

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

Parameters:

labelName - name of the label to trigger

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

Feature related to messaging.

Specified by:

labels in interface StubTrigger

Returns:

a mapping of ivy notation of a dependency to all the labels it has.

messageVerifier

public StubRunnerExtension messageVerifier(org.springframework.cloud.contract.verifier.messaging.MessageVerifier messageVerifier)

options

public StubRunnerExtension options(StubRunnerOptions stubRunnerOptions)

minPort

public StubRunnerExtension minPort(int minPort)

maxPort

public StubRunnerExtension maxPort(int maxPort)

repoRoot

public StubRunnerExtension repoRoot(String repoRoot)

stubsMode

public StubRunnerExtension stubsMode(StubRunnerProperties.StubsMode stubsMode)

downloadStub

public StubRunnerExtension.PortStubRunnerExtension downloadStub(String groupId,
                                                                String artifactId,
                                                                String version,
                                                                String classifier)

downloadLatestStub

public StubRunnerExtension.PortStubRunnerExtension downloadLatestStub(String groupId,
                                                                      String artifactId,
                                                                      String classifier)

downloadStub

public StubRunnerExtension.PortStubRunnerExtension downloadStub(String groupId,
                                                                String artifactId,
                                                                String version)

downloadStub

public StubRunnerExtension.PortStubRunnerExtension downloadStub(String groupId,
                                                                String artifactId)

downloadStub

public StubRunnerExtension.PortStubRunnerExtension downloadStub(String ivyNotation)

downloadStubs

public StubRunnerExtension downloadStubs(String... ivyNotations)

downloadStubs

public StubRunnerExtension downloadStubs(List<String> ivyNotations)

withStubPerConsumer

public StubRunnerExtension withStubPerConsumer(boolean stubPerConsumer)

withConsumerName

public StubRunnerExtension withConsumerName(String consumerName)

withMappingsOutputFolder

public StubRunnerExtension withMappingsOutputFolder(String mappingsOutputFolder)

withDeleteStubsAfterTest

public StubRunnerExtension withDeleteStubsAfterTest(boolean deleteStubsAfterTest)

withGenerateStubs

public StubRunnerExtension withGenerateStubs(boolean generateStubs)

failOnNoStubs

public StubRunnerExtension failOnNoStubs(boolean failOnNoStubs)

withProperties

public StubRunnerExtension withProperties(Map<String,String> properties)

withHttpServerStubConfigurer

public StubRunnerExtension withHttpServerStubConfigurer(Class<? extends HttpServerStubConfigurer> httpServerStubConfigurer)