USGS

Isis 3.0 Object Programmers' Reference

Home

Isis::XmlStackedHandler Class Reference

XML Handler that parses XMLs in a stack-oriented way. More...

#include <XmlStackedHandler.h>

Inheritance diagram for Isis::XmlStackedHandler:
Inheritance graph
Collaboration diagram for Isis::XmlStackedHandler:
Collaboration graph

Public Member Functions

virtual void setReader (XmlStackedHandlerReader *)
 
void switchToNewHandler (XmlStackedHandler *nextHandler)
 
virtual bool startElement (const QString &namespaceURI, const QString &localName, const QString &qName, const QXmlAttributes &atts)
 
virtual bool endElement (const QString &namespaceURI, const QString &localName, const QString &qName)
 

Protected Member Functions

XmlStackedHandlerReaderreader ()
 
const XmlStackedHandlerReaderreader () const
 

Private Member Functions

 Q_DISABLE_COPY (XmlStackedHandler)
 

Private Attributes

XmlStackedHandlerReaderm_reader
 
int m_depth
 
QString m_lastStartNamespaceURI
 
QString m_lastStartLocalName
 
QString m_lastStartQName
 
QXmlAttributes m_lastStartAtts
 

Detailed Description

XML Handler that parses XMLs in a stack-oriented way.

This XML handler is designed to work with the XmlStackedHandlerReader. This XML handler class handles passing off parsing to another handler. For example, if your XML is:

    <xmlTag1>
      <xmlTag2>
        <xmlTag3>
      </xmlTag2>
    </xmlTag>
  

If this handler is pushed onto the reader (which is the parser stack) when the startElement of xmlTag2 is seen, then this XML handler will see all of the xml data up to and including the xmlTag2 close tag. This handler would never see xmlTag1. Here is an example of how this works:

  --> Push initial XML handler (Handler1)
  <xmlTag1> -- Handler1::startElement
    <xmlTag2> -- Handler1::startElement: calls reader()->pushContentHandler(Handler2)
              -- Handler2::startElement
      <xmlTag3> -- Handler2::startElement
                  -- Handler2::endElement
    </xmlTag2> -- Handler2::endElement
               -- Handler1::endElement
  </xmlTag1> -- Handler1::endElement
Author
2012-??-?? Steven Lambright

Definition at line 46 of file XmlStackedHandler.h.


The documentation for this class was generated from the following files: