org.mule.commons.atlantic.execution.builder.factory

Interface ExecutionFactoryBuilder<SELF extends ExecutionFactoryBuilder>

All Known Subinterfaces:

ChainedSupplierBuilderFactory<SELF>, InstanceRunnableBuilderFactory<INSTANCE,SELF>, InstanceSupplierBuilderFactory<INSTANCE,SELF>, RunnableBuilderFactory<SELF>, SupplierBuilderFactory<SELF>

All Known Implementing Classes:

ChainedExecutionFactoryBuilder, DefaultExecutionFactoryBuilder, InstanceExecutionFactoryBuilder, StaticExecutionFactoryBuilder

public interface ExecutionFactoryBuilder<SELF extends ExecutionFactoryBuilder>

Method Summary

Modifier and Type	Method and Description
ExecutionFactory	buildExecutionFactory() Builds the ExecutionFactory.
<T extends Throwable> SELF	withExceptionHandler(Class<T> exceptionClass, ExceptionHandler<T> exceptionHandler) Adds an ExceptionHandler to handle a specific kind of Throwable or it's subclasses.
<T extends Throwable> SELF	withExceptionHandler(DefinedExceptionHandler<T> exceptionHandler) Adds a DefinedExceptionHandler to handle a specific kind of Throwable or it's subclasses.
<T extends RuntimeException> SELF	withIgnoredExceptionType(Class<T> exceptionClass) Allows a specific RuntimeException and it's subclasses to be ignored by the exception handlers.
SELF	withPostExecutionListener(List<OnSuccessListener> onSuccessListeners) Adds a list of OnPreExecutionListeners to be executed after the execution.
SELF	withPostExecutionListener(OnSuccessListener... onSuccessListeners) Adds an array of OnPreExecutionListeners to be executed after the execution.
SELF	withPreExecutionListener(List<OnPreExecutionListener> onPreExecutionListeners) Adds a list of OnPreExecutionListeners to be executed before the execution.
SELF	withPreExecutionListener(OnPreExecutionListener... onPreExecutionListeners) Adds an array of OnPreExecutionListeners to be executed before the execution.

Method Detail

withPreExecutionListener

SELF withPreExecutionListener(OnPreExecutionListener... onPreExecutionListeners)

Adds an array of OnPreExecutionListeners to be executed before the execution.

Parameters:

onPreExecutionListeners - The listeners to set.

Returns:

DefaultExecutionFactoryBuilder This execution builder factory.

withPreExecutionListener

SELF withPreExecutionListener(List<OnPreExecutionListener> onPreExecutionListeners)

Adds a list of OnPreExecutionListeners to be executed before the execution.

Parameters:

onPreExecutionListeners - The listeners to set.

Returns:

DefaultExecutionFactoryBuilder This execution builder factory.

withPostExecutionListener

SELF withPostExecutionListener(OnSuccessListener... onSuccessListeners)

Adds an array of OnPreExecutionListeners to be executed after the execution.

Parameters:

onSuccessListeners - The listeners to set.

Returns:

DefaultExecutionFactoryBuilder This execution builder factory.

withPostExecutionListener

SELF withPostExecutionListener(List<OnSuccessListener> onSuccessListeners)

Adds a list of OnPreExecutionListeners to be executed after the execution.

Parameters:

onSuccessListeners - The listeners to set.

Returns:

DefaultExecutionFactoryBuilder This execution builder factory.

withExceptionHandler

<T extends Throwable> SELF withExceptionHandler(Class<T> exceptionClass,
                                                ExceptionHandler<T> exceptionHandler)

Adds an ExceptionHandler to handle a specific kind of Throwable or it's subclasses. Handlers are triggered in the order they were set into the context with only the first match found triggering. This means that if the following case would happen: executor.withExceptionHandler(Throwable.class, myThrowableExceptionHandler) .withExceptionHandler(RuntimeException.class, myRuntimeExceptionExceptionHandler); And a RuntimeException is thrown, then the myThrowableExceptionHandler would catch it and handle it. Additionally, any non handled exceptions, unless ignored using DefaultExecutionFactoryBuilder.withIgnoredExceptionType(Class), will be wrapped in an UnhandledException and thrown as such.

Type Parameters:

T - The subtype of Throwable that will be handled here.

Parameters:

exceptionClass - The exception type to handle. This will include the specific exception and all it's subclasses.

exceptionHandler - The handler for the exception.

Returns:

DefaultExecutionFactoryBuilder This execution builder factory.

withExceptionHandler

<T extends Throwable> SELF withExceptionHandler(DefinedExceptionHandler<T> exceptionHandler)

Adds a DefinedExceptionHandler to handle a specific kind of Throwable or it's subclasses. Handlers are triggered in the order they were set into the context with only the first match found triggering. This means that if the following case would happen: executor.<Throwable>withExceptionHandler(myDefinedThrowableExceptionHandler) .<RuntimeException>withExceptionHandler(myDefinedRuntimeExceptionExceptionHandler); And a RuntimeException is thrown, then the myDefinedThrowableExceptionHandler would catch it and handle it. Additionally, any non handled exceptions, unless ignored using DefaultExecutionFactoryBuilder.withIgnoredExceptionType(Class), will be wrapped in an UnhandledException and thrown as such.

Type Parameters:

T - The subtype of Throwable that will be handled here.

Parameters:

exceptionHandler - The handler for the exception.

Returns:

DefaultExecutionFactoryBuilder This execution builder factory.

withIgnoredExceptionType

<T extends RuntimeException> SELF withIgnoredExceptionType(Class<T> exceptionClass)

Allows a specific RuntimeException and it's subclasses to be ignored by the exception handlers.

Type Parameters:

T - The type of the RuntimeException to ignore.

Parameters:

exceptionClass - The class of the runtime exception to ignore. it must extend RuntimeException

Returns:

DefaultExecutionFactoryBuilder This execution builder factory.

buildExecutionFactory

ExecutionFactory buildExecutionFactory()

Builds the ExecutionFactory.

Returns:

Execution The execution context built based on this builder.