Class SaxVinciFrameBuilder

  • All Implemented Interfaces:
    org.xml.sax.ContentHandler, org.xml.sax.DTDHandler, org.xml.sax.EntityResolver, org.xml.sax.ErrorHandler
    Direct Known Subclasses:
    UimaSaxVinciFrameBuilder

    public class SaxVinciFrameBuilder
    extends org.xml.sax.helpers.DefaultHandler
    implements org.xml.sax.ContentHandler
    A SAX content handler that builds a VinciFrame corresponding to the SAX events received.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void characters​(char[] ch, int start, int length)  
      void endElement​(java.lang.String namespaceURI, java.lang.String localName, java.lang.String qualifiedName)  
      protected java.lang.String getLeafContent​(java.lang.String aFrameName, org.xml.sax.Attributes aAttributes, java.lang.StringBuffer aContentBuf)
      Gets the content to be included in a FrameLeaf.
      protected java.lang.String getName​(java.lang.String s1, java.lang.String s2)
      If the first String parameter is nonempty, return it, else return the second string parameter.
      void setParentFrame​(AFrame aParentFrame)
      Sets the parent frame, to which frames built by the object will be added.
      void startDocument()  
      void startElement​(java.lang.String namespaceURI, java.lang.String localName, java.lang.String qualifiedName, org.xml.sax.Attributes attributes)
      Called for each start tag encountered.
      • Methods inherited from class org.xml.sax.helpers.DefaultHandler

        endDocument, endPrefixMapping, error, fatalError, ignorableWhitespace, notationDecl, processingInstruction, resolveEntity, setDocumentLocator, skippedEntity, startPrefixMapping, unparsedEntityDecl, warning
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
      • Methods inherited from interface org.xml.sax.ContentHandler

        endDocument, endPrefixMapping, ignorableWhitespace, processingInstruction, setDocumentLocator, skippedEntity, startPrefixMapping
    • Constructor Detail

      • SaxVinciFrameBuilder

        public SaxVinciFrameBuilder()
    • Method Detail

      • setParentFrame

        public void setParentFrame​(AFrame aParentFrame)
        Sets the parent frame, to which frames built by the object will be added. This MUST be called before parsing a document.
        Parameters:
        aParentFrame - the parent frame
      • startDocument

        public void startDocument()
                           throws org.xml.sax.SAXException
        Specified by:
        startDocument in interface org.xml.sax.ContentHandler
        Overrides:
        startDocument in class org.xml.sax.helpers.DefaultHandler
        Throws:
        org.xml.sax.SAXException
        See Also:
        ContentHandler.startDocument()
      • startElement

        public void startElement​(java.lang.String namespaceURI,
                                 java.lang.String localName,
                                 java.lang.String qualifiedName,
                                 org.xml.sax.Attributes attributes)
                          throws org.xml.sax.SAXException
        Called for each start tag encountered.
        Specified by:
        startElement in interface org.xml.sax.ContentHandler
        Overrides:
        startElement in class org.xml.sax.helpers.DefaultHandler
        Parameters:
        namespaceURI - Required if the namespaces property is true.
        attributes - The specified or defaulted attributes.
        localName - The local name (without prefix), or the empty string if Namespace processing is not being performed.
        qualifiedName - The qualified name (with prefix), or the empty string if qualified names are not available.
        Throws:
        org.xml.sax.SAXException
      • characters

        public void characters​(char[] ch,
                               int start,
                               int length)
        Specified by:
        characters in interface org.xml.sax.ContentHandler
        Overrides:
        characters in class org.xml.sax.helpers.DefaultHandler
        See Also:
        ContentHandler.characters(char[],int,int)
      • endElement

        public void endElement​(java.lang.String namespaceURI,
                               java.lang.String localName,
                               java.lang.String qualifiedName)
        Specified by:
        endElement in interface org.xml.sax.ContentHandler
        Overrides:
        endElement in class org.xml.sax.helpers.DefaultHandler
        See Also:
        ContentHandler.endElement(String,String,String)
      • getLeafContent

        protected java.lang.String getLeafContent​(java.lang.String aFrameName,
                                                  org.xml.sax.Attributes aAttributes,
                                                  java.lang.StringBuffer aContentBuf)
        Gets the content to be included in a FrameLeaf. This method just returns the contents of the provided StringBuffer, but subclasses can override to provide specialized content.
        Parameters:
        aFrameName - name of the FrameLeaf
        aAttributes - attributes of FrameLeaf
        aContentBuf - StringBuffer containing the character data obtained from the SAX parser
        Returns:
        the data to be included in the Vinci FrameLeaf
      • getName

        protected java.lang.String getName​(java.lang.String s1,
                                           java.lang.String s2)
        If the first String parameter is nonempty, return it, else return the second string parameter.
        Parameters:
        s1 - The string to be tested.
        s2 - The alternate String.
        Returns:
        s1 if it isn't empty, else s2.