org.jvoicexml

Interface Application

All Known Implementing Classes:

JVoiceXmlApplication

public interface Application

An Application is a set of documents sharing the same application root document.

Whenever the user interacts with a document in an application, its application root document is also loaded. The application root document remains loaded while the user is transitioning between other documents in the same application, and it is unloaded when the user transitions to a document that is not in the application. While it is loaded, the application root document's variables are available to the other documents as application variables, and its grammars remain active for the duration of the application.

Since:

0.4

Method Summary

Modifier and Type	Method and Description
void	addDocument(java.net.URI uri, org.jvoicexml.xml.vxml.VoiceXmlDocument doc) Adds the given document to the application.
java.net.URI	getApplication() Retrieves the URI of the application.
org.jvoicexml.xml.vxml.VoiceXmlDocument	getCurrentDocument() Retrieves the current document.
java.util.List<LastResult>	getLastResult() Retrieves information about the last recognition to occur within this application.
java.net.URI	getXmlBase() Retrieves the base URI.
boolean	isLoaded(java.net.URI uri) Checks, if the document with the given uri is loaded.
java.net.URI	resolve(java.net.URI uri) Converts the given URI into a hierarchical URI.
java.net.URI	resolve(java.net.URI baseUri, java.net.URI uri) Converts the given URI into a hierarchical URI.
void	setLastResult(java.util.List<LastResult> lastresult) Sets the last result.
void	setRootDocument(org.jvoicexml.xml.vxml.VoiceXmlDocument document) Sets the new root document.

Method Detail

addDocument

void addDocument(java.net.URI uri,
                 org.jvoicexml.xml.vxml.VoiceXmlDocument doc)
          throws BadFetchError

Adds the given document to the application.

Parameters:

uri - the URI of the document.

doc - the document to add.

Throws:

BadFetchError - error in the document.

Since:

0.6

getCurrentDocument

org.jvoicexml.xml.vxml.VoiceXmlDocument getCurrentDocument()

Retrieves the current document.

Returns:

the current document.

Since:

0.6

getApplication

java.net.URI getApplication()

Retrieves the URI of the application.

Returns:

URI of the application.

Since:

0.6

setRootDocument

void setRootDocument(org.jvoicexml.xml.vxml.VoiceXmlDocument document)
              throws BadFetchError

Sets the new root document.

Parameters:

document - the new root document.

Throws:

BadFetchError - error in the document.

isLoaded

boolean isLoaded(java.net.URI uri)

Checks, if the document with the given uri is loaded.

Parameters:

uri - the URI to check.

Returns:

true if the document is loaded.

getXmlBase

java.net.URI getXmlBase()

Retrieves the base URI.

Returns:

the base URI.

resolve

java.net.URI resolve(java.net.URI uri)

Converts the given URI into a hierarchical URI. If the given URI is a relative URI, it is expanded using the application URI.

Parameters:

uri - the URI to resolve.

Returns:

Hierarchical URI.

resolve

java.net.URI resolve(java.net.URI baseUri,
                     java.net.URI uri)

Converts the given URI into a hierarchical URI. If the given URI is a relative URI, it is expanded using the baseUri.

Parameters:

baseUri - the base URI.

uri - the URI to resolve.

Returns:

Hierarchical URI.

setLastResult

void setLastResult(java.util.List<LastResult> lastresult)

Sets the last result.

Parameters:

lastresult - the last result to set.

Since:

0.7.7

getLastResult

java.util.List<LastResult> getLastResult()

Retrieves information about the last recognition to occur within this application. It is an array of elements where each element, represents a possible result.

Returns:

last recognition result information, maybe null.

Since:

0.7.7