io.specto.hoverfly.testng

Class HoverflyTestNG

java.lang.Object

io.specto.hoverfly.testng.HoverflyTestNG

public class HoverflyTestNG
extends java.lang.Object

Method Summary

Modifier and Type	Method and Description
void	after() Stops the managed instance of Hoverfly
void	assertThatNoDiffIsReported() Asserts that there was no diff between any of the expected responses set by simulations and the actual responses returned from the real service.
void	assertThatNoDiffIsReported(boolean shouldResetDiff) Asserts that there was no diff between any of the expected responses set by simulations and the actual responses returned from the real service.
void	before() Starts an instance of Hoverfly
void	capture(java.lang.String outputFilename) Stores what's currently been captured in the currently assigned file, reset simulations and journal logs, then starts capture again ready to store in the new file once complete.
void	capture(java.lang.String outputDir, java.lang.String outputFilename) Stores what's currently been captured in the currently assigned file, reset simulations and journal logs, then starts capture again ready to store in the new file once complete.
java.lang.String	getAuthHeaderName() Deprecated.
java.lang.String	getAuthHeaderValue() Deprecated.
io.specto.hoverfly.junit.core.HoverflyMode	getHoverflyMode() Gets started Hoverfly mode
int	getProxyPort() Gets the proxy port this has run on, which could be useful when running Hoverfly on a random port.
io.specto.hoverfly.junit.core.SslConfigurer	getSslConfigurer()
java.util.Map<java.lang.String,java.lang.String>	getState() Get all state from Hoverfly
static HoverflyTestNG	inCaptureMode()
static HoverflyTestNG	inCaptureMode(io.specto.hoverfly.junit.core.HoverflyConfig hoverflyConfig)
static HoverflyTestNG	inCaptureMode(java.lang.String outputFilename) Instantiates a rule which runs Hoverfly in capture mode
static HoverflyTestNG	inCaptureMode(java.lang.String outputFilename, io.specto.hoverfly.junit.core.HoverflyConfig hoverflyConfig) Instantiates a rule which runs Hoverfly in capture mode
static HoverflyTestNG	inCaptureMode(java.lang.String outputDir, java.lang.String outputFilename) Instantiates a rule which runs Hoverfly in capture mode
static HoverflyTestNG	inCaptureMode(java.lang.String outputDir, java.lang.String outputFilename, io.specto.hoverfly.junit.core.HoverflyConfig hoverflyConfig) Instantiates a rule which runs Hoverfly in capture mode
static HoverflyTestNG	inCaptureOrSimulationMode(java.lang.String recordFile) Instantiates a rule which runs Hoverfly in capture mode if recorded file is not present, or in simulation mode if record file is present
static HoverflyTestNG	inCaptureOrSimulationMode(java.lang.String recordFile, io.specto.hoverfly.junit.core.HoverflyConfig hoverflyConfig) Instantiates a rule which runs Hoverfly in capture mode if recorded file is not present, or in simulation mode if record file is present
static HoverflyTestNG	inDiffMode() Instantiates a rule which runs Hoverfly in diff mode with no data
static HoverflyTestNG	inDiffMode(io.specto.hoverfly.junit.core.HoverflyConfig hoverflyConfig) Instantiates a rule which runs Hoverfly in diff mode with no data
static HoverflyTestNG	inDiffMode(io.specto.hoverfly.junit.core.SimulationSource simulationSource) Instantiates a rule which runs Hoverfly in diff mode
static HoverflyTestNG	inDiffMode(io.specto.hoverfly.junit.core.SimulationSource simulationSource, io.specto.hoverfly.junit.core.HoverflyConfig hoverflyConfig) Instantiates a rule which runs Hoverfly in diff mode
static HoverflyTestNG	inSimulationMode() Instantiates a rule which runs Hoverfly in simulate mode with no data
static HoverflyTestNG	inSimulationMode(io.specto.hoverfly.junit.core.HoverflyConfig hoverflyConfig) Instantiates a rule which runs Hoverfly in simulate mode with no data
static HoverflyTestNG	inSimulationMode(io.specto.hoverfly.junit.core.SimulationSource simulationSource) Instantiates a rule which runs Hoverfly in simulate mode
static HoverflyTestNG	inSimulationMode(io.specto.hoverfly.junit.core.SimulationSource simulationSource, io.specto.hoverfly.junit.core.HoverflyConfig hoverflyConfig)
static HoverflyTestNG	inSpyMode() Instantiates a rule which runs Hoverfly in spy mode with no data
static HoverflyTestNG	inSpyMode(io.specto.hoverfly.junit.core.HoverflyConfig hoverflyConfig) Instantiates a rule which runs Hoverfly in spy mode with no data
static HoverflyTestNG	inSpyMode(io.specto.hoverfly.junit.core.SimulationSource simulationSource) Instantiates a rule which runs Hoverfly in spy mode
static HoverflyTestNG	inSpyMode(io.specto.hoverfly.junit.core.SimulationSource simulationSource, io.specto.hoverfly.junit.core.HoverflyConfig hoverflyConfig)
HoverflyTestNG	printSimulationData() Print the simulation data to console for debugging purpose.
void	resetDiffs()
void	resetJournal()
void	resetState() Deletes all state from Hoverfly
void	setState(java.util.Map<java.lang.String,java.lang.String> state) Deletes all state from Hoverfly and then sets the state.
void	simulate(io.specto.hoverfly.junit.core.SimulationSource simulationSource, io.specto.hoverfly.junit.core.SimulationSource... sources) Changes the Simulation used by Hoverfly It also reset the journal to ensure verification can be done on the new simulation source.
void	updateState(java.util.Map<java.lang.String,java.lang.String> state) Updates state in Hoverfly.
void	verify(io.specto.hoverfly.junit.dsl.RequestMatcherBuilder requestMatcher)
void	verify(io.specto.hoverfly.junit.dsl.RequestMatcherBuilder requestMatcher, io.specto.hoverfly.junit.verification.VerificationCriteria criteria)
void	verifyAll()
void	verifyZeroRequestTo(io.specto.hoverfly.junit.dsl.StubServiceBuilder requestedServiceBuilder)

