org.jvoicexml.xml.ccxml

Class Createcall

java.lang.Object

org.jvoicexml.xml.AbstractXmlNode

org.jvoicexml.xml.ccxml.Createcall

All Implemented Interfaces:

CcxmlNode, XmlNode, org.w3c.dom.Node

public final class Createcall
extends AbstractXmlNode

A CCXML document can attempt to place an outgoing call with <createcall>. This element will instruct the platform to allocate a Connection and attempt to place an outgoing call to a specified address. The element is non-blocking, and the CCXML document is immediately free to perform other tasks, such as initiating dialog interaction with another caller. The CCXML interpreter will receive an asynchronous event when the call attempt is completed. An <eventprocessor> <transition> block can handle this event and perform further call control, such as conferencing. If the call was successfully placed, the transition block can also initiate a dialog interaction with the called party.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ATTRIBUTE_AAI An ECMAScript expression which returns a string of application-to-application information to be passed to the destination endpoint when establishing the connection.
static java.lang.String	ATTRIBUTE_CALLERID An ECMAScript expression which returns a string defining the caller identity to be used when making the outbound connection.
static java.lang.String	ATTRIBUTE_CONNECTIONID An ECMAScript expression which returns a string defining the caller identity to be used when making the outbound connection.
static java.lang.String	ATTRIBUTE_DEST An ECMAScript expression which returns a string that is the target of the outbound telephone call.
static java.lang.String	ATTRIBUTE_HINTS ECMAScript expression that returns an ECMAScript object The ECMAScript object returned contains information which may be used by the implementing platform when establishing the outbound connection.
static java.lang.String	ATTRIBUTE_JOINDIRECTION An ECMAScript expression that defines the direction of the media flow between the newly created connection, and the existing connection/conference/dialog referenced by joinid.
static java.lang.String	ATTRIBUTE_JOINID An ECMAScript expression that identifies a connection, conference, or dialog ID that the new call will be joined to.
protected static java.util.ArrayList<java.lang.String>	ATTRIBUTE_NAMES Supported attribute names for this node.
static java.lang.String	ATTRIBUTE_TIMEOUT The character string returned is interpreted as a time interval.
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
Createcall() Construct a new createcall 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.lang.String	getAai() Retrieve the aai attribute.
java.util.Collection<java.lang.String>	getAttributeNames() Returns a collection of permitted attribute names for the node.
java.lang.String	getCallerid() Retrieve the callerid attribute.
java.lang.String	getConnectionid() Retrieve the connectionid attribute.
java.lang.String	getDest() Retrieve the dest attribute.
java.lang.String	getHints() Retrieve the hints attribute.
java.lang.String	getJoindirection() Retrieve the joindirection attribute.
java.lang.String	getJoinid() Retrieve the joinid attribute.
java.lang.String	getTagName() Get the name of the tag for the derived node.
java.lang.String	getTimeout() Retrieve the timeout attribute.
XmlNode	newInstance(org.w3c.dom.Node n, XmlNodeFactory<? extends XmlNode> factory) Create a new instance for the given node.
void	setAai(java.lang.String aai) Set the aai attribute.
void	setCallerid(java.lang.String callerid) Set the callerid attribute.
void	setConnectionid(java.lang.String connectionid) Set the connectionid attribute.
void	setDest(java.lang.String dest) Set the dest attribute.
void	setHints(java.lang.String hints) Set the hints attribute.
void	setJoindirection(java.lang.String joindirection) Set the joindirection attribute.
void	setJoinid(java.lang.String joinid) Set the joinid attribute.
void	setTimeout(java.lang.String timeout) Set the timeout 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_AAI

public static final java.lang.String ATTRIBUTE_AAI

An ECMAScript expression which returns a string of application-to-application information to be passed to the destination endpoint when establishing the connection. Note: Even if an implementation platform accepts the aai data, certain protocols and network elements may prevent the transmission to the target endpoint. If the platform does not support the transmission of aai data it should raise a connection.progressing event and indicate that the use of aai is not supported.

See Also:

Constant Field Values

ATTRIBUTE_CALLERID

public static final java.lang.String ATTRIBUTE_CALLERID

An ECMAScript expression which returns a string defining the caller identity to be used when making the outbound connection. The format of this information is protocol and platform specific but might consist of a telephone URI, as described in [RFC2806] or a SIP URI as described in [RFC3261]. Note: An implementation platform is not required to use the specified data and certain protocols and network elements may prevent its use. If the platform does not support the specification of callerid it should raise a connection.progressing event and indicate that the use of callerid is not supported.

See Also:

Constant Field Values

ATTRIBUTE_CONNECTIONID

public static final java.lang.String ATTRIBUTE_CONNECTIONID

