org.eclipse.ecf.presence.roster
Interface IRosterSubscriptionListener

public interface IRosterSubscriptionListener

Listener for handling notifications of subscribe/unsubscribe requests.

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	handleSubscribed(ID fromID) Receive subscribed notification.
void	handleSubscribeRequest(ID fromID) Receive subscribe request.
void	handleUnsubscribed(ID fromID) Receive unsubscribed notification.

Method Detail

handleSubscribeRequest

void handleSubscribeRequest(ID fromID)

Receive subscribe request.

Parameters:

fromID - the sender of the subscribe request. Will not be null.

handleSubscribed

void handleSubscribed(ID fromID)

Receive subscribed notification.

Parameters:

fromID - the sender of the subscribed notification. Will not be null.

handleUnsubscribed

void handleUnsubscribed(ID fromID)

Receive unsubscribed notification.

Parameters:

fromID - the sender of the unsubscribed notification. Will not be null.