Methods inherited from class java.lang.Object

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

Method Detail

inCaptureOrSimulationMode

public static HoverflyTestNG inCaptureOrSimulationMode(java.lang.String recordFile)

Instantiates a rule which runs Hoverfly in capture mode if recorded file is not present, or in simulation mode if record file is present

Parameters:

recordFile - the path where captured or simulated traffic is taken. Relative to src/test/resources/hoverfly

Returns:

the rule

inCaptureOrSimulationMode

public static HoverflyTestNG inCaptureOrSimulationMode(java.lang.String recordFile,
                                                       io.specto.hoverfly.junit.core.HoverflyConfig hoverflyConfig)

Instantiates a rule which runs Hoverfly in capture mode if recorded file is not present, or in simulation mode if record file is present

Parameters:

recordFile - the path where captured or simulated traffic is taken. Relative to src/test/resources/hoverfly

hoverflyConfig - the config

Returns:

the rule

inCaptureMode

public static HoverflyTestNG inCaptureMode()

inCaptureMode

public static HoverflyTestNG inCaptureMode(io.specto.hoverfly.junit.core.HoverflyConfig hoverflyConfig)

inCaptureMode

public static HoverflyTestNG inCaptureMode(java.lang.String outputFilename)

Instantiates a rule which runs Hoverfly in capture mode

Parameters:

outputFilename - the output simulation file name relative to src/test/resources/hoverfly

Returns:

the rule

inCaptureMode

public static HoverflyTestNG inCaptureMode(java.lang.String outputFilename,
                                           io.specto.hoverfly.junit.core.HoverflyConfig hoverflyConfig)

