net.rim.device.api.xml.jaxp
Class SAXParserImpl

java.lang.Object
  |
  +--net.rim.device.api.xml.parsers.SAXParser
        |
        +--net.rim.device.api.xml.jaxp.SAXParserImpl

public class SAXParserImpl
extends SAXParser

Parses XML documents.

Since:
JDE 4.0.0
See Also:
SAXParser

Constructor Summary
SAXParserImpl()
           
 
Method Summary
 boolean getAllowUndefinedNamespaces()
          Determines whether this parser is configured to allow undefined namespaces.
 boolean isNamespaceAware()
          Determines whether this parser is configured to be namespace aware.
 boolean isValidating()
          Determines whether this parser validates documents.
 void parse(InputSource is, DefaultHandler dh)
          Parses the content of the given org.xml.InputSource instance as XML using the specified DefaultHandler.
 void parse(InputStream is, DefaultHandler dh)
          Parses the content of the given InputStream instance as XML using the specified DefaultHandler.
 void parse(InputStream is, DefaultHandler dh, IntHashtable tagTables, IntHashtable attrStartTables, IntHashtable attrTables)
          Parses the content of the given InputStream instance as XML using the specified DefaultHandler.
 void parse(InputStream is, DefaultHandler dh, String[] tagTable, String[] attrStartTable, String[] attrTable)
          Parses the content of the given InputStream instance as XML using the specified DefaultHandler.
 void parse(String url, DefaultHandler dh, boolean autoCodeBookManagement)
          Parses the content of the given URL as XML using the specified DefaultHandler.
 void setAllowUndefinedNamespaces(boolean allowUndefinedNamespaces)
          Configures this parser to allow undefined namespaces.
 void setNamespaceAware(boolean isNamespaceAware)
          Configures this parser to be namespace aware.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SAXParserImpl

public SAXParserImpl()
Since:
JDE 4.0.0
Method Detail

getAllowUndefinedNamespaces

public boolean getAllowUndefinedNamespaces()
Determines whether this parser is configured to allow undefined namespaces.
Overrides:
getAllowUndefinedNamespaces in class SAXParser
Returns:
True if this parser is configured to allow undefined namespaces; false otherwise.
Since:
JDE 4.0.0

isNamespaceAware

public boolean isNamespaceAware()
Determines whether this parser is configured to be namespace aware.
Overrides:
isNamespaceAware in class SAXParser
Returns:
True if this parser is configured to be namespace aware; false otherwise.
Since:
JDE 4.0.0

isValidating

public boolean isValidating()
Description copied from class: SAXParser
Determines whether this parser validates documents.
Overrides:
isValidating in class SAXParser
Since:
JDE 4.0.0

Following copied from class: SAXParser
Returns:
True if this parser validatates documents, false otherwise.

parse

public void parse(InputSource is,
                  DefaultHandler dh)
           throws SAXException,
                  IOException
Parses the content of the given org.xml.InputSource instance as XML using the specified DefaultHandler.
Overrides:
parse in class SAXParser
Parameters:
is - InputSource containing the content to parse.
dh - The SAX DefaultHandler to use.
Throws:
IOException - Thrown if any IO errors occur.
IllegalArgumentException - Thrown if the given InputStream is null.
SAXException - Thrown if the underlying parser throws a SAXException while parsing.
Since:
JDE 4.0.0
See Also:
org.xml.sax.DocumentHandler

parse

public void parse(InputStream is,
                  DefaultHandler dh)
           throws SAXException,
                  IOException
Parses the content of the given InputStream instance as XML using the specified DefaultHandler.
Overrides:
parse in class SAXParser
Parameters:
is - InputStream containing the content to parse.
dh - The SAX DefaultHandler to use.
Throws:
IOException - Thrown if an IO errors occur.
IllegalArgumentException - Thrown if the given InputStream is null.
SAXException - Thrown if the underlying parser throws a SAXException while parsing.
Since:
JDE 4.0.0
See Also:
org.xml.sax.DocumentHandler

parse

public void parse(InputStream is,
                  DefaultHandler dh,
                  IntHashtable tagTables,
                  IntHashtable attrStartTables,
                  IntHashtable attrTables)
           throws SAXException,
                  IOException
Parses the content of the given InputStream instance as XML using the specified DefaultHandler. For additional information, please consult the WBXML spec at this address.
Parameters:
is - InputStream containing the content to parse.
dh - The SAX DefaultHandler to use.
tagTable - Lookup tables of XML tags used to decode WBXML.
attrStartTable - Lookup tables of XML attribute names used to decode WBXML.
attrTable - Lookup table of XML attribute values used to decode WBXML.
Throws:
IOException - Thrown if an IO errors occur.
IllegalArgumentException - Thrown if the given InputStream is null.
SAXException - Thrown if the underlying parser throws a SAXException while parsing.
Since:
JDE 4.0.0
See Also:
org.xml.sax.DocumentHandler

parse

public void parse(InputStream is,
                  DefaultHandler dh,
                  String[] tagTable,
                  String[] attrStartTable,
                  String[] attrTable)
           throws SAXException,
                  IOException
Parses the content of the given InputStream instance as XML using the specified DefaultHandler.
Parameters:
is - InputStream containing the content to parse.
dh - The SAX DefaultHandler to use.
tagTable - A lookup table of XML tags used to decode WBXML.
attrStartTable - A lookup table of XML attribute names used to decode WBXML.
attrTable - A lookup table of XML attribute values used to decode WBXML.
Throws:
IOException - Thrown if an IO errors occur.
IllegalArgumentException - Thrown if the given InputStream is null.
SAXException - Thrown if the underlying parser throws a SAXException while parsing.
Since:
JDE 4.0.0
See Also:
org.xml.sax.DocumentHandler

parse

public void parse(String url,
                  DefaultHandler dh,
                  boolean autoCodeBookManagement)
           throws SAXException,
                  IOException
Parses the content of the given URL as XML using the specified DefaultHandler.
Parameters:
url - The URL of the XML to parse.
dh - The SAX DefaultHandler to use.
autoCodeBookManagement - True to perform automatic code book management; false otherwise.
Since:
JDE 4.0.0

setAllowUndefinedNamespaces

public void setAllowUndefinedNamespaces(boolean allowUndefinedNamespaces)
Configures this parser to allow undefined namespaces.
Overrides:
setAllowUndefinedNamespaces in class SAXParser
Parameters:
allowUndefinedNamespaces - True to configure this parser to allow undefined name spaces; false otherwise.
Since:
JDE 4.0.0

setNamespaceAware

public void setNamespaceAware(boolean isNamespaceAware)
Configures this parser to be namespace aware. By default, it supports namespaces.
Overrides:
setNamespaceAware in class SAXParser
Parameters:
isNamespaceAware - True to configure this parser to be namespaces aware; false otherwise.
Since:
JDE 4.3.0



Copyright 1999-2009 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.