org.mule.functional.junit4

Class FlowRunner

java.lang.Object

org.mule.functional.junit4.FlowConstructRunner<FlowRunner>

org.mule.functional.junit4.FlowRunner

public class FlowRunner
extends FlowConstructRunner<FlowRunner>

Provides a fluent API for running events through flows. This runner is not thread-safe.

Field Summary

Fields inherited from class org.mule.functional.junit4.FlowConstructRunner

eventBuilder, muleContext

Constructor Summary

Constructors

Constructor and Description
FlowRunner(MuleContext muleContext, String flowName) Initializes this flow runner.

Method Summary

Modifier and Type	Method and Description
void	dispatch() Dispatchs to the specified flow with the provided event and configuration, and performs a FlowAssert#verify(String)) afterwards.
void	dispatchAsync() Dispatchs to the specified flow with the provided event and configuration in a new IO thread, and performs a FlowAssert#verify(String)) afterwards.
String	getFlowConstructName()
FlowRunner	nonBlocking() Configures this runner's flow to be run non-blocking.
Event	run() Runs the specified flow with the provided event and configuration, and performs a FlowAssert#verify(String)) afterwards.
Event	runAndVerify(String... flowNamesToVerify) Runs the specified flow with the provided event and configuration, and performs a FlowAssert#verify(String)) for each flowNamesToVerify afterwards.
MessagingException	runExpectingException() Runs the specified flow with the provided event and configuration expecting a failure.
Event	runNoVerify() Runs the specified flow with the provided event and configuration.
FlowRunner	transactionally(TransactionConfigEnum action, TransactionFactory factory) Configures the flow to run inside a transaction.

Methods inherited from class org.mule.functional.junit4.FlowConstructRunner

buildEvent, getFlowConstruct, getOrBuildEvent, reset, spyObjects, withAttributes, withCorrelation, withExchangePattern, withInboundAttachment, withInboundProperties, withInboundProperty, withMediaType, withOutboundAttachment, withOutboundAttachment, withOutboundProperty, withPayload, withSessionProperty, withSourceCorrelationId, withVariable

Methods inherited from class java.lang.Object

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

Constructor Detail

FlowRunner

public FlowRunner(MuleContext muleContext,
                  String flowName)

Initializes this flow runner.

Parameters:

muleContext - the context of the mule application

flowName - the name of the flow to run events through

Method Detail

transactionally

public FlowRunner transactionally(TransactionConfigEnum action,
                                  TransactionFactory factory)

Configures the flow to run inside a transaction.

Parameters:

action - The action to do at the start of the transactional block. See TransactionConfig constants.

factory - See MuleTransactionConfig.setFactory(TransactionFactory).

Returns:

this FlowRunner

nonBlocking

public FlowRunner nonBlocking()

Configures this runner's flow to be run non-blocking.

Returns:

this FlowRunner

run

public Event run()
          throws Exception

Runs the specified flow with the provided event and configuration, and performs a FlowAssert#verify(String)) afterwards. If this is called multiple times, the same event will be sent. To force the creation of a new event, use FlowConstructRunner.reset().

Returns:

the resulting MuleEvent

Throws:

Exception

runNoVerify

public Event runNoVerify()
                  throws Exception

Runs the specified flow with the provided event and configuration. If this is called multiple times, the same event will be sent. To force the creation of a new event, use FlowConstructRunner.reset().

Returns:

the resulting MuleEvent

Throws:

Exception

runAndVerify

public Event runAndVerify(String... flowNamesToVerify)
                   throws Exception

Runs the specified flow with the provided event and configuration, and performs a FlowAssert#verify(String)) for each flowNamesToVerify afterwards. If this is called multiple times, the same event will be sent. To force the creation of a new event, use FlowConstructRunner.reset().

Parameters:

flowNamesToVerify - the names of the flows to FlowAssert#verify(String)) afterwards.

Returns:

the resulting MuleEvent

Throws:

Exception

dispatch

public void dispatch()
              throws Exception

Dispatchs to the specified flow with the provided event and configuration, and performs a FlowAssert#verify(String)) afterwards. If this is called multiple times, the same event will be sent. To force the creation of a new event, use FlowConstructRunner.reset(). Dispatch behaves differently to run() in that it does not propagate any exceptions to the test case or return a result.

Throws:

Exception

dispatchAsync

public void dispatchAsync()
                   throws Exception

Dispatchs to the specified flow with the provided event and configuration in a new IO thread, and performs a FlowAssert#verify(String)) afterwards. If this is called multiple times, the same event will be sent. To force the creation of a new event, use FlowConstructRunner.reset(). Dispatch behaves differently to run() in that it does not propagate any exceptions to the test case or return a result.

Throws:

Exception

runExpectingException

public MessagingException runExpectingException()
                                         throws Exception

Runs the specified flow with the provided event and configuration expecting a failure. Will fail if there's no failure running the flow.

Returns:

the message exception return by the flow

Throws:

Exception

getFlowConstructName

public String getFlowConstructName()

Specified by:

getFlowConstructName in class FlowConstructRunner<FlowRunner>

Returns:

the name of the FlowConstruct to use.