io.nats.streaming

Interface AckHandler

public interface AckHandler

A callback interface for handling NATS Streaming message acknowledgements.

Method Summary

Modifier and Type	Method and Description
void	onAck(java.lang.String nuid, java.lang.Exception ex) This method is called when a message has been acknowledged by the STAN server, or if an error has occurred during the publish operations.
default void	onAck(java.lang.String nuid, java.lang.String subject, byte[] data, java.lang.Exception ex) New version of onAck that includes the message that failed so that applications can more easily resend it.

Method Detail

onAck

void onAck(java.lang.String nuid,
           java.lang.Exception ex)

This method is called when a message has been acknowledged by the STAN server, or if an error has occurred during the publish operations. Processes the message acknowledgement ( NUID ), along with any error that was encountered. onAck with a message is now called, with the default behavior of calling this version. Not deprecated yet to avoid multiple warnings, will deprecate in the future.

Parameters:

nuid - the message NUID

ex - any exception that was encountered

onAck

default void onAck(java.lang.String nuid,
                   java.lang.String subject,
                   byte[] data,
                   java.lang.Exception ex)

New version of onAck that includes the message that failed so that applications can more easily resend it. Added in 2.2.0 as a default method to avoid breaking existing applications.

Parameters:

nuid - the message NUID

subject - the subject the failed message was sent to

data - the data passed into publish, this is the same data passed to publish if the byte array is reused in application code, it will be corrupted here in the case where no ack handler is passed to publish the data will be null but since there is no ack handler it won't matter except to allow garbage collection.

ex - any exception that was encountered