Package de.quantummaid.eventmaid.useCases.useCaseAdapter

Class UseCaseInvocationBuilder

java.lang.Object

de.quantummaid.eventmaid.useCases.useCaseAdapter.UseCaseInvocationBuilder

All Implemented Interfaces:

BuilderStepBuilder, ExceptionSerializationStep1Builder, FinalStepBuilder, InjectionStepBuilder, InstantiationBuilder, InvokingUseCaseStepBuilder, RequestDeserializationStep1Builder, RequestSerializationStep1Builder, ResponseDeserializationStep1Builder, ResponseSerializationStep1Builder, Step1Builder

public final class UseCaseInvocationBuilder
extends Object
implements Step1Builder, InstantiationBuilder, RequestDeserializationStep1Builder, RequestSerializationStep1Builder, ResponseSerializationStep1Builder, ExceptionSerializationStep1Builder, ResponseDeserializationStep1Builder, FinalStepBuilder

Fluent interface builder to configure either a UseCaseAdapter or a UseCaseBus.

Constructor Summary

Constructors

Constructor	Description
UseCaseInvocationBuilder()

Method Summary

Modifier and Type	Method	Description
static Step1Builder	anUseCaseAdapter()	Starts the configuration of a UseCaseAdapter.
static Step1Builder	anUseCaseBus()	Starts the configuration of a UseCaseBus.
UseCaseBus	build(MessageBus messageBus)	Completes the configuration and creates a UseCaseBus based on the given SerializedMessageBus.
UseCaseAdapter	buildAsStandaloneAdapter()	Completes the configuration and creates a UseCaseAdapter.
ResponseSerializationStep1Builder	deserializeRequestsToUseCaseParametersPerDefault(Demapifier<Object> mapper)	Configures the default Demapifier that will be used to deserialize a to a use case parameter if no Demapifier configured can be applied.
<T> RequestDeserializationStep2Builder<T>	deserializeRequestsToUseCaseParametersThat(BiPredicate<Class<?>,Object> filter)	Enters a fluent builder that configures a Demapifier that will be used to deserialize a Map to a use case parameter if the object matches the provided filter.
FinalStepBuilder	deserializeUseCaseResponsesPerDefault(Demapifier<Object> mapper)	Configures the default Demapifier that will be used to deserialize a use case response if no Demapifier configured matches the response.
<T> ResponseDeserializationStep2Builder<T>	deserializingUseCaseResponsesOfThat(BiPredicate<Class<?>,Object> filter)	Enters a fluent builder that configures a Demapifier that will be used to deserialize a Map from the MessageBus to the return value of the use case invocation, if the object matches the provided filter.
<T> FinalStepBuilder	injectParameterForClass(Class<T> parameterClass, Function<ParameterInjectionInformation,T> injectionFunction)	Adds a new parameter injection.
<U> Step2Builder<U>	invokingUseCase(Class<U> useCaseClass)	Adds a new invocation information for a use case of the given Class.
RequestSerializationStep1Builder	obtainingUseCaseInstancesUsing(UseCaseInstantiator useCaseInstantiator)	Configures the UseCaseInvocationBuilder to use the given UseCaseInstantiator for each request.
ResponseDeserializationStep1Builder	serializingExceptionsByDefaultUsing(Mapifier<Exception> mapper)	Configures the default Mapifier that will be used to serialize an exception to a Map if no Mapifier configured under ExceptionSerializationStep1Builder.serializingExceptionsThat(Predicate), ExceptionSerializationStep1Builder.serializingExceptionsOfType(Class), etc.
ExceptionSerializationStep2Builder<Exception>	serializingExceptionsThat(Predicate<Exception> filter)	Enters a fluent builder that configures a Mapifier that will be used to serialize an exception thrown by a use case to a Map if the exception matches the provided filter.
RequestSerializationStep2Builder<Object>	serializingUseCaseRequestOntoTheBusMatching(Predicate<Object> filter)	Enters a fluent builder that configures a Mapifier that will be used to serialize a use case request onto the MessageBus if the type matches the provided filter.
RequestDeserializationStep1Builder	serializingUseCaseRequestsByDefaultUsing(Mapifier<Object> mapper)	Configures the default Mapifier that will be used to serialize a use case request if no other serialization can be applied.
ExceptionSerializationStep1Builder	serializingUseCaseResponseBackOntoTheBusByDefaultUsing(Mapifier<Object> mapper)	Configures the default Mapifier that will be used to serialize a use case return value onto the MessageBus if no Mapifier configured matches the use case return value.
ResponseSerializationStep2Builder<Object>	serializingUseCaseResponseBackOntoTheBusThat(Predicate<Object> filter)	Enters a fluent builder that configures a Mapifier that will be used to serialize a use case return value onto the MessageBus if the use case return value matches the provided filter.

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.quantummaid.eventmaid.useCases.building.ExceptionSerializationStep1Builder

puttingExceptionObjectNamedAsExceptionIntoResponseMapByDefault, respondingWithAWrappingMissingExceptionSerializationExceptionByDefault, serializingExceptionsOfType

