Package de.quantummaid.eventmaid.useCases.useCaseBus

Interface UseCaseBus

public interface UseCaseBus

The use case bus invokes use cases as defined by UseCaseInvocationBuilder. Requests are serialized using the defined Serializer. All methods wait until a fitting response was received and can optionally deserialized with the defined Deserializer.

Method Summary

Modifier and Type	Method	Description
<P,E> PayloadAndErrorPayload<P,E>	invokeAndWait(EventType eventType, Object data, Class<P> payloadClass, Class<E> errorPayloadClass)	Invokes the correct use case based on the EventType with the send data.
<P,E> PayloadAndErrorPayload<P,E>	invokeAndWait(EventType eventType, Object data, Class<P> payloadClass, Class<E> errorPayloadClass, long timeout, TimeUnit unit)	Invokes the correct use case based on the EventType with the send data, which is serialized before sending it.
PayloadAndErrorPayload<Object,Object>	invokeAndWaitNotDeserialized(EventType eventType, Object data)	Invokes the correct use case based on the EventType with the send data, which is serialized before sending it.
PayloadAndErrorPayload<Object,Object>	invokeAndWaitNotDeserialized(EventType eventType, Object data, long timeout, TimeUnit unit)	Invokes the correct use case based on the EventType with the send data, which is serialized before sending it.
static UseCaseBus	useCaseBus(SerializedMessageBus serializedMessageBus)

Method Detail

useCaseBus

static UseCaseBus useCaseBus(SerializedMessageBus serializedMessageBus)

invokeAndWait

<P,E> PayloadAndErrorPayload<P,E> invokeAndWait(EventType eventType,
                                                            Object data,
                                                            Class<P> payloadClass,
                                                            Class<E> errorPayloadClass)
                                                     throws InterruptedException,
                                                            ExecutionException

Invokes the correct use case based on the EventType with the send data. The method waits until a response is received or an exception occurred. The response is deserialized based on the given classes.

Type Parameters:

P - the type to serialize the response payload to

E - the type to serialize the error response payload to

Parameters:

eventType - the EventType to send the request on

data - the request data

payloadClass - the class to serialize the response payload to

errorPayloadClass - the class to serialize the error response payload to

Returns:

the serialized response

Throws:

InterruptedException - if the waiting Thread was interrupted

ExecutionException - if an exception occurred

invokeAndWait

<P,E> PayloadAndErrorPayload<P,E> invokeAndWait(EventType eventType,
                                                            Object data,
                                                            Class<P> payloadClass,
                                                            Class<E> errorPayloadClass,
                                                            long timeout,
                                                            TimeUnit unit)
                                                     throws InterruptedException,
                                                            ExecutionException,
                                                            TimeoutException

Invokes the correct use case based on the EventType with the send data, which is serialized before sending it. The method waits until a response is received, an exception occurred or the timeout expired. The response is deserialized based on the given classes.

Type Parameters:

P - the type to serialize the response payload to

E - the type to serialize the error response payload to

Parameters:

eventType - the EventType to send the request on

data - the request data

payloadClass - the class to serialize the response payload to

errorPayloadClass - the class to serialize the error response payload to

timeout - the interval to wait

unit - the unit to define the interval

Returns:

the deserialized response

Throws:

InterruptedException - if the waiting Thread was interrupted

ExecutionException - if an exception occurred

TimeoutException - if the timeout expires

invokeAndWaitNotDeserialized

PayloadAndErrorPayload<Object,Object> invokeAndWaitNotDeserialized(EventType eventType,
                                                                         Object data)
                                                                  throws InterruptedException,
                                                                         ExecutionException

Invokes the correct use case based on the EventType with the send data, which is serialized before sending it. The method waits until a response is received or an exception occurred. The response is not deserialized.

Parameters:

eventType - the EventType to send the request on

data - the request data

Returns:

the raw response

Throws:

InterruptedException - if the waiting Thread was interrupted

ExecutionException - if an exception occurred

invokeAndWaitNotDeserialized

PayloadAndErrorPayload<Object,Object> invokeAndWaitNotDeserialized(EventType eventType,
                                                                         Object data,
                                                                         long timeout,
                                                                         TimeUnit unit)
                                                                  throws InterruptedException,
                                                                         ExecutionException,
                                                                         TimeoutException

Invokes the correct use case based on the EventType with the send data, which is serialized before sending it. The method waits until a response is received or an exception occurred. The response is not deserialized.

Parameters:

eventType - the EventType to send the request on

data - the request data

timeout - the interval to wait

unit - the unit to define the interval

Returns:

the raw response

Throws:

InterruptedException - if the waiting Thread was interrupted

ExecutionException - if an exception occurred

TimeoutException - if the timeout expires