org.mobicents.slee.resource.media.ra
Class MediaResourceAdaptor

java.lang.Object
  org.mobicents.slee.resource.media.ra.MediaResourceAdaptor

All Implemented Interfaces:

java.io.Serializable, javax.slee.resource.ResourceAdaptor, org.mobicents.mscontrol.MsConnectionListener, org.mobicents.mscontrol.MsLinkListener, org.mobicents.mscontrol.MsNotificationListener, org.mobicents.mscontrol.MsResourceListener, org.mobicents.mscontrol.MsSessionListener

public class MediaResourceAdaptor
extends java.lang.Object
implements javax.slee.resource.ResourceAdaptor, org.mobicents.mscontrol.MsConnectionListener, org.mobicents.mscontrol.MsResourceListener, org.mobicents.mscontrol.MsLinkListener, org.mobicents.mscontrol.MsSessionListener, org.mobicents.mscontrol.MsNotificationListener

The main Media Resource Adaptor class. Provides to SLEE services basic media features such as establishing a media stream with a remote client, playing a media file to the remote client and recording incoming media from the client.

Author:

torosvi, Ivelin Ivanov, Oleg Kulikov, amit.bhayani

See Also:

Serialized Form

Field Summary

java.util.Properties

properties

Fields inherited from interface javax.slee.resource.ResourceAdaptor

SBB_PROCESSED_EVENT

Constructor Summary

MediaResourceAdaptor()

Method Summary

void	activityEnded(javax.slee.resource.ActivityHandle activityHandle) Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 301 for further information.
void	activityUnreferenced(javax.slee.resource.ActivityHandle activityHandle) Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 301 for further information.
void	connectionCreated(org.mobicents.mscontrol.MsConnectionEvent evt)
void	connectionDisconnected(org.mobicents.mscontrol.MsConnectionEvent evt)
void	connectionFailed(org.mobicents.mscontrol.MsConnectionEvent evt)
void	connectionHalfOpen(org.mobicents.mscontrol.MsConnectionEvent evt)
void	connectionModeRecvOnly(org.mobicents.mscontrol.MsConnectionEvent evt)
void	connectionModeSendOnly(org.mobicents.mscontrol.MsConnectionEvent evt)
void	connectionModeSendRecv(org.mobicents.mscontrol.MsConnectionEvent evt)
void	connectionOpen(org.mobicents.mscontrol.MsConnectionEvent evt)
void	entityActivated() Implements javax.slee.resource.ResourceAdaptor The JSLEE v1.1 Specification does not include entityActivated().
void	entityCreated(javax.slee.resource.BootstrapContext bootstrapContext) Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 298 for further information.
void	entityDeactivated() implements javax.slee.resource.ResourceAdaptor The JSLEE v1.1 Specification does not include entityDeactivated().
void	entityDeactivating() Implements javax.slee.resource.ResourceAdaptor The JSLEE v1.1 Specification does not include entityDeactivating().
void	entityRemoved() Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 299 for further information.
void	eventProcessingFailed(javax.slee.resource.ActivityHandle handle, java.lang.Object event, int eventID, javax.slee.Address address, int flags, javax.slee.resource.FailureReason reason) Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 300 for further information.
void	eventProcessingSuccessful(javax.slee.resource.ActivityHandle handle, java.lang.Object event, int eventID, javax.slee.Address address, int flags) Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 300 for further information.
java.lang.Object	getActivity(javax.slee.resource.ActivityHandle activityHandle) Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 301 for further information.
javax.slee.resource.ActivityHandle	getActivityHandle(java.lang.Object activity) Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 301 for further information.
javax.slee.resource.Marshaler	getMarshaler() Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 302 for further information.
java.lang.Object	getSBBResourceAdaptorInterface(java.lang.String className) Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 302 for further information.
void	linkConnected(org.mobicents.mscontrol.MsLinkEvent evt)
void	linkCreated(org.mobicents.mscontrol.MsLinkEvent evt)
void	linkDisconnected(org.mobicents.mscontrol.MsLinkEvent evt)
void	linkFailed(org.mobicents.mscontrol.MsLinkEvent evt)
void	modeFullDuplex(org.mobicents.mscontrol.MsLinkEvent evt)
void	modeHalfDuplex(org.mobicents.mscontrol.MsLinkEvent evt)
void	queryLiveness(javax.slee.resource.ActivityHandle activityHandle) Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 301 for further information.
void	resourceCreated(org.mobicents.mscontrol.MsNotifyEvent notifyEvent)
void	resourceInvalid(org.mobicents.mscontrol.MsNotifyEvent notifyEvent)
void	serviceActivated(java.lang.String arg0) Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 303 for further information.
void	serviceDeactivated(java.lang.String arg0) Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 304 for further information.
void	serviceInstalled(java.lang.String serviceKey, int[] eventIDs, java.lang.String[] resourceOptions) Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 302 for further information.
void	serviceUninstalled(java.lang.String serviceKey) Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 303 for further information.
void	sessionActive(org.mobicents.mscontrol.MsSessionEvent evt)
void	sessionCreated(org.mobicents.mscontrol.MsSessionEvent evt)
void	sessionInvalid(org.mobicents.mscontrol.MsSessionEvent evt)
void	update(org.mobicents.mscontrol.MsNotifyEvent event)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