Methods inherited from interface de.quantummaid.eventmaid.useCases.building.InstantiationBuilder

obtainingUseCaseInstancesUsingTheZeroArgumentConstructor

Methods inherited from interface de.quantummaid.eventmaid.useCases.building.RequestDeserializationStep1Builder

deserializingRequestsToUseCaseParametersOfType, throwAnExceptionByDefaultIfNoUseCaseRequestDeserializationCanBeApplied

Methods inherited from interface de.quantummaid.eventmaid.useCases.building.RequestSerializationStep1Builder

serializingUseCaseRequestOntoTheBusOfType, serializingUseCaseRequestOntoTheBusOfTypeVoid, throwingAnExceptionByDefaultIfNoRequestSerializationCanBeApplied

Methods inherited from interface de.quantummaid.eventmaid.useCases.building.ResponseDeserializationStep1Builder

deserializingUseCaseResponsesOfType, deserializingUseCaseResponsesThat, throwAnExceptionByDefaultIfNoResponseDeserializationCanBeApplied

Methods inherited from interface de.quantummaid.eventmaid.useCases.building.ResponseSerializationStep1Builder

serializingResponseObjectsOfTypeVoid, serializingUseCaseResponseBackOntoTheBusOfType, throwingAnExceptionByDefaultIfNoResponseSerializationCanBeApplied

Constructor Detail

UseCaseInvocationBuilder

public UseCaseInvocationBuilder()

Method Detail

anUseCaseAdapter

public static Step1Builder anUseCaseAdapter()

Starts the configuration of a UseCaseAdapter.

Returns:

the first step in the fluent builder interface

anUseCaseBus

public static Step1Builder anUseCaseBus()

Starts the configuration of a UseCaseBus.

Returns:

the first step in the fluent builder interface

invokingUseCase

public <U> Step2Builder<U> invokingUseCase(Class<U> useCaseClass)

Description copied from interface: InvokingUseCaseStepBuilder

Adds a new invocation information for a use case of the given Class.

Specified by:

invokingUseCase in interface InvokingUseCaseStepBuilder

Type Parameters:

U - the type of the use case

Parameters:

useCaseClass - the Class of the use case

Returns:

the next step in the fluent builder interface

obtainingUseCaseInstancesUsing

public RequestSerializationStep1Builder obtainingUseCaseInstancesUsing(UseCaseInstantiator useCaseInstantiator)

Description copied from interface: InstantiationBuilder

Configures the UseCaseInvocationBuilder to use the given UseCaseInstantiator for each request.

Specified by:

obtainingUseCaseInstancesUsing in interface InstantiationBuilder

Parameters:

useCaseInstantiator - the UseCaseInstantiator to invoke

Returns:

the next step in the fluent builder interface

serializingUseCaseRequestOntoTheBusMatching

public RequestSerializationStep2Builder<Object> serializingUseCaseRequestOntoTheBusMatching(Predicate<Object> filter)

Description copied from interface: RequestSerializationStep1Builder

Enters a fluent builder that configures a Mapifier that will be used to serialize a use case request onto the MessageBus if the type matches the provided filter.

Specified by:

serializingUseCaseRequestOntoTheBusMatching in interface RequestSerializationStep1Builder

Parameters:

filter - a Predicate that returns true if the Mapifier should be used on the respective use case request

Returns:

the next step in the fluent builder

serializingUseCaseRequestsByDefaultUsing

public RequestDeserializationStep1Builder serializingUseCaseRequestsByDefaultUsing(Mapifier<Object> mapper)

Description copied from interface: RequestSerializationStep1Builder

Configures the default Mapifier that will be used to serialize a use case request if no other serialization can be applied.

Specified by:

serializingUseCaseRequestsByDefaultUsing in interface RequestSerializationStep1Builder

Parameters:

mapper - a Mapifier

Returns:

the next step in the fluent builder

deserializeRequestsToUseCaseParametersThat

public <T> RequestDeserializationStep2Builder<T> deserializeRequestsToUseCaseParametersThat(BiPredicate<Class<?>,Object> filter)

Description copied from interface: RequestDeserializationStep1Builder

Enters a fluent builder that configures a Demapifier that will be used to deserialize a Map to a use case parameter if the object matches the provided filter.

Specified by:

deserializeRequestsToUseCaseParametersThat in interface RequestDeserializationStep1Builder

Type Parameters:

T - the type of the use case response

Parameters:

filter - a BiPredicate that returns true if the Demapifier should be used on the respective http request

Returns:

the next step in the fluent builder

deserializeRequestsToUseCaseParametersPerDefault

public ResponseSerializationStep1Builder deserializeRequestsToUseCaseParametersPerDefault(Demapifier<Object> mapper)

Description copied from interface: RequestDeserializationStep1Builder

Configures the default Demapifier that will be used to deserialize a to a use case parameter if no Demapifier configured can be applied.

Specified by:

deserializeRequestsToUseCaseParametersPerDefault in interface RequestDeserializationStep1Builder

