Module dk.cloudcreate.essentials.components.foundation

Package dk.cloudcreate.essentials.components.foundation.messaging.eip.store_and_forward

Class Inboxes.DurableQueueBasedInboxes.DurableQueueBasedInbox

java.lang.Object

dk.cloudcreate.essentials.components.foundation.messaging.eip.store_and_forward.Inboxes.DurableQueueBasedInboxes.DurableQueueBasedInbox

All Implemented Interfaces:

Inbox

Enclosing class:

Inboxes.DurableQueueBasedInboxes

public class Inboxes.DurableQueueBasedInboxes.DurableQueueBasedInbox
extends Object
implements Inbox

Field Summary

Fields

Modifier and Type	Field	Description
InboxConfig	config
QueueName	inboxQueueName

Constructor Summary

Constructors

Constructor	Description
DurableQueueBasedInbox(InboxConfig config)
DurableQueueBasedInbox(InboxConfig config, Consumer<Message> messageConsumer)

Method Summary

Modifier and Type	Method	Description
void	addMessageReceived(Message message)	Register or add a message that has been received This message will be stored durably (without any duplication check) in connection with the currently active UnitOfWork (or a new UnitOfWork will be created in case no there isn't an active UnitOfWork). The message will be delivered asynchronously to the message consumer
Inbox	consume(Consumer<Message> messageConsumer)	Start consuming messages from the Outbox using the provided message consumer. Only needs to be called if the instance was created without a message consumer
long	getNumberOfUndeliveredMessages()	Get the number of message received that haven't been processed yet (or successfully processed) by the message consumer
boolean	hasAMessageConsumer()	Has the instance been created with a Message consumer or has Inbox.consume(Consumer) been called
boolean	isConsumingMessages()	Is the provided Message consumer consuming messages from the Outbox
InboxName	name()	The name of the inbox
void	stopConsuming()	Stop consuming messages from the Outbox.
String	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.components.foundation.messaging.eip.store_and_forward.Inbox

addMessageReceived, addMessageReceived

Field Detail

inboxQueueName

public final QueueName inboxQueueName

config

public final InboxConfig config

Constructor Detail

DurableQueueBasedInbox

public DurableQueueBasedInbox(InboxConfig config,
                              Consumer<Message> messageConsumer)

DurableQueueBasedInbox

public DurableQueueBasedInbox(InboxConfig config)

Method Detail

consume

public Inbox consume(Consumer<Message> messageConsumer)

Description copied from interface: Inbox

Start consuming messages from the Outbox using the provided message consumer.
Only needs to be called if the instance was created without a message consumer

If an OrderedMessage is delivered via an Inbox using a FencedLock (such as Inboxes.durableQueueBasedInboxes(DurableQueues, FencedLockManager)) to coordinate message consumption, then you can find the FencedLock.getCurrentToken() of the consumer in the Message.getMetaData() under key MessageMetaData.FENCED_LOCK_TOKEN

Specified by:

consume in interface Inbox

Parameters:

messageConsumer - the message consumer. See PatternMatchingMessageHandler

Returns:

this inbox instance

hasAMessageConsumer

public boolean hasAMessageConsumer()

Description copied from interface: Inbox

Has the instance been created with a Message consumer or has Inbox.consume(Consumer) been called

Specified by:

hasAMessageConsumer in interface Inbox

Returns:

Has the instance been created with a Message consumer or has Inbox.consume(Consumer) been called

isConsumingMessages

public boolean isConsumingMessages()

Description copied from interface: Inbox

Is the provided Message consumer consuming messages from the Outbox

Specified by:

isConsumingMessages in interface Inbox

Returns:

Is the provided Message consumer consuming messages from the Outbox

stopConsuming

public void stopConsuming()

Description copied from interface: Inbox

Stop consuming messages from the Outbox. Calling this method will remove the message consumer and to resume message consumption you need to call Inbox.consume(Consumer)

Specified by:

stopConsuming in interface Inbox

name

public InboxName name()

Description copied from interface: Inbox

The name of the inbox

Specified by:

name in interface Inbox

Returns:

the name of the inbox

addMessageReceived

public void addMessageReceived(Message message)

Description copied from interface: Inbox

Register or add a message that has been received
This message will be stored durably (without any duplication check) in connection with the currently active UnitOfWork (or a new UnitOfWork will be created in case no there isn't an active UnitOfWork).
The message will be delivered asynchronously to the message consumer

Specified by:

addMessageReceived in interface Inbox

Parameters:

message - the message

See Also:

OrderedMessage

getNumberOfUndeliveredMessages

public long getNumberOfUndeliveredMessages()

Description copied from interface: Inbox

Get the number of message received that haven't been processed yet (or successfully processed) by the message consumer

Specified by:

getNumberOfUndeliveredMessages in interface Inbox

Returns:

the number of message received that haven't been processed yet (or successfully processed) by the message consumer

toString

public String toString()

Overrides:

toString in class Object