javax.telephony.media.async
Interface Async.DelegationListener

All Superinterfaces:

java.util.EventListener, MediaListener

Enclosing class:

Async

public static interface Async.DelegationListener

extends MediaListener

Listener for Async.DelegationEvents. Invoked when Async_Delegation methods complete.

Method Summary

void	onDelegateToServiceDone(MediaServiceEvent event) Indicates that async_delegateToService() has completed.
void	onReleaseDelegatedDone(MediaServiceEvent event) Indicates that async_releaseDelegated() has completed.
void	onRetrieveDone(MediaServiceEvent event) Indicates that async_retrieve() has completed.

Method Detail

onDelegateToServiceDone

public void onDelegateToServiceDone(MediaServiceEvent event)

Indicates that async_delegateToService() has completed.

If the MediaGroup was returned to this MediaService, then isBound() and isOwner() are true:

• If the MediaGroup was returned to this MediaService, but could not be reconfigured as it was when delegateToService() was called, then reconfigurationFailed() is true.
• If this MediaService used retrieve() then event.getQualifier.equals(q_Retrieved) and getMediaService().isBound() is true.

If the MediaGroup was returned to some other MediaService, then isBound() and isOwner() are false:

• If some older owner used retrieve() then event.getQualifier.equals(q_Retrieved), event.getRetrieveCause() is valid, and getMediaService().isBound() is false.
• If the most recent owner used releaseToTag() and the tags were not caught by this or any more recent owner, then event.getQualifier.equals(q_Released) and event.getReturnTags() is valid.
• If this MediaService released using releaseDelegated then event.getQualifier.equals(q_Removed)

Parameters:

event - a MediaServiceEvent that isDone().

onRetrieveDone

public void onRetrieveDone(MediaServiceEvent event)

Indicates that async_retrieve() has completed.

Parameters:

event - a MediaServiceEvent that may contain an Exception if async_retrieve() could not be accomplished.

onReleaseDelegatedDone

public void onReleaseDelegatedDone(MediaServiceEvent event)

Indicates that async_releaseDelegated() has completed.

Parameters:

event - a MediaServiceEvent that may contain an Exception if async_releaseDelegated() could not be accomplished.