properties

public java.util.Properties properties

Constructor Detail

MediaResourceAdaptor

public MediaResourceAdaptor()

Method Detail

entityCreated

public void entityCreated(javax.slee.resource.BootstrapContext bootstrapContext)
                   throws javax.slee.resource.ResourceException

Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 298 for further information.
This method is called by the SLEE when a resource adaptor object instance is bootstrapped, either when a resource adaptor entity is created or during SLEE startup. The SLEE implementation will construct the resource adaptor object and then invoke the entityCreated method before any other operations can be invoked on the resource adaptor object.

Specified by:

entityCreated in interface javax.slee.resource.ResourceAdaptor

Throws:

javax.slee.resource.ResourceException

entityRemoved

public void entityRemoved()

Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 299 for further information.
This method is called by the SLEE when a resource adaptor object instance is being removed, either when a resource adaptor entity is deleted or during SLEE shutdown. When receiving this invocation the resource adaptor object is expected to close any system resources it has allocated.

Specified by:

entityRemoved in interface javax.slee.resource.ResourceAdaptor

entityActivated

public void entityActivated()
                     throws javax.slee.resource.ResourceException

Implements javax.slee.resource.ResourceAdaptor The JSLEE v1.1 Specification does not include entityActivated(). However, the API description of JSLEE v1.1 does include this method already. So, the documentation follows the code.
This method is called in context of project Mobicents in context of resource adaptor activation. More precisely, org.mobicents.slee.resource.ResourceAdaptorEntity.activate() calls this method entityActivated(). This method signals the resource adaptor the transition from state "INACTIVE" to state "ACTIVE".

Specified by:

entityActivated in interface javax.slee.resource.ResourceAdaptor

Throws:

javax.slee.resource.ResourceException

entityDeactivating

public void entityDeactivating()

Implements javax.slee.resource.ResourceAdaptor The JSLEE v1.1 Specification does not include entityDeactivating(). However, the API description of JSLEE v1.1 does include this method already. So, the documentation follows the code.
This method is called in context of project Mobicents in context of resource adaptor deactivation. More precisely, org.mobicents.slee.resource.ResourceAdaptorEntity.deactivate() calls this method entityDeactivating() PRIOR to invoking entityDeactivated(). This method signals the resource adaptor the transition from state "ACTIVE" to state "STOPPING".

Specified by:

entityDeactivating in interface javax.slee.resource.ResourceAdaptor

entityDeactivated

public void entityDeactivated()

implements javax.slee.resource.ResourceAdaptor The JSLEE v1.1 Specification does not include entityDeactivated(). However, the API description of JSLEE v1.1 does include this method already. So, the documentation follows the code.
This method is called in context of project Mobicents in context of resource adaptor deactivation. More precisely, org.mobicents.slee.resource.ResourceAdaptorEntity.deactivate() calls this method entityDeactivated(). The method call is done AFTER the call to entityDeactivating(). This method signals the resource adaptor the transition from state "STOPPING" to state "INACTIVE".

Specified by:

entityDeactivated in interface javax.slee.resource.ResourceAdaptor

eventProcessingSuccessful

public void eventProcessingSuccessful(javax.slee.resource.ActivityHandle handle,
                                      java.lang.Object event,
                                      int eventID,
                                      javax.slee.Address address,
                                      int flags)

Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 300 for further information.
The SLEE calls this method to inform the resource adaptor object that the specified event was processed successfully by the SLEE. An event is considered to be processed successfully if the SLEE has attempted to deliver the event to all interested SBBs.

Specified by:

eventProcessingSuccessful in interface javax.slee.resource.ResourceAdaptor