Instantiates a rule which runs Hoverfly in capture mode

Parameters:

outputFilename - the output simulation file name relative to src/test/resources/hoverfly

hoverflyConfig - the config

Returns:

the rule

inCaptureMode

public static HoverflyTestNG inCaptureMode(java.lang.String outputDir,
                                           java.lang.String outputFilename)

Instantiates a rule which runs Hoverfly in capture mode

Parameters:

outputDir - the directory path relative to your project root for exporting the simulation file

outputFilename - the output simulation file name

Returns:

the rule

inCaptureMode

public static HoverflyTestNG inCaptureMode(java.lang.String outputDir,
                                           java.lang.String outputFilename,
                                           io.specto.hoverfly.junit.core.HoverflyConfig hoverflyConfig)

Instantiates a rule which runs Hoverfly in capture mode

Parameters:

outputDir - the directory path relative to your project root for exporting the simulation file

outputFilename - the output simulation file name

hoverflyConfig - the config

Returns:

the rule

inSimulationMode

public static HoverflyTestNG inSimulationMode()

Instantiates a rule which runs Hoverfly in simulate mode with no data

Returns:

the rule

inSimulationMode

public static HoverflyTestNG inSimulationMode(io.specto.hoverfly.junit.core.HoverflyConfig hoverflyConfig)

Instantiates a rule which runs Hoverfly in simulate mode with no data

Parameters:

hoverflyConfig - the config

Returns:

the rule

inSimulationMode

public static HoverflyTestNG inSimulationMode(io.specto.hoverfly.junit.core.SimulationSource simulationSource)

Instantiates a rule which runs Hoverfly in simulate mode

Parameters:

simulationSource - the simulation to import

Returns:

the rule

inSimulationMode

public static HoverflyTestNG inSimulationMode(io.specto.hoverfly.junit.core.SimulationSource simulationSource,
                                              io.specto.hoverfly.junit.core.HoverflyConfig hoverflyConfig)

inSpyMode

public static HoverflyTestNG inSpyMode()

Instantiates a rule which runs Hoverfly in spy mode with no data

Returns:

the rule

inSpyMode

public static HoverflyTestNG inSpyMode(io.specto.hoverfly.junit.core.HoverflyConfig hoverflyConfig)

Instantiates a rule which runs Hoverfly in spy mode with no data

Parameters:

hoverflyConfig - the config

Returns:

the rule

inSpyMode

public static HoverflyTestNG inSpyMode(io.specto.hoverfly.junit.core.SimulationSource simulationSource)

Instantiates a rule which runs Hoverfly in spy mode

Parameters:

simulationSource - the simulation to import

Returns:

the rule

inSpyMode

public static HoverflyTestNG inSpyMode(io.specto.hoverfly.junit.core.SimulationSource simulationSource,
                                       io.specto.hoverfly.junit.core.HoverflyConfig hoverflyConfig)

inDiffMode

public static HoverflyTestNG inDiffMode()

Instantiates a rule which runs Hoverfly in diff mode with no data

Returns:

the rule

inDiffMode

public static HoverflyTestNG inDiffMode(io.specto.hoverfly.junit.core.HoverflyConfig hoverflyConfig)

Instantiates a rule which runs Hoverfly in diff mode with no data

Parameters:

hoverflyConfig - the config

Returns:

the rule

inDiffMode

public static HoverflyTestNG inDiffMode(io.specto.hoverfly.junit.core.SimulationSource simulationSource)

Instantiates a rule which runs Hoverfly in diff mode

Parameters:

simulationSource - the simulation to import the responses will be compared to

Returns:

the rule

inDiffMode

public static HoverflyTestNG inDiffMode(io.specto.hoverfly.junit.core.SimulationSource simulationSource,
                                        io.specto.hoverfly.junit.core.HoverflyConfig hoverflyConfig)

Instantiates a rule which runs Hoverfly in diff mode

Parameters:

simulationSource - the simulation to import the responses will be compared to

