com.neeve.toa.opt

Interface DelayedAcknowledgmentController.DelayedAcknowledger

Enclosing interface:

DelayedAcknowledgmentController

public static interface DelayedAcknowledgmentController.DelayedAcknowledger

A delayed acknowledger handle.

An application may create a delayed acknowldeger via DelayedAcknowledgmentController.delayAcknowledgment(). Doing so suspends acknowledgment of the inbound message being processed until acknowledge() is called in which case the inbound messages acknowledgment is resumed.

Method Summary

Modifier and Type	Method and Description
void	acknowledge() Called to successfully release a delayed acknowledgemnt.
void	acknowledge(Exception status) Called to acknowledge processing done by an ExecutorBusProcessor.

Method Detail

acknowledge

void acknowledge()

Called to successfully release a delayed acknowledgemnt.

When called this method allows the underlying transaction to be completed which ultimately results in that transaction's inbound events / messages being acknowledged upstream. A failure to acknowledge the message will ultimately result in the AepEngine's transaction pipeline stalling so it is vital that this method is ultimately called.

This method may be called by any thread but may only be called once. DelayedAcknowledger are pooled, and the act of calling acknowledge returns the acknowledger to its pool. An application must not call this method more than once and should release its reference to this object after calling acknowledge.

This method is equivalent to calling acknowledge(null).

acknowledge

void acknowledge(Exception status)

Called to acknowledge processing done by an ExecutorBusProcessor. Calling this method with a non null exception indicates that processing did not complete successfully. This may result in the execution bus shutting down if it is so configured.

This method may be called by any thread but may only be called once. The executor bus will pool Acknowledger instances and the act of calling acknowledge returns the acknowledger to its pool.