org.jvoicexml.xml.ccxml

Class Fetch

java.lang.Object

org.jvoicexml.xml.AbstractXmlNode

org.jvoicexml.xml.ccxml.Fetch

All Implemented Interfaces:

CcxmlNode, XmlNode, org.w3c.dom.Node

public final class Fetch
extends AbstractXmlNode

<fetch> is used to asynchronously fetch content identified by the attributes of the <fetch>. The fetched content may either be a CCXML document, or script content. Content that has been acquired using <fetch> is accessible through other elements defined by CCXML. Execution returns from the element immediately, and the CCXML application can continue on while the platform works to fetch the identified resource. When the fetch request has been completed, an event is generated against the session that initiated the fetch. The event is one of fetch.done, which indicates that the identified content was fetched successfully, or error.fetch, indicative of a failure to fetch the requested content. Note that even if content is successfully fetched, errors in processing fetched content (for instance, a CCXML document with a syntax error) may result in an error.fetch being thrown. The fetch request is local to the session that initiated the <fetch>, and is referenced through a unique identifier generated by the CCXML platform. The application may obtain the unique identifier for a fetch request by providing an ECMAScript left-hand-side expression in the fetchid attribute when the fetch is performed. The fetch identifier can also be obtained as a property of the fetch.done event. The application uses the fetch identifier in any CCXML elements that reference fetched content, currently <goto> and <script>. Fetched content has a lifetime that is limited to that of the document in which it is fetched. Therefore, following a transition to a new CCXML document using <goto>, content fetched in the scope of the current document is no longer accessible. Note that this should not be taken to preclude platform-level optimizations or caching of resources that are fetched multiple times. The use of <fetch> to obtain content does not compel the application to make use of that content. However, it is wasteful of system resources to fetch resources that are not used. Platforms are responsible for clearing out unused fetch resources, and may impose limits on the resources that can be fetched by a single session.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ATTRIBUTE_ENCTYPE An ECMAScript expression which returns a character string that indicates the media encoding type of the submitted document (when the value of the method is "post").
static java.lang.String	ATTRIBUTE_FETCHID An ECMAScript left hand side expression evaluating to a previously defined variable.
static java.lang.String	ATTRIBUTE_MAXAGE The character string returned is interpreted as a time interval.
static java.lang.String	ATTRIBUTE_MAXSTALE The character string returned is interpreted as a time interval.
static java.lang.String	ATTRIBUTE_METHOD An ECMAScript expression which returns a character string that indicates the HTTP method to use.
static java.lang.String	ATTRIBUTE_NAMELIST A list of zero or more whitespace separated CCXML variable names.
protected static java.util.ArrayList<java.lang.String>	ATTRIBUTE_NAMES Supported attribute names for this node.
static java.lang.String	ATTRIBUTE_NEXT An ECMAScript expression which returns the URI of the resource to be fetched.
static java.lang.String	ATTRIBUTE_TIMEOUT The character string returned is interpreted as a time interval.
static java.lang.String	ATTRIBUTE_TYPE An ECMAScript expression which returns a character string that specifies the MIME type of the fetched content.
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
Fetch() Construct a new fetch 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	getEnctype() Retrieve the enctype attribute.
java.lang.String	getFetchid() Retrieve the fetchid attribute.
java.lang.String	getMaxage() Retrieve the maxage attribute.
java.lang.String	getMaxstale() Retrieve the maxstale attribute.
java.lang.String	getMethod() Retrieve the method attribute.
java.lang.String	getNamelist() Retrieve the namelist attribute.
java.lang.String	getNext() Retrieve the next attribute.
java.lang.String	getTagName() Get the name of the tag for the derived node.
java.lang.String	getTimeout() Retrieve the timeout attribute.
java.lang.String	getType() Retrieve the type attribute.
XmlNode	newInstance(org.w3c.dom.Node n, XmlNodeFactory<? extends XmlNode> factory) Create a new instance for the given node.
void	setEnctype(java.lang.String enctype) Set the enctype attribute.
void	setFetchid(java.lang.String fetchid) Set the fetchid attribute.
void	setMaxage(java.lang.String maxage) Set the maxage attribute.
void	setMaxstale(java.lang.String maxstale) Set the maxstale attribute.
void	setMethod(java.lang.String method) Set the method attribute.
void	setNamelist(java.lang.String namelist) Set the namelist attribute.
void	setNext(java.lang.String next) Set the next attribute.
void	setTimeout(java.lang.String timeout) Set the timeout attribute.
void	setType(java.lang.String type) Set the type 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_ENCTYPE

public static final java.lang.String ATTRIBUTE_ENCTYPE

An ECMAScript expression which returns a character string that indicates the media encoding type of the submitted document (when the value of the method is "post").

See Also:

Constant Field Values

ATTRIBUTE_FETCHID

public static final java.lang.String ATTRIBUTE_FETCHID

An ECMAScript left hand side expression evaluating to a previously defined variable. The value of the attribute will receive an internally generated unique string identifier to be associated with the completion event. This identifier can be tested by the fetch completion event handler to distinguish among several outstanding fetch requests. If this attribute is not specified, the fetch identifier can be acquired from the fetch completion event. Every fetch request will receive a unique fetch identifier, even if the request if for the same URL.

