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

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

public class RIMSAXParser
extends SAXParser

Parses XML documents.

Since:
JDE 4.3.0
See Also:
SAXParser

Constructor Summary
RIMSAXParser()
           
 
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

RIMSAXParser

public RIMSAXParser()
Since:
JDE 4.3.0
Method Detail

getAllowUndefinedNamespaces

public boolean getAllowUndefinedNamespaces()
Determines whether this parser is configured to allow undefined namespaces.
Returns:
true if this parser is configured to allow undefined namespaces; false otherwise.
Since:
JDE 4.3.0

isNamespaceAware

public boolean isNamespaceAware()
Determines whether this parser is configured to be namespace aware. By default, it does not support namespaces.
Overrides:
isNamespaceAware in class SAXParser
Returns:
true if this parser is configured to be namespace aware; false otherwise.
Since:
JDE 4.3.0

isValidating

public boolean isValidating()
Description copied from class: SAXParser
Determines whether this parser validates documents.
Overrides:
isValidating in class SAXParser
Since:
JDE 4.3.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 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.3.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 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.3.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 The content to parse.
dh - The SAX DefaultHandler to use.
tagTables - Lookup tables of XML tags used to decode WBXML.
attrStartTables - Lookup tables of XML attribute names used to decode WBXML.
attrTables - 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.3.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 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.3.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.
Throws:
IOException - Thrown if an IO errors occur.
SAXException - Thrown if the underlying parser throws a SAXException while parsing.
Since:
JDE 4.3.0

setAllowUndefinedNamespaces

public void setAllowUndefinedNamespaces(boolean allowUndefinedNamespaces)
Configures this parser to allow undefined namespaces.
Parameters:
allowUndefinedNamespaces - true to configure this parser to allow undefined namespaces; false otherwise.
Since:
JDE 4.3.0

setNamespaceAware

public void setNamespaceAware(boolean isNamespaceAware)
Configures this parser to be namespace aware. By default, it does not support namespaces.
Parameters:
isNamespaceAware - true to configure this parser to be namespace 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.