Class DOMBuilder

  • All Implemented Interfaces:
    ResultHandler, org.xml.sax.DocumentHandler

    public class DOMBuilder
    extends java.lang.Object
    implements ResultHandler
    An implementation of ResultHandler that builds a DOM tree
    Version:
    $Revision: 3837 $ $Date: 2003-09-09 07:05:25 +0200 (Tue, 09 Sep 2003) $
    Author:
    Keith Visco
    • Constructor Summary

      Constructors 
      Constructor Description
      DOMBuilder​(org.w3c.dom.Document document)
      Creates a new DOMBuilder
      DOMBuilder​(org.w3c.dom.Node node)
      Creates a new DOMBuilder with the given node
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void cdata​(char[] chars, int start, int length)
      Signals to receive CDATA characters
      void characters​(char[] chars, int start, int length)
      Signals the start of characters
      void comment​(java.lang.String data)
      Signals to recieve a comment
      void endDocument()
      Signals the end of the document
      void endElement​(java.lang.String name)
      Signals the start of element
      void entityReference​(java.lang.String name)
      Signals to recieve an entity reference with the given name
      void ignorableWhitespace​(char[] chars, int start, int length)
      Signals the start of ignorable whitespace characters
      boolean isFinished()
      Returns true if the DOM builder has completed
      void processingInstruction​(java.lang.String target, java.lang.String data)
      Signals to recieve a processing instruction
      void setDocumentLocator​(org.xml.sax.Locator locator)
      Sets the document locator
      void setEscapeText​(boolean escapeText)
      Sets the behavoir of handling character content.
      void setIndentSize​(short indentSize)
      Sets the indent size for all formatters that perform serialization, in which indentation is applicable.
      void setOutputFormat​(OutputFormat format)
      Sets the output format information for Formatters that perform serialization.
      void startDocument()
      Signals the start of a document
      void startElement​(java.lang.String name, org.xml.sax.AttributeList atts)
      Signals the start of element
      void unescapedCharacters​(char[] chars, int start, int length)
      Signals to receive characters which should not be escaped
      • Methods inherited from class java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • DOMBuilder

        public DOMBuilder​(org.w3c.dom.Document document)
        Creates a new DOMBuilder
        Parameters:
        the - Document in which to use when building the DOM. If the document is not empty...it will be cleared, by removing the document element.
      • DOMBuilder

        public DOMBuilder​(org.w3c.dom.Node node)
        Creates a new DOMBuilder with the given node
        Parameters:
        node - the Node to use when building the DOM fragment
    • Method Detail

      • cdata

        public void cdata​(char[] chars,
                          int start,
                          int length)
        Signals to receive CDATA characters
        Specified by:
        cdata in interface ResultHandler
        Parameters:
        chars - the character array containing the characters to receive
        start - the index into the character array to start receiving characters at
        length - the number of characters to recieve
      • characters

        public void characters​(char[] chars,
                               int start,
                               int length)
                        throws org.xml.sax.SAXException
        Signals the start of characters
        Specified by:
        characters in interface org.xml.sax.DocumentHandler
        Parameters:
        chars - the character array containing the characters to receive
        start - the index into the character array to start receiving characters at
        length - the number of characters to recieve
        Throws:
        org.xml.sax.SAXException
      • comment

        public void comment​(java.lang.String data)
        Description copied from interface: ResultHandler
        Signals to recieve a comment
        Specified by:
        comment in interface ResultHandler
        Parameters:
        data - , the content of the comment
      • endDocument

        public void endDocument()
                         throws org.xml.sax.SAXException
        Signals the end of the document
        Specified by:
        endDocument in interface org.xml.sax.DocumentHandler
        Throws:
        org.xml.sax.SAXException
      • endElement

        public void endElement​(java.lang.String name)
                        throws org.xml.sax.SAXException
        Signals the start of element
        Specified by:
        endElement in interface org.xml.sax.DocumentHandler
        Parameters:
        name - the name of the element
        atts - the AttributeList containing the associated attributes for the element
        Throws:
        org.xml.sax.SAXException
      • entityReference

        public void entityReference​(java.lang.String name)
        Signals to recieve an entity reference with the given name
        Specified by:
        entityReference in interface ResultHandler
        Parameters:
        name - the name of the entity reference
      • ignorableWhitespace

        public void ignorableWhitespace​(char[] chars,
                                        int start,
                                        int length)
                                 throws org.xml.sax.SAXException
        Signals the start of ignorable whitespace characters
        Specified by:
        ignorableWhitespace in interface org.xml.sax.DocumentHandler
        Parameters:
        chars - the character array containing the characters to receive
        start - the index into the character array to start receiving characters at
        length - the number of characters to recieve
        Throws:
        org.xml.sax.SAXException
      • isFinished

        public boolean isFinished()
        Returns true if the DOM builder has completed
        Returns:
        true if the DOM builder has completed
      • processingInstruction

        public void processingInstruction​(java.lang.String target,
                                          java.lang.String data)
                                   throws org.xml.sax.SAXException
        Signals to recieve a processing instruction
        Specified by:
        processingInstruction in interface org.xml.sax.DocumentHandler
        Parameters:
        target - the target of the processing instruction
        data - the content of the processing instruction
        Throws:
        org.xml.sax.SAXException
      • setDocumentLocator

        public void setDocumentLocator​(org.xml.sax.Locator locator)
        Sets the document locator
        Specified by:
        setDocumentLocator in interface org.xml.sax.DocumentHandler
        Parameters:
        locator - the Locator used by this DocumentHandler
      • setEscapeText

        public void setEscapeText​(boolean escapeText)
        Sets the behavoir of handling character content. If argument is true, character content will be escaped. If false, character content will not be escaped.
        Parameters:
        escapeText - the flag indicating whether or not to escape character content
      • setIndentSize

        public void setIndentSize​(short indentSize)
        Sets the indent size for all formatters that perform serialization, in which indentation is applicable.
        Specified by:
        setIndentSize in interface ResultHandler
        Parameters:
        indentSize - the number of characters to indent
      • setOutputFormat

        public void setOutputFormat​(OutputFormat format)
        Sets the output format information for Formatters that perform serialization.
        Specified by:
        setOutputFormat in interface ResultHandler
        Parameters:
        format - the OutputFormat used to specify properties during serialization
      • startDocument

        public void startDocument()
                           throws org.xml.sax.SAXException
        Signals the start of a document
        Specified by:
        startDocument in interface org.xml.sax.DocumentHandler
        Throws:
        org.xml.sax.SAXException
      • startElement

        public void startElement​(java.lang.String name,
                                 org.xml.sax.AttributeList atts)
                          throws org.xml.sax.SAXException
        Signals the start of element
        Specified by:
        startElement in interface org.xml.sax.DocumentHandler
        Parameters:
        name - the name of the element
        atts - the AttributeList containing the associated attributes for the element
        Throws:
        org.xml.sax.SAXException
      • unescapedCharacters

        public void unescapedCharacters​(char[] chars,
                                        int start,
                                        int length)
        Signals to receive characters which should not be escaped
        Specified by:
        unescapedCharacters in interface ResultHandler
        Parameters:
        chars - the character array containing the characters to receive
        start - the index into the character array to start receiving characters at
        length - the number of characters to recieve