org.jivesoftware.smackx.xevent

Interface MessageEventRequestListener

All Known Implementing Classes:

DefaultMessageEventRequestListener

public interface MessageEventRequestListener

A listener that is fired anytime a message event request is received. Message event requests are received when the received message includes an extension like this:

 <x xmlns='jabber:x:event'>
  <offline/>
  <delivered/>
  <composing/>
 </x>
 

In this example you can see that the sender of the message requests to be notified when the user couldn't receive the message because he/she is offline, the message was delivered or when the receiver of the message is composing a reply.

Author:

Gaston Dombiak

Method Summary

Modifier and Type	Method and Description
void	composingNotificationRequested(String from, String packetID, MessageEventManager messageEventManager) Called when a request that the receiver of the message is composing a reply notification is received.
void	deliveredNotificationRequested(String from, String packetID, MessageEventManager messageEventManager) Called when a request for message delivered notification is received.
void	displayedNotificationRequested(String from, String packetID, MessageEventManager messageEventManager) Called when a request for message displayed notification is received.
void	offlineNotificationRequested(String from, String packetID, MessageEventManager messageEventManager) Called when a request that the receiver of the message is offline is received.

Method Detail

deliveredNotificationRequested

void deliveredNotificationRequested(String from,
                                    String packetID,
                                    MessageEventManager messageEventManager)
                             throws SmackException.NotConnectedException

Called when a request for message delivered notification is received.

Parameters:

from - the user that sent the notification.

packetID - the id of the message that was sent.

messageEventManager - the messageEventManager that fired the listener.

Throws:

SmackException.NotConnectedException

displayedNotificationRequested

void displayedNotificationRequested(String from,
                                    String packetID,
                                    MessageEventManager messageEventManager)

Called when a request for message displayed notification is received.

Parameters:

from - the user that sent the notification.

packetID - the id of the message that was sent.

messageEventManager - the messageEventManager that fired the listener.

composingNotificationRequested

void composingNotificationRequested(String from,
                                    String packetID,
                                    MessageEventManager messageEventManager)

Called when a request that the receiver of the message is composing a reply notification is received.

Parameters:

from - the user that sent the notification.

packetID - the id of the message that was sent.

messageEventManager - the messageEventManager that fired the listener.

offlineNotificationRequested

void offlineNotificationRequested(String from,
                                  String packetID,
                                  MessageEventManager messageEventManager)

Called when a request that the receiver of the message is offline is received.

Parameters:

from - the user that sent the notification.

packetID - the id of the message that was sent.

messageEventManager - the messageEventManager that fired the listener.