rocks.xmpp.extensions.receipts

Class MessageDeliveryReceiptsManager

java.lang.Object

rocks.xmpp.core.session.Manager

rocks.xmpp.extensions.receipts.MessageDeliveryReceiptsManager

public final class MessageDeliveryReceiptsManager
extends Manager

The implementation of XEP-0184: Message Delivery Receipts.

This manager automatically adds message delivery requests to outbound messages, if enabled. If a message has been received by the recipient, registered listeners will be notified about the receipt.

If an inbound message contains a delivery receipt request, a receipt is automatically sent back to the requesting entity.

Note that messages must contain an id, in order to track receipts. If a message does not contain an id, requests won't be added.

Code sample

 
 MessageDeliveryReceiptsManager messageDeliveryReceiptsManager = xmppSession.getManager(MessageDeliveryReceiptsManager.class);
 messageDeliveryReceiptsManager.addMessageDeliveredListener(e -> System.out.println("Message delivered: " + e.getMessageId()));
 
 

Method Summary

Modifier and Type	Method and Description
void	addMessageDeliveredListener(Consumer<MessageDeliveredEvent> messageDeliveredListener) Adds a message delivered listener, which allows to listen for delivered messages.
void	removeMessageDeliveredListener(Consumer<MessageDeliveredEvent> messageDeliveredListener) Removes a previously added message delivered listener.
void	setMessageFilter(Predicate<Message> messageFilter) Outbound messages, which pass the filter automatically request a receipt, i.e. a <request/> extension.

Methods inherited from class rocks.xmpp.core.session.Manager

isEnabled, setEnabled

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

addMessageDeliveredListener

public void addMessageDeliveredListener(Consumer<MessageDeliveredEvent> messageDeliveredListener)

Adds a message delivered listener, which allows to listen for delivered messages.

Parameters:

messageDeliveredListener - The listener.

See Also:

removeMessageDeliveredListener(Consumer)

removeMessageDeliveredListener

public void removeMessageDeliveredListener(Consumer<MessageDeliveredEvent> messageDeliveredListener)

Removes a previously added message delivered listener.

Parameters:

messageDeliveredListener - The listener.

See Also:

addMessageDeliveredListener(Consumer)

setMessageFilter

public void setMessageFilter(Predicate<Message> messageFilter)

Outbound messages, which pass the filter automatically request a receipt, i.e. a <request/> extension.

Parameters:

messageFilter - The message filter.