Module dk.cloudcreate.essentials.components.foundation

Package dk.cloudcreate.essentials.components.foundation.reactive.command

Class DurableLocalCommandBus

java.lang.Object

dk.cloudcreate.essentials.reactive.command.AbstractCommandBus

dk.cloudcreate.essentials.components.foundation.reactive.command.DurableLocalCommandBus

All Implemented Interfaces:

CommandBus

public class DurableLocalCommandBus
extends AbstractCommandBus

Provides a JVM local and durable, in regard to sendAndDontWait(Object)/sendAndDontWait(Object, Duration)), variant of the CommandBus concept
Durability for sendAndDontWait(Object)/sendAndDontWait(Object, Duration)) is delegated to DurableQueues
Which QueueName that is used will be determined by the CommandQueueNameSelector and the RedeliveryPolicy is determined by the CommandQueueRedeliveryPolicyResolver

Note: If the SendAndDontWaitErrorHandler provided doesn't rethrow the exception, then the underlying DurableQueues will not be able to retry the command.
Due to this the DurableLocalCommandBus defaults to using the SendAndDontWaitErrorHandler.RethrowingSendAndDontWaitErrorHandler

See Also:

AnnotatedCommandHandler

Field Summary

Fields inherited from class dk.cloudcreate.essentials.reactive.command.AbstractCommandBus

commandHandlers, commandTypeToCommandHandlerCache, interceptors, sendAndDontWaitErrorHandler

Constructor Summary

Constructors

