org.jvoicexml.xml.ccxml

Class Join

java.lang.Object

org.jvoicexml.xml.AbstractXmlNode

org.jvoicexml.xml.ccxml.Join

All Implemented Interfaces:

CcxmlNode, XmlNode, org.w3c.dom.Node

public final class Join
extends AbstractXmlNode

A CCXML document can attempt to create a bridge between any two connections, conferences, or dialogs using <join>. This element instructs the implementation to bridge the connections, conferences, or dialogs specified using the id1 and id2 attributes in accordance with media options specified by the other attributes of <join>. The successful execution of<join> will result in the generation of a conference.joined event. If for any reason the implementation is unable to create the bridge using the specified options it MUST fail with a error.conference.join event. Joining two objects that are owned by separate CCXML sessions will result in the generation of a conference.joined to each of the sessions. However if the implementation is unable to join the objects an error.conference.join will only be sent to the session issued the <join>.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ATTRIBUTE_AUTOINPUTGAIN An ECMAScript Boolean expression that tells the conference mixer if it should use AGC to determine the input gain for a leg.
static java.lang.String	ATTRIBUTE_AUTOOUTPUTGAIN An ECMAScript boolean expression that tells the conference mixer if it should use AGC to determine the output gain for a leg.
static java.lang.String	ATTRIBUTE_DTMFCLAMP An ECMAScript Boolean expression that tells the conference mixer if it should attempt to remove detected DTMF tones.
static java.lang.String	ATTRIBUTE_DUPLEX An ECMAScript expression that returns a character string equal to "half" or "full", which defines the direction of the media flow between id1 resource and id2 resource.
static java.lang.String	ATTRIBUTE_ENTERTONE An ECMAScript expression that returns a character string that is used to play a tone or a custom wav file to the conference participants when another caller joins.
static java.lang.String	ATTRIBUTE_EXITTONE An ECMAScript expression that returns a character string that is used to play a tone or a custom wav file to the conference participants when another caller exits.
static java.lang.String	ATTRIBUTE_HINTS The ECMAScript object returned contains information which may be used by the implementing platform or passed to the network when the two specified Connections, Dialogs or Conferences (id1 and id2) are joined.
static java.lang.String	ATTRIBUTE_ID1 The ECMAScript object returned contains information which may be used by the implementing platform or passed to the network when the two specified Connections, Dialogs or Conferences (id1 and id2) are joined.
static java.lang.String	ATTRIBUTE_ID2 The ECMAScript object returned contains information which may be used by the implementing platform or passed to the network when the two specified Connections, Dialogs or Conferences (id1 and id2) are joined.
protected static java.util.ArrayList<java.lang.String>	ATTRIBUTE_NAMES Supported attribute names for this node.
static java.lang.String	ATTRIBUTE_TONECLAMP An ECMAScript Boolean expression that tells the conference mixer if it should attempt to remove loud single-frequency tones from the audio stream.
static java.lang.String	TAG_NAME Name of the tag.

Fields inherited from interface org.w3c.dom.Node

ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

Constructor Summary

Constructors

Constructor and Description
Join() Construct a new join object without a node.

Method Summary

Modifier and Type	Method and Description
protected boolean	canContainChild(java.lang.String tagName) Can the specified sub-tag be contained within this node?
java.util.Collection<java.lang.String>	getAttributeNames() Returns a collection of permitted attribute names for the node.
java.lang.String	getAutoinputgain() Retrieve the autoinputgain attribute.
java.lang.String	getAutooutputgain() Retrieve the autooutputgain attribute.
java.lang.String	getDtmfclamp() Retrieve the dtmfclamp attribute.
java.lang.String	getDuplex() Retrieve the duplex attribute.
java.lang.String	getEntertone() Retrieve the entertone attribute.
java.lang.String	getExittone() Retrieve the exittone attribute.
java.lang.String	getHints() Retrieve the hints attribute.
java.lang.String	getId1() Retrieve the id1 attribute.
java.lang.String	getId2() Retrieve the id2 attribute.
java.lang.String	getTagName() Get the name of the tag for the derived node.
java.lang.String	getToneclamp() Retrieve the toneclamp attribute.
XmlNode	newInstance(org.w3c.dom.Node n, XmlNodeFactory<? extends XmlNode> factory) Create a new instance for the given node.
void	setAutoinputgain(java.lang.String autoinputgain) Set the autoinputgain attribute.
void	setAutooutputgain(java.lang.String autooutputgain) Set the autooutputgain attribute.
void	setDtmfclamp(java.lang.String dtmfclamp) Set the dtmfclamp attribute.
void	setDuplex(java.lang.String duplex) Set the duplex attribute.
void	setEntertone(java.lang.String entertone) Set the entertone attribute.
void	setExittone(java.lang.String exittone) Set the exittone attribute.
void	setHints(java.lang.String hints) Set the hints attribute.
void	setId1(java.lang.String id1) Set the id1 attribute.
void	setId2(java.lang.String id2) Set the id2 attribute.
void	setToneclamp(java.lang.String toneclamp) Set the toneclamp attribute.

Methods inherited from class org.jvoicexml.xml.AbstractXmlNode

addChild, addChild, appendChild, appendChild, appendDeepClone, cloneNode, compareDocumentPosition, equals, getAttribute, getAttributes, getBaseURI, getChildNodes, getChildNodes, getChildren, getDefinedAttributeNames, getFeature, getFirstChild, getFirstLevelTextContent, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNode, getNodeFactory, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getOwnerXmlDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttribute, hasAttributes, hasChildNodes, hashCode, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setAttribute, setNodeValue, setPrefix, setTextContent, setUserData, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.jvoicexml.xml.XmlNode

addChild, getAttribute, getChildNodes, getChildren, getNode, setAttribute

Methods inherited from interface org.w3c.dom.Node

appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData

Field Detail

TAG_NAME

public static final java.lang.String TAG_NAME

Name of the tag.

See Also:

Constant Field Values

ATTRIBUTE_AUTOINPUTGAIN

public static final java.lang.String ATTRIBUTE_AUTOINPUTGAIN

An ECMAScript Boolean expression that tells the conference mixer if it should use AGC to determine the input gain for a leg. If a platform does not support AGC, it should ignore this attribute.

See Also:

Constant Field Values

ATTRIBUTE_AUTOOUTPUTGAIN

public static final java.lang.String ATTRIBUTE_AUTOOUTPUTGAIN

An ECMAScript boolean expression that tells the conference mixer if it should use AGC to determine the output gain for a leg. If a platform does not support AGC, it should ignore this attribute.

See Also:

Constant Field Values

ATTRIBUTE_DTMFCLAMP

public static final java.lang.String ATTRIBUTE_DTMFCLAMP

An ECMAScript Boolean expression that tells the conference mixer if it should attempt to remove detected DTMF tones. If a platform does not support removal of DTMF tones, it should ignore this attribute.

See Also:

Constant Field Values

ATTRIBUTE_DUPLEX

public static final java.lang.String ATTRIBUTE_DUPLEX

An ECMAScript expression that returns a character string equal to "half" or "full", which defines the direction of the media flow between id1 resource and id2 resource. Refer to the discussion of bridging in Section 10.4 . The duplex attribute determines whether the join will establish a half-duplex (unidirectional) or full-duplex (bi-directional) bridge.

See Also:

Constant Field Values

ATTRIBUTE_ENTERTONE

public static final java.lang.String ATTRIBUTE_ENTERTONE

An ECMAScript expression that returns a character string that is used to play a tone or a custom wav file to the conference participants when another caller joins.

See Also:

Constant Field Values

ATTRIBUTE_EXITTONE

public static final java.lang.String ATTRIBUTE_EXITTONE

An ECMAScript expression that returns a character string that is used to play a tone or a custom wav file to the conference participants when another caller exits.

See Also:

Constant Field Values

ATTRIBUTE_HINTS

public static final java.lang.String ATTRIBUTE_HINTS

The ECMAScript object returned contains information which may be used by the implementing platform or passed to the network when the two specified Connections, Dialogs or Conferences (id1 and id2) are joined. This information may consist of protocol-specific parameters. Note: The meaning of these hints is specific to the implementing platform and the underlying protocol.

See Also:

Constant Field Values

ATTRIBUTE_ID1

public static final java.lang.String ATTRIBUTE_ID1

The ECMAScript object returned contains information which may be used by the implementing platform or passed to the network when the two specified Connections, Dialogs or Conferences (id1 and id2) are joined. This information may consist of protocol-specific parameters. Note: The meaning of these hints is specific to the implementing platform and the underlying protocol.

See Also:

Constant Field Values

ATTRIBUTE_ID2

public static final java.lang.String ATTRIBUTE_ID2

The ECMAScript object returned contains information which may be used by the implementing platform or passed to the network when the two specified Connections, Dialogs or Conferences (id1 and id2) are joined. This information may consist of protocol-specific parameters. Note: The meaning of these hints is specific to the implementing platform and the underlying protocol.

See Also:

Constant Field Values

ATTRIBUTE_TONECLAMP

public static final java.lang.String ATTRIBUTE_TONECLAMP

An ECMAScript Boolean expression that tells the conference mixer if it should attempt to remove loud single-frequency tones from the audio stream. If a platform does not support removal of tones, it should ignore this attribute.

See Also:

Constant Field Values

ATTRIBUTE_NAMES

protected static final java.util.ArrayList<java.lang.String> ATTRIBUTE_NAMES

Supported attribute names for this node.

Constructor Detail

Join

public Join()

Construct a new join object without a node.

This is necessary for the node factory.

See Also:

CcxmlNodeFactory

Method Detail

getTagName

public java.lang.String getTagName()

Get the name of the tag for the derived node.

Returns:

name of the tag.

newInstance

public XmlNode newInstance(org.w3c.dom.Node n,
                           XmlNodeFactory<? extends XmlNode> factory)