See Also:

Constant Field Values

ATTRIBUTE_MAXAGE

public static final java.lang.String ATTRIBUTE_MAXAGE

The character string returned is interpreted as a time interval. This indicates that the document is willing to use content whose age is no greater than the specified time in seconds (cf. 'max-age' in HTTP 1.1 [RFC2616]). The document is not willing to use stale content, unless maxstale is also provided.

See Also:

Constant Field Values

ATTRIBUTE_MAXSTALE

public static final java.lang.String ATTRIBUTE_MAXSTALE

The character string returned is interpreted as a time interval. This indicates that the document is willing to use content that has exceeded its expiration time (cf. 'max-age' in HTTP 1.1 [RFC2616]). If maxstale is assigned a value, then the document is willing to accept content that has exceeded its expiration time by no more than the specified number of seconds.

See Also:

Constant Field Values

ATTRIBUTE_METHOD

public static final java.lang.String ATTRIBUTE_METHOD

An ECMAScript expression which returns a character string that indicates the HTTP method to use.

See Also:

Constant Field Values

ATTRIBUTE_NAMELIST

public static final java.lang.String ATTRIBUTE_NAMELIST

A list of zero or more whitespace separated CCXML variable names. These variables will be submitted to the server, with the same qualification as used in the namelist. When an ECMAscript variable is submitted to the server, its value is first converted into a string before being submitted. If the variable is an ECMAScript Object, the mechanism by which it is submitted is not currently defined. Instead of submitting ECMAScript Objects directly, the application developer may explicitly submit the properties of an Object. e.g. "date.month date.year".

See Also:

Constant Field Values

ATTRIBUTE_NEXT

public static final java.lang.String ATTRIBUTE_NEXT

An ECMAScript expression which returns the URI of the resource to be fetched.

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 the fetch is executed. The fetch will fail if not completed at the end of this interval. A failed fetch will return the error.fetch event.

See Also:

Constant Field Values

ATTRIBUTE_TYPE

public static final java.lang.String ATTRIBUTE_TYPE

An ECMAScript expression which returns a character string that specifies the MIME type of the fetched content.

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

Fetch

public Fetch()

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

getEnctype

public java.lang.String getEnctype()

Retrieve the enctype attribute.

Returns:

Value of the enctype attribute.

See Also:

ATTRIBUTE_ENCTYPE

setEnctype

public void setEnctype(java.lang.String enctype)

Set the enctype attribute.

Parameters:

enctype - Value of the enctype attribute.

See Also:

ATTRIBUTE_ENCTYPE

getFetchid

public java.lang.String getFetchid()

Retrieve the fetchid attribute.

Returns:

Value of the fetchid attribute.

See Also:

ATTRIBUTE_FETCHID

setFetchid

public void setFetchid(java.lang.String fetchid)

Set the fetchid attribute.

Parameters:

fetchid - Value of the fetchid attribute.

See Also:

ATTRIBUTE_FETCHID

getMaxage

public java.lang.String getMaxage()

Retrieve the maxage attribute.

Returns:

Value of the maxage attribute.

See Also:

ATTRIBUTE_MAXAGE

setMaxage

public void setMaxage(java.lang.String maxage)

Set the maxage attribute.

Parameters:

maxage - Value of the maxage attribute.

See Also:

ATTRIBUTE_MAXAGE

getMaxstale

public java.lang.String getMaxstale()

Retrieve the maxstale attribute.

Returns:

Value of the maxstale attribute.

See Also:

ATTRIBUTE_MAXSTALE

setMaxstale

public void setMaxstale(java.lang.String maxstale)

Set the maxstale attribute.

Parameters:

maxstale - Value of the maxstale attribute.

See Also:

ATTRIBUTE_MAXSTALE

getMethod

public java.lang.String getMethod()

Retrieve the method attribute.

Returns:

Value of the method attribute.

See Also:

ATTRIBUTE_METHOD

setMethod

public void setMethod(java.lang.String method)

Set the method attribute.

Parameters:

method - Value of the method attribute.

See Also:

ATTRIBUTE_METHOD

getNamelist

public java.lang.String getNamelist()

Retrieve the namelist attribute.

Returns:

Value of the namelist attribute.

See Also:

ATTRIBUTE_NAMELIST

setNamelist

public void setNamelist(java.lang.String namelist)

Set the namelist attribute.

Parameters:

namelist - Value of the namelist attribute.

See Also:

ATTRIBUTE_NAMELIST

getNext

public java.lang.String getNext()

Retrieve the next attribute.

Returns:

Value of the next attribute.

See Also:

ATTRIBUTE_NEXT

setNext

public void setNext(java.lang.String next)

Set the next attribute.

Parameters:

next - Value of the next attribute.

See Also:

ATTRIBUTE_NEXT

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

getType

public java.lang.String getType()

Retrieve the type attribute.

Returns:

Value of the type attribute.

See Also:

ATTRIBUTE_TYPE

setType

public void setType(java.lang.String type)

Set the type attribute.

Parameters:

type - Value of the type attribute.

See Also:

ATTRIBUTE_TYPE

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