An ECMAScript expression which returns a string defining the caller identity to be used when making the outbound connection. The format of this information is protocol and platform specific but might consist of a telephone URI, as described in [RFC2806] or a SIP URI as described in [RFC3261]. Note: An implementation platform is not required to use the specified data and certain protocols and network elements may prevent its use. If the platform does not support the specification of callerid it should raise a connection.progressing event and indicate that the use of callerid is not supported.

See Also:

Constant Field Values

ATTRIBUTE_DEST

public static final java.lang.String ATTRIBUTE_DEST

An ECMAScript expression which returns a string that is the target of the outbound telephone call. A platform must support a telephone URI, as described in [RFC2806] or a SIP URI as described in [RFC3261].

See Also:

Constant Field Values

ATTRIBUTE_HINTS

public static final java.lang.String ATTRIBUTE_HINTS

ECMAScript expression that returns an ECMAScript object The ECMAScript object returned contains information which may be used by the implementing platform when establishing the outbound connection. This information may consist of protocol-specific parameters, protocol selection guidelines, or routing hints. Note: The meaning of these hints is specific to the implementing platform.

See Also:

Constant Field Values

ATTRIBUTE_JOINDIRECTION

public static final java.lang.String ATTRIBUTE_JOINDIRECTION

An ECMAScript expression that defines the direction of the media flow between the newly created connection, and the existing connection/conference/dialog referenced by joinid.

See Also:

Constant Field Values

ATTRIBUTE_JOINID

public static final java.lang.String ATTRIBUTE_JOINID

An ECMAScript expression that identifies a connection, conference, or dialog ID that the new call will be joined to. This is equivalent, from the perspective of the CCXML application, to performing a <join> immediately following the <createcall> except that no events specific to the join will be generated. However, platforms may use knowledge about the connection/conference/dialog to which the new call will be connected to optimize the call creation process.

See Also:

Constant Field Values

ATTRIBUTE_TIMEOUT

public static final java.lang.String ATTRIBUTE_TIMEOUT

The character string returned is interpreted as a time interval. This interval begins when createcall is executed. The createcall will fail if not completed by the end of this interval. A completion is defined as the call getting to a CONNECTED state as signaled by a connection.connected event. A failed createcall will return the connection.failed event.

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

Createcall

public Createcall()

Construct a new createcall 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

getAai

public java.lang.String getAai()

Retrieve the aai attribute.

Returns:

Value of the aai attribute.

See Also:

ATTRIBUTE_AAI

setAai

public void setAai(java.lang.String aai)

Set the aai attribute.

Parameters:

aai - Value of the aai attribute.

See Also:

ATTRIBUTE_AAI

getCallerid

public java.lang.String getCallerid()

Retrieve the callerid attribute.

Returns:

Value of the callerid attribute.

See Also:

ATTRIBUTE_CALLERID

setCallerid

public void setCallerid(java.lang.String callerid)

Set the callerid attribute.

Parameters:

callerid - Value of the callerid attribute.

See Also:

ATTRIBUTE_CALLERID

getConnectionid

public java.lang.String getConnectionid()

Retrieve the connectionid attribute.

Returns:

Value of the connectionid attribute.

See Also:

ATTRIBUTE_CONNECTIONID

setConnectionid

public void setConnectionid(java.lang.String connectionid)

Set the connectionid attribute.

Parameters:

connectionid - Value of the connectionid attribute.

See Also:

ATTRIBUTE_CONNECTIONID

getDest

public java.lang.String getDest()

Retrieve the dest attribute.

Returns:

Value of the dest attribute.

See Also:

ATTRIBUTE_DEST

setDest

public void setDest(java.lang.String dest)

Set the dest attribute.

Parameters:

dest - Value of the dest attribute.

See Also:

ATTRIBUTE_DEST

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

getJoindirection

public java.lang.String getJoindirection()

Retrieve the joindirection attribute.

Returns:

Value of the joindirection attribute.

See Also:

ATTRIBUTE_JOINDIRECTION

setJoindirection

public void setJoindirection(java.lang.String joindirection)

Set the joindirection attribute.

Parameters:

joindirection - Value of the joindirection attribute.

See Also:

ATTRIBUTE_JOINDIRECTION

getJoinid

public java.lang.String getJoinid()

Retrieve the joinid attribute.

Returns:

Value of the joinid attribute.

See Also:

ATTRIBUTE_JOINID

setJoinid

public void setJoinid(java.lang.String joinid)

Set the joinid attribute.

Parameters:

joinid - Value of the joinid attribute.

See Also:

ATTRIBUTE_JOINID

getTimeout

public java.lang.String getTimeout()

Retrieve the timeout attribute.

Returns:

Value of the timeout attribute.

See Also:

ATTRIBUTE_TIMEOUT

setTimeout

public void setTimeout(java.lang.String timeout)

Set the timeout attribute.

Parameters:

timeout - Value of the timeout attribute.

See Also:

ATTRIBUTE_TIMEOUT

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