Constructor	Description
DurableLocalCommandBus(DurableQueues durableQueues)	Create a new DurableLocalCommandBus using defaults: CommandQueueNameSelector: CommandQueueNameSelector.defaultCommandQueueForAllCommands() CommandQueueRedeliveryPolicyResolver: CommandQueueRedeliveryPolicyResolver.sameReliveryPolicyForAllCommandQueues(RedeliveryPolicy) SendAndDontWaitErrorHandler: SendAndDontWaitErrorHandler.RethrowingSendAndDontWaitErrorHandler
DurableLocalCommandBus(DurableQueues durableQueues, int parallelSendAndDontWaitConsumers, CommandQueueNameSelector commandQueueNameSelector, CommandQueueRedeliveryPolicyResolver commandQueueRedeliveryPolicyResolver, SendAndDontWaitErrorHandler sendAndDontWaitErrorHandler, CommandBusInterceptor... interceptors)	Create a new DurableLocalCommandBus
DurableLocalCommandBus(DurableQueues durableQueues, int parallelSendAndDontWaitConsumers, CommandQueueNameSelector commandQueueNameSelector, CommandQueueRedeliveryPolicyResolver commandQueueRedeliveryPolicyResolver, SendAndDontWaitErrorHandler sendAndDontWaitErrorHandler, List<CommandBusInterceptor> interceptors)	Create a new DurableLocalCommandBus
DurableLocalCommandBus(DurableQueues durableQueues, CommandQueueNameSelector commandQueueNameSelector, CommandQueueRedeliveryPolicyResolver commandQueueRedeliveryPolicyResolver)	Create a new DurableLocalCommandBus using defaults: SendAndDontWaitErrorHandler: SendAndDontWaitErrorHandler.RethrowingSendAndDontWaitErrorHandler
DurableLocalCommandBus(DurableQueues durableQueues, CommandQueueNameSelector commandQueueNameSelector, CommandBusInterceptor... interceptors)	Create a new DurableLocalCommandBus using defaults: CommandQueueRedeliveryPolicyResolver: CommandQueueRedeliveryPolicyResolver.sameReliveryPolicyForAllCommandQueues(RedeliveryPolicy) SendAndDontWaitErrorHandler: SendAndDontWaitErrorHandler.RethrowingSendAndDontWaitErrorHandler
DurableLocalCommandBus(DurableQueues durableQueues, CommandQueueNameSelector commandQueueNameSelector, SendAndDontWaitErrorHandler sendAndDontWaitErrorHandler)	Create a new DurableLocalCommandBus using defaults: SendAndDontWaitErrorHandler: SendAndDontWaitErrorHandler.RethrowingSendAndDontWaitErrorHandler
DurableLocalCommandBus(DurableQueues durableQueues, CommandQueueNameSelector commandQueueNameSelector, SendAndDontWaitErrorHandler sendAndDontWaitErrorHandler, List<CommandBusInterceptor> interceptors)	Create a new DurableLocalCommandBus using defaults: CommandQueueRedeliveryPolicyResolver: CommandQueueRedeliveryPolicyResolver.sameReliveryPolicyForAllCommandQueues(RedeliveryPolicy)
DurableLocalCommandBus(DurableQueues durableQueues, CommandQueueNameSelector commandQueueNameSelector, List<CommandBusInterceptor> interceptors)	Create a new DurableLocalCommandBus using defaults: CommandQueueRedeliveryPolicyResolver: CommandQueueRedeliveryPolicyResolver.sameReliveryPolicyForAllCommandQueues(RedeliveryPolicy) SendAndDontWaitErrorHandler: SendAndDontWaitErrorHandler.RethrowingSendAndDontWaitErrorHandler
DurableLocalCommandBus(DurableQueues durableQueues, CommandBusInterceptor... interceptors)	Create a new DurableLocalCommandBus using defaults: CommandQueueNameSelector: CommandQueueNameSelector.defaultCommandQueueForAllCommands() CommandQueueRedeliveryPolicyResolver: CommandQueueRedeliveryPolicyResolver.sameReliveryPolicyForAllCommandQueues(RedeliveryPolicy) SendAndDontWaitErrorHandler: SendAndDontWaitErrorHandler.RethrowingSendAndDontWaitErrorHandler
DurableLocalCommandBus(DurableQueues durableQueues, SendAndDontWaitErrorHandler sendAndDontWaitErrorHandler)	Create a new DurableLocalCommandBus using defaults: CommandQueueNameSelector: CommandQueueNameSelector.defaultCommandQueueForAllCommands() CommandQueueRedeliveryPolicyResolver: CommandQueueRedeliveryPolicyResolver.sameReliveryPolicyForAllCommandQueues(RedeliveryPolicy)
DurableLocalCommandBus(DurableQueues durableQueues, SendAndDontWaitErrorHandler sendAndDontWaitErrorHandler, CommandBusInterceptor... interceptors)	Create a new DurableLocalCommandBus using defaults: using defaults: CommandQueueNameSelector: CommandQueueNameSelector.defaultCommandQueueForAllCommands() CommandQueueRedeliveryPolicyResolver: CommandQueueRedeliveryPolicyResolver.sameReliveryPolicyForAllCommandQueues(RedeliveryPolicy)
DurableLocalCommandBus(DurableQueues durableQueues, SendAndDontWaitErrorHandler sendAndDontWaitErrorHandler, List<CommandBusInterceptor> interceptors)	Create a new DurableLocalCommandBus using defaults: SendAndDontWaitErrorHandler: SendAndDontWaitErrorHandler.RethrowingSendAndDontWaitErrorHandler
DurableLocalCommandBus(DurableQueues durableQueues, List<CommandBusInterceptor> interceptors)	Create a new DurableLocalCommandBus using defaults: CommandQueueNameSelector: CommandQueueNameSelector.defaultCommandQueueForAllCommands() CommandQueueRedeliveryPolicyResolver: CommandQueueRedeliveryPolicyResolver.sameReliveryPolicyForAllCommandQueues(RedeliveryPolicy) SendAndDontWaitErrorHandler: SendAndDontWaitErrorHandler.RethrowingSendAndDontWaitErrorHandler

Method Summary

Modifier and Type	Method	Description
static DurableLocalCommandBusBuilder	builder()	Builder for a DurableLocalCommandBusBuilder
CommandQueueNameSelector	getCommandQueueNameSelector()
CommandQueueRedeliveryPolicyResolver	getCommandQueueRedeliveryPolicyResolver()
int	getParallelSendAndDontWaitConsumers()
<C> void	sendAndDontWait(C command)
<C> void	sendAndDontWait(C command, Duration delayMessageDelivery)

Methods inherited from class dk.cloudcreate.essentials.reactive.command.AbstractCommandBus