Parameters:

mapper - a Demapifier

Returns:

the next step in the fluent builder

serializingUseCaseResponseBackOntoTheBusThat

public ResponseSerializationStep2Builder<Object> serializingUseCaseResponseBackOntoTheBusThat(Predicate<Object> filter)

Description copied from interface: ResponseSerializationStep1Builder

Enters a fluent builder that configures a Mapifier that will be used to serialize a use case return value onto the MessageBus if the use case return value matches the provided filter.

Specified by:

serializingUseCaseResponseBackOntoTheBusThat in interface ResponseSerializationStep1Builder

Parameters:

filter - a Predicate that returns true if the Mapifier should be used on the respective use case response

Returns:

the next step in the fluent builder

serializingUseCaseResponseBackOntoTheBusByDefaultUsing

public ExceptionSerializationStep1Builder serializingUseCaseResponseBackOntoTheBusByDefaultUsing(Mapifier<Object> mapper)

Description copied from interface: ResponseSerializationStep1Builder

Configures the default Mapifier that will be used to serialize a use case return value onto the MessageBus if no Mapifier configured matches the use case return value.

Specified by:

serializingUseCaseResponseBackOntoTheBusByDefaultUsing in interface ResponseSerializationStep1Builder

Parameters:

mapper - a Mapifier

Returns:

the next step in the fluent builder

serializingExceptionsThat

public ExceptionSerializationStep2Builder<Exception> serializingExceptionsThat(Predicate<Exception> filter)

Description copied from interface: ExceptionSerializationStep1Builder

Enters a fluent builder that configures a Mapifier that will be used to serialize an exception thrown by a use case to a Map if the exception matches the provided filter.

Specified by:

serializingExceptionsThat in interface ExceptionSerializationStep1Builder

Parameters:

filter - a Predicate that returns true if the Mapifier should be used on the respective exception

Returns:

the next step in the fluent builder

serializingExceptionsByDefaultUsing

public ResponseDeserializationStep1Builder serializingExceptionsByDefaultUsing(Mapifier<Exception> mapper)

Description copied from interface: ExceptionSerializationStep1Builder

Configures the default Mapifier that will be used to serialize an exception to a Map if no Mapifier configured under ExceptionSerializationStep1Builder.serializingExceptionsThat(Predicate), ExceptionSerializationStep1Builder.serializingExceptionsOfType(Class), etc. matches the exception.

Specified by:

serializingExceptionsByDefaultUsing in interface ExceptionSerializationStep1Builder

Parameters:

mapper - a Mapifier

Returns:

the next step in the fluent builder

deserializingUseCaseResponsesOfThat

public <T> ResponseDeserializationStep2Builder<T> deserializingUseCaseResponsesOfThat(BiPredicate<Class<?>,Object> filter)

Description copied from interface: ResponseDeserializationStep1Builder

Enters a fluent builder that configures a Demapifier that will be used to deserialize a Map from the MessageBus to the return value of the use case invocation, if the object matches the provided filter.

Specified by:

deserializingUseCaseResponsesOfThat in interface ResponseDeserializationStep1Builder

Type Parameters:

T - the type of the use case response

Parameters:

filter - a BiPredicate that returns true if the Demapifier should be used

Returns:

the next step in the fluent builder

deserializeUseCaseResponsesPerDefault

public FinalStepBuilder deserializeUseCaseResponsesPerDefault(Demapifier<Object> mapper)

Description copied from interface: ResponseDeserializationStep1Builder

Configures the default Demapifier that will be used to deserialize a use case response if no Demapifier configured matches the response.

Specified by:

deserializeUseCaseResponsesPerDefault in interface ResponseDeserializationStep1Builder

Parameters:

mapper - a Demapifier

Returns:

the next step in the fluent builder

injectParameterForClass

public <T> FinalStepBuilder injectParameterForClass(Class<T> parameterClass,
                                                    Function<ParameterInjectionInformation,T> injectionFunction)

Description copied from interface: InjectionStepBuilder

Adds a new parameter injection.

Calling this method again for the same class overwrites previous calls.

Specified by:

injectParameterForClass in interface InjectionStepBuilder

Type Parameters:

T - the type of the class

Parameters:

parameterClass - the class of the paramter to inject

injectionFunction - a function to inject the value based on the ParameterInjectionInformation

Returns:

the next step in the fluent builder interface

build

public UseCaseBus build(MessageBus messageBus)

Description copied from interface: BuilderStepBuilder

Completes the configuration and creates a UseCaseBus based on the given SerializedMessageBus.

Specified by:

build in interface BuilderStepBuilder

Parameters:

messageBus - the MessageBus to use

Returns:

the newly created UseCaseBus

buildAsStandaloneAdapter

public UseCaseAdapter buildAsStandaloneAdapter()

Description copied from interface: BuilderStepBuilder

Completes the configuration and creates a UseCaseAdapter.

Specified by:

buildAsStandaloneAdapter in interface BuilderStepBuilder

Returns:

the newly created UseCaseAdapter