org.eclipse.ecf.presence.chatroom
Interface IChatRoomInvitationListener


public interface IChatRoomInvitationListener

Invitation listener for handling asynchronous chat room invitation events. Instances implementing this interface must be registered via the IChatRoomManager.addInvitationListener(IChatRoomInvitationListener)

See Also:

Note these methods will be called asynchronously when notifications of remote changes are received by the provider implementation code. The provider is free to call the methods below with an arbitrary thread, so the implementation of these methods must be appropriately prepared.

For example, if the code implementing any of these methods must interact with user interface code, then it should use code such as the following to execute on the SWT UI thread:
 	Display.getDefault().asyncExec(new Runnable() {
 		public void run() {
 		... UI code here
 		}
 	});
 
Further, the code in the implementations of these methods should not block via I/O operations or blocking UI calls.

Method Summary
 void handleInvitationReceived(ID roomID, ID from, java.lang.String subject, java.lang.String body)
          Handle notification of a received invitation to join a chat room.
 

Method Detail

handleInvitationReceived

void handleInvitationReceived(ID roomID,
                              ID from,
                              java.lang.String subject,
                              java.lang.String body)
Handle notification of a received invitation to join a chat room. This method will be called by some thread when an invitation is received by this user account to join a chat room

Parameters:
roomID - the room id associated with the invitation. Will not be null.
from - the id of the sender. Will not be null.
subject - a subject for the invitation. May be null.
body - a message body for the invitation. May be null.