hoverflyConfig - the config

Returns:

the rule

before

public void before()

Starts an instance of Hoverfly

after

public void after()

Stops the managed instance of Hoverfly

getProxyPort

public int getProxyPort()

Gets the proxy port this has run on, which could be useful when running Hoverfly on a random port.

Returns:

the proxy port

getSslConfigurer

public io.specto.hoverfly.junit.core.SslConfigurer getSslConfigurer()

getHoverflyMode

public io.specto.hoverfly.junit.core.HoverflyMode getHoverflyMode()

Gets started Hoverfly mode

Returns:

the mode.

simulate

public void simulate(io.specto.hoverfly.junit.core.SimulationSource simulationSource,
                     io.specto.hoverfly.junit.core.SimulationSource... sources)

Changes the Simulation used by Hoverfly It also reset the journal to ensure verification can be done on the new simulation source.

Parameters:

simulationSource - the simulation

capture

public void capture(java.lang.String outputFilename)

Stores what's currently been captured in the currently assigned file, reset simulations and journal logs, then starts capture again ready to store in the new file once complete.

Parameters:

outputFilename - the output simulation file name relative to src/test/resources/hoverfly

capture

public void capture(java.lang.String outputDir,
                    java.lang.String outputFilename)

Stores what's currently been captured in the currently assigned file, reset simulations and journal logs, then starts capture again ready to store in the new file once complete.

Parameters:

outputDir - the directory path relative to your project root for exporting the simulation file

outputFilename - the output simulation file name relative to src/test/resources/hoverfly

getAuthHeaderName

@Deprecated
public java.lang.String getAuthHeaderName()

Deprecated.

Get custom Hoverfly header name used by Http client to authenticate with secured Hoverfly proxy

Returns:

the custom Hoverfly authorization header name

getAuthHeaderValue

@Deprecated
public java.lang.String getAuthHeaderValue()

Deprecated.

Get Bearer token used by Http client to authenticate with secured Hoverfly proxy

Returns:

a custom Hoverfly authorization header value

printSimulationData

public HoverflyTestNG printSimulationData()

Print the simulation data to console for debugging purpose. This can be set when you are building the HoverflyRule

Returns:

this HoverflyRule

verify

public void verify(io.specto.hoverfly.junit.dsl.RequestMatcherBuilder requestMatcher)

verify

public void verify(io.specto.hoverfly.junit.dsl.RequestMatcherBuilder requestMatcher,
                   io.specto.hoverfly.junit.verification.VerificationCriteria criteria)

verifyZeroRequestTo

public void verifyZeroRequestTo(io.specto.hoverfly.junit.dsl.StubServiceBuilder requestedServiceBuilder)

verifyAll

public void verifyAll()

resetJournal

public void resetJournal()

resetState

public void resetState()

Deletes all state from Hoverfly

getState

public java.util.Map<java.lang.String,java.lang.String> getState()

Get all state from Hoverfly

Returns:

the state

setState

public void setState(java.util.Map<java.lang.String,java.lang.String> state)

Deletes all state from Hoverfly and then sets the state.

Parameters:

state - the new state

updateState

public void updateState(java.util.Map<java.lang.String,java.lang.String> state)

Updates state in Hoverfly.

Parameters:

state - the state to update with

resetDiffs

public void resetDiffs()

assertThatNoDiffIsReported

public void assertThatNoDiffIsReported()

Asserts that there was no diff between any of the expected responses set by simulations and the actual responses returned from the real service. When the assertion is done then all available diffs are removed from Hoverfly.

assertThatNoDiffIsReported

public void assertThatNoDiffIsReported(boolean shouldResetDiff)

Asserts that there was no diff between any of the expected responses set by simulations and the actual responses returned from the real service. The parameter shouldResetDiff says if all available diffs should be removed when the assertion is done.

Parameters:

shouldResetDiff - if all available diffs should be removed when the assertion is done.