MlpParseHandlers.hpp

Go to the documentation of this file.

/*
 * Copyright (c) 2009, Czech Technical University in Prague
 * All rights reserved.
 *
 * Authors/Contact:
 *
 * Petr Vlacil
 * (vlacipet@fel.cvut.cz)
 * R&D Centre (RDC) for Mobile Applications
 * Dept of Telecommunications Engineering
 * Faculty of Electrical Engineering
 * Czech Technical University in Prague
 * Technicka 2, 166 27 Prague 6, Czech Republic
 *
 * Redistribution and use in source and binary forms, with or 
 * without modification, are permitted provided that the following 
 * conditions are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in
 *    the documentation and/or other materials provided with the
 *    distribution.
 * 3. Neither the name of the Czech Technical University in Prague nor
 *    the names of its contributors may be used to endorse or promote 
 *    products derived from this software without specific prior
 *    written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
 * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 */


#ifndef MLP_PARSE_HANDLERS_H
#define MLP_PARSE_HANDLERS_H


/** 
 * \file
 * \brief MlpParseHandlers declaration
 *
 * This file contains MlpParseHandlers class declaration.
 *
 * \author Petr Vláčil
 */


//--------------------------------------------------------------------------
//  Standard libraries
//--------------------------------------------------------------------------
#include <stack>
#include <sstream>

//--------------------------------------------------------------------------
//  Xercesc libraries
//--------------------------------------------------------------------------
#include <xercesc/sax2/ContentHandler.hpp>

//--------------------------------------------------------------------------
//  MLP-Lib-Cpp library files
//--------------------------------------------------------------------------
#include <libmlp-cpp/MlpConstants.hpp>
#include <libmlp-cpp/MlpTagNames.hpp>
#include <libmlp-cpp/MlpMessage.hpp>
#include <libmlp-cpp/MlpShape.hpp>


/**
 *  \brief Class that do the most of work.
 *
 * This class is passed to Xerces SAX2 XMLReader and its member functions
 * are called to process XML.
 */
class MlpParseHandlers : public xercesc::ContentHandler
{
    private:
        
        /** Stack for tag constants. 
         *
         * It is used to hold the current XML
         * element on the top of the stack.
         */
        std::stack<int> _tagStack;

        /** Tag string names */
        MlpTagNames _tagNames;
        
        /** Resulting parsed message */
        MlpMessage* _inMsg;
        
        /** Temporary pointer to resulting header of MLP message */
        MlpHdr* _newHdr;
        
        /** Temporary pointer to resulting list of Subscribers to locate */
        MlpSubscriberList* _newSubscriberList;
        
        /** Temporary pointer to resulting list of positions of subscribers */
        MlpPositionList* _newPositionList;
        
        /** Temporary pointer to object containing subscribes location */
        MlpShape* _newShape;
        
        /** Temporary pointer to GSM parameters */
        MlpGsmNetParams* _newMlpGsmNetParams;
        
        /** Buffer for CDATA and PCDATA characters */
        std::ostringstream _charBuf;

    public:
        /** Constructor */
        MlpParseHandlers();
        /** Destructor */
        ~MlpParseHandlers();


        /** Processes each starting XML element */
        void startElement (
                const   XMLCh* const uri,
                const   XMLCh* const localname,
                const   XMLCh* const qname,
                const   xercesc::Attributes& attrs
        ) ;

        /** Processes each closing XML element */
        void endElement (
                const XMLCh* const uri,
                const XMLCh* const localname,
                const XMLCh* const qname
        ) ;

        /** Processes CDATA and PCDATA between starting and closing XML elements */
        void characters (
                const XMLCh *const chars,
                const unsigned int length
        ) ;

        /** not used */
        void ignorableWhitespace (
                const XMLCh *const chars,
                const unsigned int length
        ) ;

        /** not used */
        void processingInstruction (
                const XMLCh *const target,
                const XMLCh *const data
        ) ;

        /** not used */
        void resetDocument () ;

        /** not used */
        void setDocumentLocator (const xercesc::Locator *const locator) ;

        /** not used */
        void startDocument () ;

        /** not used */
        void endDocument () ;

        /** not used */
        void startPrefixMapping ( 
                const XMLCh *const prefix,
                const XMLCh *const uri
        ) ;

        /** not used */
        void endPrefixMapping ( const XMLCh *const prefix ) ;

        /** not used */
        void skippedEntity ( const XMLCh *const name ) ;

        void clean ();

        void setNewMsg ( MlpMessage* emptyMsg );

    private:
        /** Push function for tag stack. */
        void pushTag ( const XMLCh* const localName );
        void popTag ();
        int  currentTag ();

        std::string getAttDataValue(
                const char* uri,
                const char* localPart,
                const xercesc::Attributes& attrs 
        );

        int getAttConstValue(
                const char* uri,
                const char* localPart,
                const xercesc::Attributes& attrs 
        );




};

#endif

---