ch.ecma.csta.binding
Class DetachMediaService

java.lang.Object
  ch.ecma.csta.CastorObject
      ch.ecma.csta.binding.DetachMediaService

All Implemented Interfaces:

java.io.Serializable

public class DetachMediaService
extends ch.ecma.csta.CastorObject
implements java.io.Serializable

Not supported.

Detaches a previously attached media service instance from a call. This request releases a previously established association (binding) between a connection and a media service. If a media access device was added to the call when the media service instance was attached and that media access device is no longer needed, then the media access device is removed (or more specific, cleared) from the call.

There are two cases for the Detach Media Service service request:

1. Case A: A media access device (D3) was previously connected into the call using the AttachMediaService service. In this case the media access device is removed from the call by this service. See ECMA 269, section 19.1.2, Figure 19-1 "Detach Media Service (Case A)". Figure 19-1 is an example where a media access device that was conferenced into a call is detached from a call.
2. Case B: The media service instance was directly bound to an existing connection (D1C1) in the call. In this case this detaching device remains in the call after the service request. See ECMA 269, section 19.1.2, Figure 19-2 "Detach Media Service (Case B)"

See ECMA 269, section 19.1.2, Table 19-8 "Detach Media Service - Connection State Transitions (Case A)" and Table 19-9 "Detach Media Service - Connection State Transitions (Case B)" for tables describing the Connection State Transitions for this service.

See ECMA 269, section 19.1.2, Table 19-10 "Detach Media Service - Device-Type Monitoring Event Sequences (Case A)" and Table 19-11 "Detach Media Service - Device-Type Monitoring Event Sequences (Case B)" for tables describing the Device-Type Monitoring Event Sequences for this service.

See ECMA 269, section 19.1.2, Table 19-12 "Detach Media Service - Call-Type Monitoring Event Sequences (Case A)" and Table Table 19-13 Detach Media Service - Call-Type Monitoring Event Sequences (Case B)" for tables describing the Call-Type Monitoring Event Sequences for this service.

Version:

$Revision$ $Date$

See Also:

Serialized Form

Constructor Summary

DetachMediaService()

Method Summary

boolean	equals(java.lang.Object obj) Note: hashCode() has not been overriden
ConnectionID	getConnection() Returns the value of field 'connection'.
CSTACommonArguments	getExtensions() Returns the value of field 'extensions'.
MediaServiceType	getMediaServiceType() Returns the value of field 'mediaServiceType'.
boolean	isValid() Method isValid
void	marshal(org.xml.sax.ContentHandler handler) Method marshal
void	marshal(java.io.Writer out) Method marshal
void	setConnection(ConnectionID connection) Sets the value of field 'connection'.
void	setExtensions(CSTACommonArguments extensions) Sets the value of field 'extensions'.
void	setMediaServiceType(MediaServiceType mediaServiceType) Sets the value of field 'mediaServiceType'.
static DetachMediaService	unmarshalDetachMediaService(java.io.Reader reader) Method unmarshalDetachMediaService
void	validate() Method validate

Methods inherited from class ch.ecma.csta.CastorObject

getOldSessionID, hashCode, setOldSessionID, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

DetachMediaService

public DetachMediaService()

Method Detail

equals

public boolean equals(java.lang.Object obj)

Note: hashCode() has not been overriden

Overrides:

equals in class ch.ecma.csta.CastorObject

Parameters:

obj -

Returns:

boolean

getConnection

public ConnectionID getConnection()

Returns the value of field 'connection'. The field 'connection' has the following description: Specifies the connection at the media access device, if used. Otherwise, specifies the connection at the detaching device. Mandatory.

Returns:

ConnectionID

getExtensions

public CSTACommonArguments getExtensions()

Returns the value of field 'extensions'.

Returns:

CSTACommonArguments

getMediaServiceType

public MediaServiceType getMediaServiceType()

Returns the value of field 'mediaServiceType'. The field 'mediaServiceType' has the following description: Specifies the requested media service type to detach. Mandatory.

Returns:

MediaServiceType

isValid

public boolean isValid()

Method isValid

Returns:

boolean

marshal

public void marshal(java.io.Writer out)
             throws org.exolab.castor.xml.MarshalException,
                    org.exolab.castor.xml.ValidationException

Method marshal

Parameters:

out -

Throws:

org.exolab.castor.xml.MarshalException

org.exolab.castor.xml.ValidationException

marshal

public void marshal(org.xml.sax.ContentHandler handler)
             throws java.io.IOException,
                    org.exolab.castor.xml.MarshalException,
                    org.exolab.castor.xml.ValidationException

Method marshal

Parameters:

handler -

Throws:

java.io.IOException

org.exolab.castor.xml.MarshalException

org.exolab.castor.xml.ValidationException

setConnection

public void setConnection(ConnectionID connection)

Sets the value of field 'connection'. The field 'connection' has the following description: Specifies the connection at the media access device, if used. Otherwise, specifies the connection at the detaching device. Mandatory.

Parameters:

connection - the value of field 'connection'.

setExtensions

public void setExtensions(CSTACommonArguments extensions)

Sets the value of field 'extensions'.

Parameters:

extensions - the value of field 'extensions'.

setMediaServiceType

public void setMediaServiceType(MediaServiceType mediaServiceType)

Sets the value of field 'mediaServiceType'. The field 'mediaServiceType' has the following description: Specifies the requested media service type to detach. Mandatory.

Parameters:

mediaServiceType - the value of field 'mediaServiceType'

unmarshalDetachMediaService

public static DetachMediaService unmarshalDetachMediaService(java.io.Reader reader)
                                                      throws org.exolab.castor.xml.MarshalException,
                                                             org.exolab.castor.xml.ValidationException

Method unmarshalDetachMediaService

Parameters:

reader -

Returns:

DetachMediaService

Throws:

org.exolab.castor.xml.MarshalException

org.exolab.castor.xml.ValidationException

validate

public void validate()
              throws org.exolab.castor.xml.ValidationException

Method validate

Throws:

org.exolab.castor.xml.ValidationException