addCommandHandler, addInterceptor, findCommandHandlerCapableOfHandling, getInterceptors, hasCommandHandler, hasInterceptor, removeCommandHandler, removeInterceptor, send, sendAsync, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface dk.cloudcreate.essentials.reactive.command.CommandBus

addInterceptors

Constructor Detail

DurableLocalCommandBus

public DurableLocalCommandBus(DurableQueues durableQueues)

Create a new DurableLocalCommandBus using defaults:

• CommandQueueNameSelector: CommandQueueNameSelector.defaultCommandQueueForAllCommands()
• CommandQueueRedeliveryPolicyResolver: CommandQueueRedeliveryPolicyResolver.sameReliveryPolicyForAllCommandQueues(RedeliveryPolicy)
• SendAndDontWaitErrorHandler: SendAndDontWaitErrorHandler.RethrowingSendAndDontWaitErrorHandler

Parameters:

durableQueues - the underlying Durable Queues provider

DurableLocalCommandBus

public DurableLocalCommandBus(DurableQueues durableQueues,
                              CommandQueueNameSelector commandQueueNameSelector,
                              CommandQueueRedeliveryPolicyResolver commandQueueRedeliveryPolicyResolver)

Create a new DurableLocalCommandBus using defaults:

• SendAndDontWaitErrorHandler: SendAndDontWaitErrorHandler.RethrowingSendAndDontWaitErrorHandler

Parameters:

durableQueues - the underlying Durable Queues provider

