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

java.lang.Object
  extended by net.rim.device.api.xml.parsers.SAXParser
      extended by net.rim.device.api.xml.jaxp.SAXParserImpl

public class SAXParserImpl
extends SAXParser

Parses XML documents.

See Also:
SAXParser
Since:
BlackBerry API 4.0.0

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(InputStream is, DefaultHandler dh)
          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(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(String url, DefaultHandler dh, boolean autoCodeBookManagement)
          Parses the content of the given URL as XML using the specified DefaultHandler.
 void parse(InputSource is, DefaultHandler dh)
          Parses the content of the given org.xml.InputSource instance 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:
BlackBerry API 4.0.0


Method Detail

getAllowUndefinedNamespaces

public boolean getAllowUndefinedNamespaces()
Determines whether this parser is configured to allow undefined namespaces.

Specified by:
getAllowUndefinedNamespaces in class SAXParser
Returns:
True if this parser is configured to allow undefined namespaces; false otherwise.
Since:
BlackBerry API 4.0.0

setAllowUndefinedNamespaces

public void setAllowUndefinedNamespaces(boolean allowUndefinedNamespaces)
Configures this parser to allow undefined namespaces.

Specified by:
setAllowUndefinedNamespaces in class SAXParser
Parameters:
allowUndefinedNamespaces - True to configure this parser to allow undefined name spaces; false otherwise.
Since:
BlackBerry API 4.0.0

isNamespaceAware

public boolean isNamespaceAware()
Determines whether this parser is configured to be namespace aware.

Specified by:
isNamespaceAware in class SAXParser
Returns:
True if this parser is configured to be namespace aware; false otherwise.
Since:
BlackBerry API 4.0.0

setNamespaceAware

public void setNamespaceAware(boolean isNamespaceAware)
Configures this parser to be namespace aware. By default, it supports namespaces.

Specified by:
setNamespaceAware in class SAXParser
Parameters:
isNamespaceAware - True to configure this parser to be namespaces aware; false otherwise.
Since:
BlackBerry API 4.3.0

isValidating

public boolean isValidating()
Description copied from class: SAXParser
Determines whether this parser validates documents.

Specified by:
isValidating in class SAXParser
Returns:
True if this parser validatates documents, false otherwise.
Since:
BlackBerry API 4.0.0

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.

Specified by:
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.
See Also:
DocumentHandler
Since:
BlackBerry API 4.0.0

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.

Specified by:
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.
See Also:
DocumentHandler
Since:
BlackBerry API 4.0.0

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.
See Also:
DocumentHandler
Since:
BlackBerry API 4.0.0

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.
See Also:
DocumentHandler
Since:
BlackBerry API 4.0.0

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.
Throws:
SAXException
IOException
Since:
BlackBerry API 4.0.0





Copyright 1999-2010 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. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.