Package org.apache.fop.fo

Class FOTreeBuilder

  • All Implemented Interfaces:
    org.xml.sax.ContentHandler, org.xml.sax.DTDHandler, org.xml.sax.EntityResolver, org.xml.sax.ErrorHandler
    public class FOTreeBuilder
extends org.xml.sax.helpers.DefaultHandler
    SAX Handler that passes parsed data to the various FO objects, where they can be used either to build an FO Tree, or used by Structure Renderers to build other data structures.

    • Field Summary

      Fields 
      Modifier and Type Field Description
      protected org.xml.sax.ContentHandler delegate
      Current delegate ContentHandler to receive the SAX events
      protected ElementMappingRegistry elementMappingRegistry
      The registry for ElementMapping instances
      protected org.apache.fop.fo.FOTreeBuilder.MainFOHandler mainFOHandler
      Main DefaultHandler that handles the FO namespace.
      protected Root rootFObj
      The root of the formatting object tree

    • Constructor Summary

      Constructors 
      Constructor Description
      FOTreeBuilder​(java.lang.String outputFormat, FOUserAgent foUserAgent, java.io.OutputStream stream)
      FOTreeBuilder constructor

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void characters​(char[] data, int start, int length)
      void endDocument()
      void endElement​(java.lang.String uri, java.lang.String localName, java.lang.String rawName)
      void error​(org.xml.sax.SAXParseException e)
      void fatalError​(org.xml.sax.SAXParseException e)
      protected org.xml.sax.Locator getEffectiveLocator()  
      FOEventHandler getEventHandler()
      Provides access to the underlying FOEventHandler object.
      FormattingResults getResults()
      Returns the results of the rendering process.
      void setDocumentLocator​(org.xml.sax.Locator locator)
      void startDocument()
      void startElement​(java.lang.String namespaceURI, java.lang.String localName, java.lang.String rawName, org.xml.sax.Attributes attlist)
      void warning​(org.xml.sax.SAXParseException e)

      • Methods inherited from class org.xml.sax.helpers.DefaultHandler

        endPrefixMapping, ignorableWhitespace, notationDecl, processingInstruction, resolveEntity, skippedEntity, startPrefixMapping, unparsedEntityDecl

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Field Detail

      • elementMappingRegistry

        protected ElementMappingRegistry elementMappingRegistry
        The registry for ElementMapping instances

      • rootFObj

        protected Root rootFObj
        The root of the formatting object tree

      • mainFOHandler

        protected org.apache.fop.fo.FOTreeBuilder.MainFOHandler mainFOHandler
        Main DefaultHandler that handles the FO namespace.

      • delegate

        protected org.xml.sax.ContentHandler delegate
        Current delegate ContentHandler to receive the SAX events

    • Constructor Detail

      • FOTreeBuilder

        public FOTreeBuilder​(java.lang.String outputFormat,
                     FOUserAgent foUserAgent,
                     java.io.OutputStream stream)
              throws FOPException
        FOTreeBuilder constructor
        Parameters:
        outputFormat - the MIME type of the output format to use (ex. "application/pdf").
        foUserAgent - the FOUserAgent in effect for this process
        stream - the OutputStream to direct the results to
        Throws:
        FOPException - if the FOTreeBuilder cannot be properly created

    • Method Detail

      • setDocumentLocator

        public void setDocumentLocator​(org.xml.sax.Locator locator)
        Specified by:
        setDocumentLocator in interface org.xml.sax.ContentHandler
        Overrides:
        setDocumentLocator in class org.xml.sax.helpers.DefaultHandler

      • getEffectiveLocator

        protected org.xml.sax.Locator getEffectiveLocator()
        Returns:
        a Locator instance if it is available and not disabled

      • characters

        public void characters​(char[] data,
                       int start,
                       int length)
                throws org.xml.sax.SAXException
        Specified by:
        characters in interface org.xml.sax.ContentHandler
        Overrides:
        characters in class org.xml.sax.helpers.DefaultHandler
        Throws:
        org.xml.sax.SAXException

      • 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

      • endDocument

        public void endDocument()
                 throws org.xml.sax.SAXException
        Specified by:
        endDocument in interface org.xml.sax.ContentHandler
        Overrides:
        endDocument in class org.xml.sax.helpers.DefaultHandler
        Throws:
        org.xml.sax.SAXException

      • startElement

        public void startElement​(java.lang.String namespaceURI,
                         java.lang.String localName,
                         java.lang.String rawName,
                         org.xml.sax.Attributes attlist)
                  throws org.xml.sax.SAXException
        Specified by:
        startElement in interface org.xml.sax.ContentHandler
        Overrides:
        startElement in class org.xml.sax.helpers.DefaultHandler
        Throws:
        org.xml.sax.SAXException

      • endElement

        public void endElement​(java.lang.String uri,
                       java.lang.String localName,
                       java.lang.String rawName)
                throws org.xml.sax.SAXException
        Specified by:
        endElement in interface org.xml.sax.ContentHandler
        Overrides:
        endElement in class org.xml.sax.helpers.DefaultHandler
        Throws:
        org.xml.sax.SAXException

      • warning

        public void warning​(org.xml.sax.SAXParseException e)
        Specified by:
        warning in interface org.xml.sax.ErrorHandler
        Overrides:
        warning in class org.xml.sax.helpers.DefaultHandler

      • error

        public void error​(org.xml.sax.SAXParseException e)
        Specified by:
        error in interface org.xml.sax.ErrorHandler
        Overrides:
        error in class org.xml.sax.helpers.DefaultHandler

      • fatalError

        public void fatalError​(org.xml.sax.SAXParseException e)
                throws org.xml.sax.SAXException
        Specified by:
        fatalError in interface org.xml.sax.ErrorHandler
        Overrides:
        fatalError in class org.xml.sax.helpers.DefaultHandler
        Throws:
        org.xml.sax.SAXException

      • getEventHandler

        public FOEventHandler getEventHandler()
        Provides access to the underlying FOEventHandler object.
        Returns:
        the FOEventHandler object

      • getResults

        public FormattingResults getResults()
        Returns the results of the rendering process. Information includes the total number of pages generated and the number of pages per page-sequence.
        Returns:
        the results of the rendering process.