io.spine.server.commandbus

Interface CommandDispatcherDelegate<I>

Type Parameters:

I - the type of IDs of entities that handle the commands dispatched by the delegate

All Known Implementing Classes:

ProcessManagerRepository

@Internal
public interface CommandDispatcherDelegate<I>

A common interface for objects which need to dispatch the commands, but are unable to implement the CommandDispatcher.

A typical example of a CommandDispatcherDelegate usage is a routine, which simultaneously dispatches different types of messages in addition to Commands.

In this case such a class would have to implement several MessageDispatcher child interfaces (such as CommandDispatcher or EventDispatcher). However, it is impossible to implement the same getMessageClasses() method several times with the different types of MessageClasses returned.

The same interference takes place in attempt to implement UnicastDispatcher.dispatch(MessageEnvelope) method with the different types of MessageEnvelopes dispatches simultaneously.

That's why unlike MessageDispatcher, this interface defines its own contract for declaring the dispatched command classes, which does not interfere with the MessageDispatcher API.

See Also:

DelegatingCommandDispatcher

Method Summary

Modifier and Type	Method and Description
I	dispatchCommand(io.spine.core.CommandEnvelope envelope)
default boolean	dispatchesCommands() Verifies if this instance dispatches at least one command.
java.util.Set<io.spine.core.CommandClass>	getCommandClasses()
void	onError(io.spine.core.CommandEnvelope envelope, java.lang.RuntimeException exception) Handles an error occurred during command dispatching.

Method Detail

getCommandClasses

java.util.Set<io.spine.core.CommandClass> getCommandClasses()

dispatchCommand

I dispatchCommand(io.spine.core.CommandEnvelope envelope)

onError

void onError(io.spine.core.CommandEnvelope envelope,
             java.lang.RuntimeException exception)

Handles an error occurred during command dispatching.

Parameters:

envelope - the event which caused the error

exception - the error

dispatchesCommands

default boolean dispatchesCommands()

Verifies if this instance dispatches at least one command.