org.eclipse.ecf.telephony.call
Interface ICallSessionListener

public interface ICallSessionListener

Listener for receiving call session events from remotes.

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	handleCallSessionEvent(ICallSessionEvent event) Handle call session event listener.

Method Detail

handleCallSessionEvent

void handleCallSessionEvent(ICallSessionEvent event)

Handle call session event listener. Instances implementing this interface are provided during calls to ICallSessionContainerAdapter.sendCallRequest(org.eclipse.ecf.core.identity.ID, ICallSessionListener, java.util.Map) and allow the caller to be asynchronously notified of subsequent ICallSessionEvents.

Note that this method may be called by an arbitrary thread (not necessarily the UI-thread), so implementers must be prepared for this. Implementers of this method also should not block.

Parameters:

event - the event to handle. Will not be null.