Create a new instance for the given node.

Each XmlNode can serve as a prototype in a XmlNodeFactory to produce a collection of child nodes. Factories can then use the prototype pattern to produce new nodes.

Parameters:

n - The node to encapsulate.

factory - the factroy that calls this method.

Returns:

The new instance.

See Also:

XmlNodeFactory

getAutoinputgain

public java.lang.String getAutoinputgain()

Retrieve the autoinputgain attribute.

Returns:

Value of the autoinputgain attribute.

See Also:

ATTRIBUTE_AUTOINPUTGAIN

setAutoinputgain

public void setAutoinputgain(java.lang.String autoinputgain)

Set the autoinputgain attribute.

Parameters:

autoinputgain - Value of the autoinputgain attribute.

See Also:

ATTRIBUTE_AUTOINPUTGAIN

getAutooutputgain

public java.lang.String getAutooutputgain()

Retrieve the autooutputgain attribute.

Returns:

Value of the autooutputgain attribute.

See Also:

ATTRIBUTE_AUTOOUTPUTGAIN

setAutooutputgain

public void setAutooutputgain(java.lang.String autooutputgain)

Set the autooutputgain attribute.

Parameters:

autooutputgain - Value of the autooutputgain attribute.

See Also:

ATTRIBUTE_AUTOOUTPUTGAIN

getDtmfclamp

public java.lang.String getDtmfclamp()

Retrieve the dtmfclamp attribute.

Returns:

Value of the dtmfclamp attribute.

See Also:

ATTRIBUTE_DTMFCLAMP

setDtmfclamp

public void setDtmfclamp(java.lang.String dtmfclamp)

Set the dtmfclamp attribute.

Parameters:

dtmfclamp - Value of the dtmfclamp attribute.

See Also:

ATTRIBUTE_DTMFCLAMP

getDuplex

public java.lang.String getDuplex()

Retrieve the duplex attribute.

Returns:

Value of the duplex attribute.

See Also:

ATTRIBUTE_DUPLEX

setDuplex

public void setDuplex(java.lang.String duplex)

Set the duplex attribute.

Parameters:

duplex - Value of the duplex attribute.

See Also:

ATTRIBUTE_DUPLEX

getEntertone

public java.lang.String getEntertone()

Retrieve the entertone attribute.

Returns:

Value of the entertone attribute.

See Also:

ATTRIBUTE_ENTERTONE

setEntertone

public void setEntertone(java.lang.String entertone)

Set the entertone attribute.

Parameters:

entertone - Value of the entertone attribute.

See Also:

ATTRIBUTE_ENTERTONE

getExittone

public java.lang.String getExittone()

Retrieve the exittone attribute.

Returns:

Value of the exittone attribute.

See Also:

ATTRIBUTE_EXITTONE

setExittone

public void setExittone(java.lang.String exittone)

Set the exittone attribute.

Parameters:

exittone - Value of the exittone attribute.

See Also:

ATTRIBUTE_EXITTONE

getHints

public java.lang.String getHints()

Retrieve the hints attribute.

Returns:

Value of the hints attribute.

See Also:

ATTRIBUTE_HINTS

setHints

public void setHints(java.lang.String hints)

Set the hints attribute.

Parameters:

hints - Value of the hints attribute.

See Also:

ATTRIBUTE_HINTS

getId1

public java.lang.String getId1()

Retrieve the id1 attribute.

Returns:

Value of the id1 attribute.

See Also:

ATTRIBUTE_ID1

setId1

public void setId1(java.lang.String id1)

Set the id1 attribute.

Parameters:

id1 - Value of the id1 attribute.

See Also:

ATTRIBUTE_ID1

getId2

public java.lang.String getId2()

Retrieve the id2 attribute.

Returns:

Value of the id2 attribute.

See Also:

ATTRIBUTE_ID2

setId2

public void setId2(java.lang.String id2)

Set the id2 attribute.

Parameters:

id2 - Value of the id2 attribute.

See Also:

ATTRIBUTE_ID2

getToneclamp

public java.lang.String getToneclamp()

Retrieve the toneclamp attribute.

Returns:

Value of the toneclamp attribute.

See Also:

ATTRIBUTE_TONECLAMP

setToneclamp

public void setToneclamp(java.lang.String toneclamp)

Set the toneclamp attribute.

Parameters:

toneclamp - Value of the toneclamp attribute.

See Also:

ATTRIBUTE_TONECLAMP

canContainChild

protected boolean canContainChild(java.lang.String tagName)

Can the specified sub-tag be contained within this node?

Specified by:

canContainChild in class AbstractXmlNode

Parameters:

tagName - Name of child.

Returns:

True if the sub-tag is allowed on this node.

getAttributeNames

public java.util.Collection<java.lang.String> getAttributeNames()

Returns a collection of permitted attribute names for the node.

Specified by:

getAttributeNames in interface XmlNode

Overrides:

getAttributeNames in class AbstractXmlNode

Returns:

A collection of attribute names that are allowed for the node