Class SimpleSAXParser


  • public class SimpleSAXParser
    extends Object
    An XML parser that generates "simple" SAX-like events from a limited subset of XML documents. The SimpleSAXParser can parse simple XML documents; it doesn't support processing instructions or elements that contain both sub-element and character data; character data is only supported in the "leaves" of the XML element tree.

    Example:

    Parsing the following XML:

     <?xml version='1.0' encoding='UTF-8'?>
     <xml-doc>
       <foo a="1" b="2&amp;3"/>
       <bar>Hello World!</bar>
     </xml-doc>
     

    will result in the following method calls to the SimpleSAXListener:

     startDocument()
     startTag("xml-doc", emptyMap, "")
    
     startTag("foo", a_b_Map, "")
     endTag("foo")
    
     startTag("bar", emptyMap, "Hello World!")
     endTag("bar")
    
     endTag("xml-doc")
     endDocument()
     
    • Method Detail

      • setListener

        public void setListener​(SimpleSAXListener listener)
        Sets the (new) listener that should receive any events from this parser. This listener will replace any previously set listener.
        Parameters:
        listener - The (new) listener for events from this parser.
      • getListener

        public SimpleSAXListener getListener()
        Gets the listener that currently will receive any events from this parser.
        Returns:
        The listener for events from this parser.
      • getLocator

        public Locator getLocator()
      • setPreserveWhitespace

        public void setPreserveWhitespace​(boolean preserveWhitespace)
        Sets whether leading and trailing whitespace characters in text elements should be preserved. Such whitespace characters are discarded by default.
      • isPreserveWhitespace

        public boolean isPreserveWhitespace()
        Checks whether leading and trailing whitespace characters in text elements are preserved. Defaults to false.