com.sun.speech.engine.synthesis
Class JSMLParser

java.lang.Object
  extended bycom.sun.speech.engine.synthesis.JSMLParser

public class JSMLParser
extends java.lang.Object

Parses a JSML 0.6 document and returns a DOM.


Constructor Summary
JSMLParser(java.lang.String jsmlText, boolean validate)
          Creates a new JSMLParser for the given JSML text.
JSMLParser(java.net.URL jsmlSource, boolean validate)
          Creates a new JSMLParser for the given URL.
 
Method Summary
 org.w3c.dom.Document getDocument()
          Gets the document for this parser.
protected  org.w3c.dom.Document parse(org.xml.sax.InputSource source, boolean validate)
          Parses the source and optionally validates it.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

JSMLParser

public JSMLParser(java.lang.String jsmlText,
                  boolean validate)
           throws javax.speech.synthesis.JSMLException
Creates a new JSMLParser for the given JSML text. Parses the text immediately and return any errors. The resulting DOM Document can be retrieved via getDocument. The optional validate will do validation of the JSML text. This is typically not used since JSML doesn't require validation.

Parameters:
jsmlText - the JSML text
validate - if true, validate the JSML text
Throws:
javax.speech.synthesis.JSMLException - if the JSML text contains errors
See Also:
getDocument()

JSMLParser

public JSMLParser(java.net.URL jsmlSource,
                  boolean validate)
           throws javax.speech.synthesis.JSMLException,
                  java.io.IOException
Creates a new JSMLParser for the given URL. Parses the text immediately and returns any errors. The resulting DOM Document can be retrieved via getDocument. The optional validate will do validation of the JSML text. This is typically not used since JSML doesn't require validation.

Parameters:
jsmlSource - the URL containing JSML text
validate - if true, validate the JSML text
Throws:
javax.speech.synthesis.JSMLException - if the JSML text contains errors
java.io.IOException - if problems encountered with URL
See Also:
getDocument()
Method Detail

getDocument

public org.w3c.dom.Document getDocument()
Gets the document for this parser.

Returns:
a DOM

parse

protected org.w3c.dom.Document parse(org.xml.sax.InputSource source,
                                     boolean validate)
                              throws javax.speech.synthesis.JSMLException,
                                     java.io.IOException
Parses the source and optionally validates it.

Parameters:
source - the JSML text
validate - if true, validate the JSML text
Throws:
javax.speech.synthesis.JSMLException - if the JSML text contains errors
java.io.IOException - if problems encountered with source