commandQueueNameSelector - {The strategy for selecting which DurableQueues QueueName to use for a given combination of command and command handler

commandQueueRedeliveryPolicyResolver - Strategy that allows the DurableLocalCommandBus to vary the RedeliveryPolicy per QueueName

DurableLocalCommandBus

public DurableLocalCommandBus(DurableQueues durableQueues,
                              SendAndDontWaitErrorHandler sendAndDontWaitErrorHandler)

Create a new DurableLocalCommandBus using defaults:

• CommandQueueNameSelector: CommandQueueNameSelector.defaultCommandQueueForAllCommands()
• CommandQueueRedeliveryPolicyResolver: CommandQueueRedeliveryPolicyResolver.sameReliveryPolicyForAllCommandQueues(RedeliveryPolicy)

Parameters:

durableQueues - the underlying Durable Queues provider

sendAndDontWaitErrorHandler - Exception handler that will handle errors that occur during CommandBus.sendAndDontWait(Object)/CommandBus.sendAndDontWait(Object, Duration). If this handler doesn't rethrow the exeption, then the message will not be retried by the underlying DurableQueues

DurableLocalCommandBus

public DurableLocalCommandBus(DurableQueues durableQueues,
                              CommandQueueNameSelector commandQueueNameSelector,
                              SendAndDontWaitErrorHandler sendAndDontWaitErrorHandler)

Create a new DurableLocalCommandBus using defaults:

• SendAndDontWaitErrorHandler: SendAndDontWaitErrorHandler.RethrowingSendAndDontWaitErrorHandler

Parameters:

durableQueues - the underlying Durable Queues provider

commandQueueNameSelector - {The strategy for selecting which DurableQueues QueueName to use for a given combination of command and command handler

sendAndDontWaitErrorHandler - Exception handler that will handle errors that occur during CommandBus.sendAndDontWait(Object)/CommandBus.sendAndDontWait(Object, Duration). If this handler doesn't rethrow the exeption, then the message will not be retried by the underlying DurableQueues

DurableLocalCommandBus

public DurableLocalCommandBus(DurableQueues durableQueues,
                              List<CommandBusInterceptor> interceptors)

Create a new DurableLocalCommandBus using defaults:

• CommandQueueNameSelector: CommandQueueNameSelector.defaultCommandQueueForAllCommands()
• CommandQueueRedeliveryPolicyResolver: CommandQueueRedeliveryPolicyResolver.sameReliveryPolicyForAllCommandQueues(RedeliveryPolicy)
• SendAndDontWaitErrorHandler: SendAndDontWaitErrorHandler.RethrowingSendAndDontWaitErrorHandler

Parameters:

durableQueues - the underlying Durable Queues provider

interceptors - all the CommandBusInterceptor's

DurableLocalCommandBus

public DurableLocalCommandBus(DurableQueues durableQueues,
                              CommandQueueNameSelector commandQueueNameSelector,
                              List<CommandBusInterceptor> interceptors)

Create a new DurableLocalCommandBus using defaults:

• CommandQueueRedeliveryPolicyResolver: CommandQueueRedeliveryPolicyResolver.sameReliveryPolicyForAllCommandQueues(RedeliveryPolicy)
• SendAndDontWaitErrorHandler: SendAndDontWaitErrorHandler.RethrowingSendAndDontWaitErrorHandler

Parameters:

durableQueues - the underlying Durable Queues provider

commandQueueNameSelector - {The strategy for selecting which DurableQueues QueueName to use for a given combination of command and command handler

interceptors - all the CommandBusInterceptor's

DurableLocalCommandBus

public DurableLocalCommandBus(DurableQueues durableQueues,
                              SendAndDontWaitErrorHandler sendAndDontWaitErrorHandler,
                              List<CommandBusInterceptor> interceptors)

Create a new DurableLocalCommandBus using defaults:

• SendAndDontWaitErrorHandler: SendAndDontWaitErrorHandler.RethrowingSendAndDontWaitErrorHandler

Parameters:

durableQueues - the underlying Durable Queues provider

sendAndDontWaitErrorHandler - Exception handler that will handle errors that occur during CommandBus.sendAndDontWait(Object)/CommandBus.sendAndDontWait(Object, Duration). If this handler doesn't rethrow the exeption, then the message will not be retried by the underlying DurableQueues

interceptors - all the CommandBusInterceptor's

DurableLocalCommandBus

public DurableLocalCommandBus(DurableQueues durableQueues,
                              int parallelSendAndDontWaitConsumers,
                              CommandQueueNameSelector commandQueueNameSelector,
                              CommandQueueRedeliveryPolicyResolver commandQueueRedeliveryPolicyResolver,
                              SendAndDontWaitErrorHandler sendAndDontWaitErrorHandler,
                              List<CommandBusInterceptor> interceptors)

Create a new DurableLocalCommandBus

Parameters:

durableQueues - the underlying Durable Queues provider

parallelSendAndDontWaitConsumers - How many parallel DurableQueues consumers should listen for messages added using sendAndDontWait(Object)/sendAndDontWait(Object, Duration)

commandQueueNameSelector - {The strategy for selecting which DurableQueues QueueName to use for a given combination of command and command handler

commandQueueRedeliveryPolicyResolver - Strategy that allows the DurableLocalCommandBus to vary the RedeliveryPolicy per QueueName

sendAndDontWaitErrorHandler - Exception handler that will handle errors that occur during CommandBus.sendAndDontWait(Object)/CommandBus.sendAndDontWait(Object, Duration). If this handler doesn't rethrow the exeption, then the message will not be retried by the underlying DurableQueues

interceptors - all the CommandBusInterceptor's

DurableLocalCommandBus

public DurableLocalCommandBus(DurableQueues durableQueues,
                              CommandQueueNameSelector commandQueueNameSelector,
                              SendAndDontWaitErrorHandler sendAndDontWaitErrorHandler,
                              List<CommandBusInterceptor> interceptors)

Create a new DurableLocalCommandBus using defaults:

• CommandQueueRedeliveryPolicyResolver: CommandQueueRedeliveryPolicyResolver.sameReliveryPolicyForAllCommandQueues(RedeliveryPolicy)

Parameters:

durableQueues - the underlying Durable Queues provider

commandQueueNameSelector - {The strategy for selecting which DurableQueues QueueName to use for a given combination of command and command handler

sendAndDontWaitErrorHandler - Exception handler that will handle errors that occur during CommandBus.sendAndDontWait(Object)/CommandBus.sendAndDontWait(Object, Duration). If this handler doesn't rethrow the exeption, then the message will not be retried by the underlying DurableQueues

interceptors - all the CommandBusInterceptor's

DurableLocalCommandBus

public DurableLocalCommandBus(DurableQueues durableQueues,
                              CommandBusInterceptor... interceptors)

Create a new DurableLocalCommandBus using defaults:

• CommandQueueNameSelector: CommandQueueNameSelector.defaultCommandQueueForAllCommands()
• CommandQueueRedeliveryPolicyResolver: CommandQueueRedeliveryPolicyResolver.sameReliveryPolicyForAllCommandQueues(RedeliveryPolicy)
• SendAndDontWaitErrorHandler: SendAndDontWaitErrorHandler.RethrowingSendAndDontWaitErrorHandler

Parameters:

durableQueues - the underlying Durable Queues provider

interceptors - all the CommandBusInterceptor's

DurableLocalCommandBus

public DurableLocalCommandBus(DurableQueues durableQueues,
                              CommandQueueNameSelector commandQueueNameSelector,
                              CommandBusInterceptor... interceptors)

Create a new DurableLocalCommandBus using defaults:

• CommandQueueRedeliveryPolicyResolver: CommandQueueRedeliveryPolicyResolver.sameReliveryPolicyForAllCommandQueues(RedeliveryPolicy)
• SendAndDontWaitErrorHandler: SendAndDontWaitErrorHandler.RethrowingSendAndDontWaitErrorHandler

Parameters:

durableQueues - the underlying Durable Queues provider

commandQueueNameSelector - {The strategy for selecting which DurableQueues QueueName to use for a given combination of command and command handler

interceptors - all the CommandBusInterceptor's

DurableLocalCommandBus

public DurableLocalCommandBus(DurableQueues durableQueues,
                              SendAndDontWaitErrorHandler sendAndDontWaitErrorHandler,
                              CommandBusInterceptor... interceptors)

Create a new DurableLocalCommandBus using defaults: using defaults:

• CommandQueueNameSelector: CommandQueueNameSelector.defaultCommandQueueForAllCommands()
• CommandQueueRedeliveryPolicyResolver: CommandQueueRedeliveryPolicyResolver.sameReliveryPolicyForAllCommandQueues(RedeliveryPolicy)

Parameters:

durableQueues - the underlying Durable Queues provider

sendAndDontWaitErrorHandler - Exception handler that will handle errors that occur during CommandBus.sendAndDontWait(Object)/CommandBus.sendAndDontWait(Object, Duration). If this handler doesn't rethrow the exeption, then the message will not be retried by the underlying DurableQueues

interceptors - all the CommandBusInterceptor's

DurableLocalCommandBus

public DurableLocalCommandBus(DurableQueues durableQueues,
                              int parallelSendAndDontWaitConsumers,
                              CommandQueueNameSelector commandQueueNameSelector,
                              CommandQueueRedeliveryPolicyResolver commandQueueRedeliveryPolicyResolver,
                              SendAndDontWaitErrorHandler sendAndDontWaitErrorHandler,
                              CommandBusInterceptor... interceptors)

Create a new DurableLocalCommandBus

Parameters:

durableQueues - the underlying Durable Queues provider

parallelSendAndDontWaitConsumers - How many parallel DurableQueues consumers should listen for messages added using sendAndDontWait(Object)/sendAndDontWait(Object, Duration)

commandQueueNameSelector - {The strategy for selecting which DurableQueues QueueName to use for a given combination of command and command handler

commandQueueRedeliveryPolicyResolver - The strategy that allows the DurableLocalCommandBus to vary the RedeliveryPolicy per QueueName

sendAndDontWaitErrorHandler - Exception handler that will handle errors that occur during CommandBus.sendAndDontWait(Object)/CommandBus.sendAndDontWait(Object, Duration). If this handler doesn't rethrow the exeption, then the message will not be retried by the underlying DurableQueues

interceptors - all the CommandBusInterceptor's

Method Detail

builder

public static DurableLocalCommandBusBuilder builder()

Builder for a DurableLocalCommandBusBuilder

Returns:

builder for a DurableLocalCommandBusBuilder

sendAndDontWait

public <C> void sendAndDontWait(C command)

sendAndDontWait

public <C> void sendAndDontWait(C command,
                                Duration delayMessageDelivery)

getParallelSendAndDontWaitConsumers

public int getParallelSendAndDontWaitConsumers()

getCommandQueueNameSelector

public CommandQueueNameSelector getCommandQueueNameSelector()

getCommandQueueRedeliveryPolicyResolver

public CommandQueueRedeliveryPolicyResolver getCommandQueueRedeliveryPolicyResolver()