JSR-043: JTAPI-1.4

javax.telephony.media.provider
Class NullGroupProvider

java.lang.Object
  |
  +--javax.telephony.media.provider.Base_Owner
        |
        +--javax.telephony.media.provider.NullGroupProvider
All Implemented Interfaces:
MediaProvider, MPI.GroupProvider, MPI.Owner

public class NullGroupProvider
extends Base_Owner
implements MPI.GroupProvider

A GroupProvider implementation. This defines all the methods, but just done-ifies all the events with null values, without taking any action.

A working GroupProvider should find or create real objects and create Exceptions if necessary. This class can be used as a source code "template", one is not expected to use it as a base class.

Since:
JTAPI-1.4

Constructor Summary
NullGroupProvider()
           
 
Method Summary
 Base.BindToCallEvent bindAndConnect(Base.BindToCallEvent event, ConfigSpec cs, java.lang.String s1, java.lang.String s2)
          implements MPI.GroupProvider
 Base.BindToCallEvent bindToCall(Base.BindToCallEvent event, ConfigSpec cs, Call call)
           
 Base.BindEvent bindToServiceName(Base.BindEvent event, ConfigSpec cs, java.lang.String serviceName)
           
 Base.BindEvent bindToTerminal(Base.BindEvent event, ConfigSpec cs, Terminal t1)
           
 Base.BindEvent bindToTerminalName(Base.BindEvent event, ConfigSpec cs, java.lang.String s1)
           
 Base.Event cancelBindRequest(Base.Event event, Base.Event target)
          Cancel any ongoing Bind or Release.
 Base.DelegationEvent delegateToService(Base.DelegationEvent event, MPI.MediaGroup group, java.lang.String serviceName, int timeout, java.lang.String catchTags)
           
 ContainerService getContainerService()
          implements MediaProvider
 MediaService getMediaService()
          implements MediaProvider
 Base.ReleaseEvent release(Base.ReleaseEvent event, MPI.MediaGroup group)
           
 Base.DelegationEvent releaseDelegated(Base.DelegationEvent event, MPI.MediaGroup group)
           
 Base.ReleaseEvent releaseToDestroy(Base.ReleaseEvent event, MPI.MediaGroup group)
           
 Base.ReleaseEvent releaseToService(Base.ReleaseEvent event, MPI.MediaGroup group, java.lang.String serviceName, int timeout)
           
 Base.ReleaseEvent releaseToTag(Base.ReleaseEvent event, MPI.MediaGroup group, java.lang.String returnTags)
           
 Base.DelegationEvent retrieve(Base.DelegationEvent event, MPI.MediaGroup group, Symbol cause)
           
 
Methods inherited from class javax.telephony.media.provider.Base_Owner
addListener, onEventDone, removeListener, setExceptionHandler
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

NullGroupProvider

public NullGroupProvider()
Method Detail

getContainerService

public ContainerService getContainerService()
implements MediaProvider

getMediaService

public MediaService getMediaService()
implements MediaProvider
Specified by:
getMediaService in interface MediaProvider
Following copied from interface: javax.telephony.media.MediaProvider
Returns:
an unbound MediaService object.

bindAndConnect

public Base.BindToCallEvent bindAndConnect(Base.BindToCallEvent event,
                                           ConfigSpec cs,
                                           java.lang.String s1,
                                           java.lang.String s2)
implements MPI.GroupProvider
Specified by:
bindAndConnect in interface MPI.GroupProvider

bindToCall

public Base.BindToCallEvent bindToCall(Base.BindToCallEvent event,
                                       ConfigSpec cs,
                                       Call call)
Specified by:
bindToCall in interface MPI.GroupProvider

bindToTerminalName

public Base.BindEvent bindToTerminalName(Base.BindEvent event,
                                         ConfigSpec cs,
                                         java.lang.String s1)
Specified by:
bindToTerminalName in interface MPI.GroupProvider

bindToTerminal

public Base.BindEvent bindToTerminal(Base.BindEvent event,
                                     ConfigSpec cs,
                                     Terminal t1)
Specified by:
bindToTerminal in interface MPI.GroupProvider

bindToServiceName

public Base.BindEvent bindToServiceName(Base.BindEvent event,
                                        ConfigSpec cs,
                                        java.lang.String serviceName)
Specified by:
bindToServiceName in interface MPI.GroupProvider

delegateToService

public Base.DelegationEvent delegateToService(Base.DelegationEvent event,
                                              MPI.MediaGroup group,
                                              java.lang.String serviceName,
                                              int timeout,
                                              java.lang.String catchTags)
Specified by:
delegateToService in interface MPI.GroupProvider

retrieve

public Base.DelegationEvent retrieve(Base.DelegationEvent event,
                                     MPI.MediaGroup group,
                                     Symbol cause)
Specified by:
retrieve in interface MPI.GroupProvider

releaseDelegated

public Base.DelegationEvent releaseDelegated(Base.DelegationEvent event,
                                             MPI.MediaGroup group)
Specified by:
releaseDelegated in interface MPI.GroupProvider

releaseToService

public Base.ReleaseEvent releaseToService(Base.ReleaseEvent event,
                                          MPI.MediaGroup group,
                                          java.lang.String serviceName,
                                          int timeout)
Specified by:
releaseToService in interface MPI.GroupProvider

release

public Base.ReleaseEvent release(Base.ReleaseEvent event,
                                 MPI.MediaGroup group)
Specified by:
release in interface MPI.GroupProvider

releaseToTag

public Base.ReleaseEvent releaseToTag(Base.ReleaseEvent event,
                                      MPI.MediaGroup group,
                                      java.lang.String returnTags)
Specified by:
releaseToTag in interface MPI.GroupProvider

releaseToDestroy

public Base.ReleaseEvent releaseToDestroy(Base.ReleaseEvent event,
                                          MPI.MediaGroup group)
Specified by:
releaseToDestroy in interface MPI.GroupProvider

cancelBindRequest

public Base.Event cancelBindRequest(Base.Event event,
                                    Base.Event target)
Cancel any ongoing Bind or Release.

Note: A real implementation should undertake to stop any transactions that are in progress in association with that event.

Specified by:
cancelBindRequest in interface MPI.GroupProvider
Parameters:
source - the MediaService "source" of the return Event.
target - a Base.BindEvent or Base.ReleaseEvent depending on which operation is being cancelled
Returns:
a done Async.Event which has no specified EventID or callback.

JSR-043: JTAPI-1.4

Send comments to: JSR-43@ectf.org