eventProcessingFailed

public void eventProcessingFailed(javax.slee.resource.ActivityHandle handle,
                                  java.lang.Object event,
                                  int eventID,
                                  javax.slee.Address address,
                                  int flags,
                                  javax.slee.resource.FailureReason reason)

Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 300 for further information.
The SLEE calls this method to inform the resource adaptor object that the specified event was processed unsuccessfully by the SLEE. Event processing can fail if, for example, the SLEE doesn�t have enough resource to process the event, a SLEE node fails during event processing or a system level failure prevents the SLEE from committing transactions.

Specified by:

eventProcessingFailed in interface javax.slee.resource.ResourceAdaptor

activityEnded

public void activityEnded(javax.slee.resource.ActivityHandle activityHandle)

Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 301 for further information.
The SLEE calls this method to inform the resource adaptor that the SLEE has completed activity end processing for the activity represented by the activity handle. The resource adaptor should release any resource related to this activity as the SLEE will not ask for it again.

Specified by:

activityEnded in interface javax.slee.resource.ResourceAdaptor

activityUnreferenced

public void activityUnreferenced(javax.slee.resource.ActivityHandle activityHandle)

Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 301 for further information.
The SLEE calls this method to inform the resource adaptor that the activity�s Activity Context object is no longer attached to any SBB entities and is no longer referenced by any SLEE Facilities. This enables the resource adaptor to implicitly end the Activity object.

Specified by:

activityUnreferenced in interface javax.slee.resource.ResourceAdaptor

queryLiveness

public void queryLiveness(javax.slee.resource.ActivityHandle activityHandle)

Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 301 for further information.
The SLEE calls this method to query if a specific activity belonging to this resource adaptor object is alive.

Specified by:

queryLiveness in interface javax.slee.resource.ResourceAdaptor

getActivity

public java.lang.Object getActivity(javax.slee.resource.ActivityHandle activityHandle)

Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 301 for further information.
The SLEE calls this method to get access to the underlying activity for an activity handle. The resource adaptor is expected to pass back a non-null object.

Specified by:

getActivity in interface javax.slee.resource.ResourceAdaptor

getActivityHandle

public javax.slee.resource.ActivityHandle getActivityHandle(java.lang.Object activity)

Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 301 for further information.
The SLEE calls this method to get an activity handle for an activity created by the underlying resource. This method is invoked by the SLEE when it needs to construct an activity context for an activity via an activity context interface factory method invoked by an SBB.

Specified by:

getActivityHandle in interface javax.slee.resource.ResourceAdaptor

getSBBResourceAdaptorInterface

public java.lang.Object getSBBResourceAdaptorInterface(java.lang.String className)

Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 302 for further information.
The SLEE calls this method to get access to the underlying resource adaptor interface that enables the SBB to invoke the resource adaptor, to send messages for example.

Specified by:

getSBBResourceAdaptorInterface in interface javax.slee.resource.ResourceAdaptor

getMarshaler

public javax.slee.resource.Marshaler getMarshaler()

Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 302 for further information.
The SLEE calls this method to get reference to the Marshaler object. The resource adaptor implements the Marshaler interface. The Marshaler is used by the SLEE to convert between object and distributable forms of events and event handles.

Specified by:

getMarshaler in interface javax.slee.resource.ResourceAdaptor

serviceInstalled

public void serviceInstalled(java.lang.String serviceKey,
                             int[] eventIDs,
                             java.lang.String[] resourceOptions)

Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 302 for further information.
The SLEE calls this method to signify to the resource adaptor that a service has been installed and is interested in a specific set of events. The SLEE passes an event filter which identifies a set of event types that services in the SLEE are interested in. The SLEE calls this method once a service is installed.

Specified by:

serviceInstalled in interface javax.slee.resource.ResourceAdaptor

serviceUninstalled

public void serviceUninstalled(java.lang.String serviceKey)

Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 303 for further information.
The SLEE calls this method to signify that a service has been un-installed in the SLEE. The event types associated to the service key are no longer of interest to a particular application.

Specified by:

serviceUninstalled in interface javax.slee.resource.ResourceAdaptor

serviceActivated

public void serviceActivated(java.lang.String arg0)

Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 303 for further information.
The SLEE calls this method to inform the resource adaptor that a service has been activated and is interested in the event types associated to the service key. The service must be installed with the resource adaptor via the serviceInstalled method before it can be activated.

Specified by:

serviceActivated in interface javax.slee.resource.ResourceAdaptor

serviceDeactivated

public void serviceDeactivated(java.lang.String arg0)

Implements javax.slee.resource.ResourceAdaptor Please refer to JSLEE v1.1 Specification, Early Draft Review Page 304 for further information.
The SLEE calls this method to inform the SLEE that a service has been deactivated and is no longer interested in the event types associated to the service key.

Specified by:

serviceDeactivated in interface javax.slee.resource.ResourceAdaptor

update

public void update(org.mobicents.mscontrol.MsNotifyEvent event)

Specified by:

update in interface org.mobicents.mscontrol.MsNotificationListener

Specified by:

update in interface org.mobicents.mscontrol.MsResourceListener

linkCreated

public void linkCreated(org.mobicents.mscontrol.MsLinkEvent evt)

Specified by:

linkCreated in interface org.mobicents.mscontrol.MsLinkListener

linkConnected

public void linkConnected(org.mobicents.mscontrol.MsLinkEvent evt)

Specified by:

linkConnected in interface org.mobicents.mscontrol.MsLinkListener

linkDisconnected

public void linkDisconnected(org.mobicents.mscontrol.MsLinkEvent evt)

Specified by:

linkDisconnected in interface org.mobicents.mscontrol.MsLinkListener

linkFailed

public void linkFailed(org.mobicents.mscontrol.MsLinkEvent evt)

Specified by:

linkFailed in interface org.mobicents.mscontrol.MsLinkListener

modeHalfDuplex

public void modeHalfDuplex(org.mobicents.mscontrol.MsLinkEvent evt)

Specified by:

modeHalfDuplex in interface org.mobicents.mscontrol.MsLinkListener

modeFullDuplex

public void modeFullDuplex(org.mobicents.mscontrol.MsLinkEvent evt)

Specified by:

modeFullDuplex in interface org.mobicents.mscontrol.MsLinkListener

connectionCreated

public void connectionCreated(org.mobicents.mscontrol.MsConnectionEvent evt)

Specified by:

connectionCreated in interface org.mobicents.mscontrol.MsConnectionListener

connectionHalfOpen

public void connectionHalfOpen(org.mobicents.mscontrol.MsConnectionEvent evt)

Specified by:

connectionHalfOpen in interface org.mobicents.mscontrol.MsConnectionListener

connectionOpen

public void connectionOpen(org.mobicents.mscontrol.MsConnectionEvent evt)

Specified by:

connectionOpen in interface org.mobicents.mscontrol.MsConnectionListener

connectionFailed

public void connectionFailed(org.mobicents.mscontrol.MsConnectionEvent evt)

Specified by:

connectionFailed in interface org.mobicents.mscontrol.MsConnectionListener

connectionDisconnected

public void connectionDisconnected(org.mobicents.mscontrol.MsConnectionEvent evt)

Specified by:

connectionDisconnected in interface org.mobicents.mscontrol.MsConnectionListener

connectionModeRecvOnly

public void connectionModeRecvOnly(org.mobicents.mscontrol.MsConnectionEvent evt)

Specified by:

connectionModeRecvOnly in interface org.mobicents.mscontrol.MsConnectionListener

connectionModeSendOnly

public void connectionModeSendOnly(org.mobicents.mscontrol.MsConnectionEvent evt)

Specified by:

connectionModeSendOnly in interface org.mobicents.mscontrol.MsConnectionListener

connectionModeSendRecv

public void connectionModeSendRecv(org.mobicents.mscontrol.MsConnectionEvent evt)

Specified by:

connectionModeSendRecv in interface org.mobicents.mscontrol.MsConnectionListener

sessionCreated

public void sessionCreated(org.mobicents.mscontrol.MsSessionEvent evt)

Specified by:

sessionCreated in interface org.mobicents.mscontrol.MsSessionListener

sessionActive

public void sessionActive(org.mobicents.mscontrol.MsSessionEvent evt)

Specified by:

sessionActive in interface org.mobicents.mscontrol.MsSessionListener

sessionInvalid

public void sessionInvalid(org.mobicents.mscontrol.MsSessionEvent evt)

Specified by:

sessionInvalid in interface org.mobicents.mscontrol.MsSessionListener

resourceCreated

public void resourceCreated(org.mobicents.mscontrol.MsNotifyEvent notifyEvent)

resourceInvalid

public void resourceInvalid(org.mobicents.mscontrol.MsNotifyEvent notifyEvent)