DDLSAX2FileHandler is the SAX2 Handler for XML files found in the configuration file. More...

#include <DDLSAX2FileHandler.h>

Inheritance diagram for DDLSAX2FileHandler:

Public Member Functions
void	characters (const XMLCh *const chars, const unsigned int length)

void	comment (const XMLCh *const chars, const unsigned int length)

	DDLSAX2FileHandler (DDCompactView &cpv)

void	dumpElementTypeCounter ()
	This dumps some statistics on elements encountered in the file. More...

void	endElement (const XMLCh const uri, const XMLCh const localname, const XMLCh *const qname)

void	init ()

virtual const std::string &	parent () const

virtual const std::string &	self () const

void	startElement (const XMLCh const uri, const XMLCh const localname, const XMLCh *const qname, const Attributes &attrs)

	~DDLSAX2FileHandler ()

Public Member Functions inherited from DDLSAX2Handler
	DDLSAX2Handler ()

virtual void	dumpStats (const std::string &fname)

virtual void	error (const SAXParseException &exception)

virtual void	fatalError (const SAXParseException &exception)

unsigned int	getAttrCount () const
	Get the count of attributes processed so far. More...

unsigned int	getCharacterCount () const
	Get the count of characters processed so far. More...

unsigned int	getElementCount () const
	Get the count of elements processed so far. More...

bool	getSawErrors () const
	Did the XML parser see any errors? More...

unsigned int	getSpaceCount () const
	Get the count of spaces processed so far. More...

virtual void	ignorableWhitespace (const XMLCh *const chars, const unsigned int length)

virtual void	resetDocument ()

virtual void	setNameSpace (const std::string &nms)

virtual void	setUserNS (bool userns)

virtual void	warning (const SAXParseException &exception)

	~DDLSAX2Handler ()

Protected Member Functions
void	createDDConstants () const
	creates all DDConstant from the evaluator which has been already 'filled' in the first scan of the documents More...

Protected Attributes
DDCompactView &	cpv_

std::map< std::string, int >	elementTypeCounter_

std::vector< size_t >	names_

std::vector< std::string >	namesMap_

DDLElementRegistry	xmlelems_

Protected Attributes inherited from DDLSAX2Handler
unsigned int	attrCount_

unsigned int	characterCount_

unsigned int	elementCount_

std::string	nmspace_

bool	sawErrors_

unsigned int	spaceCount_

bool	userNS_

Additional Inherited Members
Public Types inherited from DDLSAX2Handler
typedef XERCES_CPP_NAMESPACE::Attributes	Attributes

typedef XERCES_CPP_NAMESPACE::SAXParseException	SAXParseException

Detailed Description

DDLSAX2FileHandler is the SAX2 Handler for XML files found in the configuration file.

Author: Michael Case

DDLSAX2FileHandler.h - description

begin: Tue Oct 23 2001 email: case@.nosp@m.ucdh.nosp@m.ep.uc.nosp@m.davi.nosp@m.s.edu

DDLSAX2FileHandler has the same structure as the DDLSAX2ConfigHandler as they both inherit from DDLSAX2Handler which inherits from Xerces C++ DefaultHandler. SAX2 is event driven. So, when the start of an element is encountered in the XML, then a call is made to the handler's startElement. The same for endElement.

The design of DDXMLElement allows for processing whichever type of Element the XML Parser encounters.

Definition at line 40 of file DDLSAX2FileHandler.h.

Constructor & Destructor Documentation

DDLSAX2FileHandler::DDLSAX2FileHandler ( DDCompactView & cpv )

Definition at line 27 of file DDLSAX2FileHandler.cc.

References init().

   : cpv_(cpv),
     xmlelems_()
 {
   init();
 }

DDLSAX2FileHandler::~DDLSAX2FileHandler ( void )

Definition at line 42 of file DDLSAX2FileHandler.cc.

43 {}

Member Function Documentation

void DDLSAX2FileHandler::characters	(	const XMLCh *const	chars,
		const unsigned int	length
	)

virtual

Reimplemented from DDLSAX2Handler.

Definition at line 133 of file DDLSAX2FileHandler.cc.

References DDXMLElement::appendText(), DCOUT_V, DDXMLElement::gotText(), i, DDI::Singleton< I >::instance(), DDXMLElement::loadText(), and asciidump::s.

 {
   DCOUT_V('P', "DDLSAX2FileHandler::characters started");
   //  std::cout << "character handler started" << std::endl;
   //DDXMLElement* myElement = NULL;
   // final way
   //  myElement = xmlelems_.getElement(namesMap_[names_.back()]);
   //temporary way:
   //  const std::string&  myElementName = namesMap_[names_.back()];
   DDXMLElement* myElement = DDLGlobalRegistry::instance().getElement(self());//myElementName); //namesMap_[names_.back()]);
   std::string inString = "";
   for (unsigned int i = 0; i < length; ++i)
   {
     char s = chars[i];
     inString = inString + s;
   }
   if (myElement->gotText())
     myElement->appendText(inString);
   else
     myElement->loadText(inString);
 
   DCOUT_V('P', "DDLSAX2FileHandler::characters completed"); 
 }

void DDLSAX2FileHandler::comment	(	const XMLCh *const	chars,
		const unsigned int	length
	)

virtual

Reimplemented from DDLSAX2Handler.

Definition at line 159 of file DDLSAX2FileHandler.cc.

 {
   // ignore, discard, overkill since base class also has this...
 }

void DDLSAX2FileHandler::createDDConstants ( void ) const

protected

creates all DDConstant from the evaluator which has been already 'filled' in the first scan of the documents

Definition at line 170 of file DDLSAX2FileHandler.cc.

References DDConstant::createConstantsFromEvaluator().

Referenced by init().

 {
   DDConstant::createConstantsFromEvaluator();
 }

void DDLSAX2FileHandler::dumpElementTypeCounter ( void )

This dumps some statistics on elements encountered in the file.

Definition at line 166 of file DDLSAX2FileHandler.cc.

Referenced by DDLParser::parse().

167 {}

void DDLSAX2FileHandler::endElement	(	const XMLCh *const	uri,
		const XMLCh *const	localname,
		const XMLCh *const	qname
	)

virtual

Reimplemented from DDLSAX2Handler.

Definition at line 95 of file DDLSAX2FileHandler.cc.

References cpv_, DCOUT_V, DDI::Singleton< I >::instance(), names_, DDLSAX2Handler::nmspace_, DDCurrentNamespace::ns(), parent(), DDXMLElement::processElement(), DDXMLElement::setParent(), DDXMLElement::setSelf(), and DDLSAX2Handler::userNS_.

 {
   std::string ts(StrX(qname).localForm());
   const std::string&  myElementName = self();
   DCOUT_V('P', "DDLSAX2FileHandler::endElement started");
   DCOUT_V('P', "    " + myElementName);
   //final way
   //  DDXMLElement* myElement = xmlelems_.getElement(myElementName); //myRegistry_->getElement(myElementName);
   //temporary way:
   DDXMLElement* myElement = DDLGlobalRegistry::instance().getElement(myElementName);
 
   //   DDLParser* beingParsed = DDLParser::instance();
   //   std::string nmspace = getnmspace(extractFileName( beingParsed->getCurrFileName()));
   std::string nmspace = nmspace_;
   // The need for processElement to have the nmspace so that it can 
   // do the necessary gymnastics made things more complicated in the
   // effort to allow fully user-controlled namespaces.  So the "magic"
   // trick of setting nmspace to "!" is used :(... I don't like this magic trick
   // -- Michael Case 2008-11-06
   // OPTIMISE in the near future, like the current nmspace_ impl. 
   // just set nmspace_ to "!" from Parser based on userNS_ so 
   // userNS_ is set by parser ONCE and no if nec. here. MEC: 2009-06-22
   if ( userNS_ ) {
     nmspace = "!";
   } 
   //  std::cout << "namespace " << nmspace_ << std::endl;
   DDCurrentNamespace::ns() = nmspace;
   // tell the element it's parent name for recording/reporting purposes
   myElement->setParent(parent());
   myElement->setSelf(self());
   myElement->processElement(myElementName, nmspace, cpv_);
   DCOUT_V('P', "DDLSAX2FileHandler::endElement completed");
   names_.pop_back();
 }

void DDLSAX2FileHandler::init ( void )

Definition at line 35 of file DDLSAX2FileHandler.cc.

References createDDConstants(), names_, and namesMap_.

Referenced by DDLSAX2FileHandler().

 {
   createDDConstants();
   namesMap_.push_back("*** root ***");
   names_.push_back(namesMap_.size() - 1);
 }

const std::string & DDLSAX2FileHandler::parent ( void ) const

virtual

Definition at line 176 of file DDLSAX2FileHandler.cc.

References names_, and namesMap_.

 {
   if (names_.size() > 2)
   {
     return namesMap_.at(names_.at(names_.size() - 2));
   }
   return namesMap_[0];//.at(names_.at(0));
 }

const std::string & DDLSAX2FileHandler::self ( void ) const

virtual

Definition at line 186 of file DDLSAX2FileHandler.cc.

References names_, and namesMap_.

 {
   if (names_.size() > 1) {
     return namesMap_.at(names_.at(names_.size() - 1));
   }
   return namesMap_[0];//.at(names_.at(0));
 }

void DDLSAX2FileHandler::startElement	(	const XMLCh *const	uri,
		const XMLCh *const	localname,
		const XMLCh *const	qname,
		const Attributes &	attrs
	)

virtual

Reimplemented from DDLSAX2Handler.

Definition at line 49 of file DDLSAX2FileHandler.cc.

References cpv_, DCOUT_V, elementTypeCounter_, i, DDI::Singleton< I >::instance(), DDXMLElement::loadAttributes(), DDXMLElement::loadText(), names_, namesMap_, and DDLSAX2Handler::nmspace_.

 {
   DCOUT_V('P', "DDLSAX2FileHandler::startElement started");
 
   std::string myElementName(StrX(qname).localForm());
   size_t i = 0;
   for (; i < namesMap_.size(); ++i) {
     if ( myElementName == namesMap_.at(i) ) {
       names_.push_back(i);
       break;
     }
   }
   if (i >= namesMap_.size()) {
     namesMap_.push_back(myElementName);
     names_.push_back(namesMap_.size() - 1);
   }
 
   ++elementTypeCounter_[myElementName];
   //final way
   //  DDXMLElement* myElement = xmlelems_.getElement(myElementName); //myRegistry_->getElement(myElementName);
   //temporary way:
   DDXMLElement* myElement = DDLGlobalRegistry::instance().getElement(myElementName);
 
   unsigned int numAtts = attrs.getLength();
   std::vector<std::string> attrNames, attrValues;
 
   for (unsigned int i = 0; i < numAtts; ++i)
   {
     //       char* temp2 = XMLString::transcode(attrs.getLocalName(i));
     //       char* temp3 = XMLString::transcode(attrs.getValue(i));
     attrNames.push_back(std::string(StrX(attrs.getLocalName(i)).localForm()));
     attrValues.push_back(std::string(StrX(attrs.getValue(i)).localForm()));
     //       XMLString::release(&temp2);
     //       XMLString::release(&temp3);
   }
   
   myElement->loadAttributes(myElementName, attrNames, attrValues, nmspace_, cpv_);
   //  initialize text
   myElement->loadText(std::string()); 
   DCOUT_V('P', "DDLSAX2FileHandler::startElement completed");
 }