cxmlelement.h

//==========================================================================
//  CXMLELEMENT.H - part of
//                     OMNeT++/OMNEST
//            Discrete System Simulation in C++
//
// Contents:
//   class cXMLElement
//
//==========================================================================

/*--------------------------------------------------------------*
  Copyright (C) 2002-2008 Andras Varga
  Copyright (C) 2006-2008 OpenSim Ltd.

  This file is distributed WITHOUT ANY WARRANTY. See the file
  `license' for details on this and other legal matters.
*--------------------------------------------------------------*/

#ifndef __CXMLELEMENT_H
#define __CXMLELEMENT_H

#include <string>
#include <map>
#include <vector>
#include "simkerneldefs.h"
#include "cenvir.h"

NAMESPACE_BEGIN

class cXMLElement;
class cModule;

typedef std::vector<cXMLElement*> cXMLElementList;

typedef std::map<std::string,std::string> cXMLAttributeMap;


class SIM_API cXMLElement
{
  public:
    class SIM_API ParamResolver
    {
      public:
        virtual bool resolve(const char *paramname, std::string& value) = 0;
        virtual ~ParamResolver() {}
    };

  private:
    std::string ename;
    std::string srcloc;
    std::string value;
    cXMLAttributeMap attrs;
    cXMLElement *parent;
    cXMLElement *firstchild;
    cXMLElement *lastchild;
    cXMLElement *prevsibling;
    cXMLElement *nextsibling;

  private:
     void doGetElementsByTagName(const char *tagname, cXMLElementList& list) const;

  public:
    // internal: Constructor
    cXMLElement(const char *tagname, const char *srcloc, cXMLElement *parent);

    // internal: sets text node within element
    virtual void setNodeValue(const char *s, int len);

    // internal: appends to text node within element
    virtual void appendNodeValue(const char *s, int len);

    // internal: Destructor. Destroys children too.
    virtual ~cXMLElement();

    // internal: Sets the value of the attribute with the given name.
    virtual void setAttribute(const char *attr, const char *value);

    // internal: Appends the given element at the end of the child element list.
    virtual void appendChild(cXMLElement *node);

    // internal: Inserts the given element just before the specified child element
    // in the child element list. The where element must be a child of this element.
    virtual void insertChildBefore(cXMLElement *where, cXMLElement *newnode);

    // internal: Removes the given element from the child element list.
    // The pointer passed should be a child of this element.
    virtual cXMLElement *removeChild(cXMLElement *node);

    // internal: matches from root element
    static cXMLElement *getDocumentElementByPath(cXMLElement *documentnode, const char *pathexpr, ParamResolver *resolver=NULL);

    // internal
    std::string tostr(int level) const;


    virtual const char *getTagName() const;

    virtual const char *getSourceLocation() const;

    virtual const char *getNodeValue() const;

    virtual const char *getAttribute(const char *attr) const;

    virtual bool hasAttributes() const;

    virtual const cXMLAttributeMap& getAttributes() const;

    virtual cXMLElement *getParentNode() const;

    virtual bool hasChildren() const;

    virtual cXMLElement *getFirstChild() const;

    virtual cXMLElement *getLastChild() const;

    virtual cXMLElement *getNextSibling() const;

    virtual cXMLElement *getPreviousSibling() const;

    virtual cXMLElement *getFirstChildWithTag(const char *tagname) const;

    virtual cXMLElement *getNextSiblingWithTag(const char *tagname) const;

    virtual cXMLElementList getChildren() const;

    virtual cXMLElementList getChildrenByTagName(const char *tagname) const;

    virtual cXMLElementList getElementsByTagName(const char *tagname) const;

    cXMLElement *getFirstChildWithAttribute(const char *tagname, const char *attr, const char *attrvalue=NULL) const;

    cXMLElement *getElementById(const char *idattrvalue) const;

    cXMLElement *getElementByPath(const char *pathexpression, cXMLElement *root=NULL, ParamResolver *resolver=NULL) const;

    void debugDump() const;

    virtual std::string detailedInfo() const;
};

class SIM_API ModNameParamResolver : public cXMLElement::ParamResolver
{
  protected:
    cModule *mod;
  public:
    ModNameParamResolver(cModule *mod)  {this->mod = mod;}
    virtual bool resolve(const char *paramname, std::string& value);
};

class SIM_API StringMapParamResolver : public cXMLElement::ParamResolver
{
  public:
    typedef std::map<std::string,std::string> StringMap;
  protected:
    StringMap params;
  public:
    StringMapParamResolver(const StringMap& m)  {params = m;}
    virtual bool resolve(const char *paramname, std::string& value);
};

NAMESPACE_END


#endif