Identifier.h

Go to the documentation of this file.

/*
 *   ORXONOX - the hottest 3D action shooter ever to exist
 *                    > www.orxonox.net <
 *
 *
 *   License notice:
 *
 *   This program is free software; you can redistribute it and/or
 *   modify it under the terms of the GNU General Public License
 *   as published by the Free Software Foundation; either version 2
 *   of the License, or (at your option) any later version.
 *
 *   This program is distributed in the hope that it will be useful,
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *   GNU General Public License for more details.
 *
 *   You should have received a copy of the GNU General Public License
 *   along with this program; if not, write to the Free Software
 *   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 *
 *   Author:
 *      Fabian 'x3n' Landau
 *   Co-authors:
 *      ...
 *
 */

#ifndef _Identifier_H__
#define _Identifier_H__

#include "core/CorePrereqs.h"

#include <cassert>
#include <map>
#include <set>
#include <string>
#include <typeinfo>
#include <loki/TypeTraits.h>

#include "util/Output.h"
#include "util/OrxAssert.h"
#include "core/object/ObjectList.h"
#include "core/object/Listable.h"
#include "core/object/Context.h"
#include "core/object/Destroyable.h"
#include "core/object/WeakPtr.h"
#include "IdentifierManager.h"
#include "Super.h"

namespace orxonox
{
    // ###############################
    // ###       Identifier        ###
    // ###############################
    class _CoreExport Identifier : public Destroyable
    {
        public:
            struct InheritsFrom 
            {
                virtual ~InheritsFrom() {}
                virtual Identifier* getParent() const = 0;
            };

        public:
            Identifier(const std::string& name, Factory* factory, bool bLoadable);
            virtual ~Identifier();

            // non-copyable:
            Identifier(const Identifier&) = delete;
            Identifier& operator=(const Identifier&) = delete;

            inline const std::string& getName() const { return this->name_; }

            virtual const std::type_info& getTypeInfo() = 0;

            inline uint32_t getNetworkID() const { return this->networkID_; }
            void setNetworkID(uint32_t id);

            ORX_FORCEINLINE unsigned int getClassID() const { return this->classID_; }

            inline bool hasFactory() const { return (this->factory_ != nullptr); }

            Identifiable* fabricate(Context* context);

            inline bool isLoadable() const { return this->bLoadable_; }

            inline bool isVirtualBase() const { return this->bIsVirtualBase_; }
            inline void setVirtualBase(bool bIsVirtualBase) { this->bIsVirtualBase_ = bIsVirtualBase; }

            inline bool isInitialized() const { return this->bInitialized_; }

            virtual void destroyObjects() = 0;

            virtual bool canDynamicCastObjectToIdentifierClass(Identifiable* object) const = 0;

            static bool initConfigValues_s; // TODO: this is a hack - remove it as soon as possible


            Identifier& inheritsFrom(InheritsFrom* directParent);

            void initializeParents(const std::list<const Identifier*>& initializationTrace);
            void finishInitialization();
            void reset();

            bool isA(const Identifier* identifier) const;
            bool isExactlyA(const Identifier* identifier) const;
            bool isChildOf(const Identifier* identifier) const;
            bool isDirectChildOf(const Identifier* identifier) const;
            bool isParentOf(const Identifier* identifier) const;
            bool isDirectParentOf(const Identifier* identifier) const;

            inline const std::list<const Identifier*>& getDirectParents() const { return this->directParents_; }
            inline const std::list<const Identifier*>& getParents() const { return this->parents_; }

            inline const std::set<const Identifier*>& getDirectChildren() const { return this->directChildren_; }
            inline const std::set<const Identifier*>& getChildren() const { return this->children_; }


            virtual void updateConfigValues(bool updateChildren = true) const = 0;

            inline bool hasConfigValues() const { return this->bHasConfigValues_; }

            void addConfigValueContainer(const std::string& varname, ConfigValueContainer* container);
            ConfigValueContainer* getConfigValueContainer(const std::string& varname);


            inline const std::map<std::string, XMLPortParamContainer*>& getXMLPortParamMap() const { return this->xmlportParamContainers_; }

            inline const std::map<std::string, XMLPortObjectContainer*>& getXMLPortObjectMap() const { return this->xmlportObjectContainers_; }

            void addXMLPortParamContainer(const std::string& paramname, XMLPortParamContainer* container);
            XMLPortParamContainer* getXMLPortParamContainer(const std::string& paramname);

            void addXMLPortObjectContainer(const std::string& sectionname, XMLPortObjectContainer* container);
            XMLPortObjectContainer* getXMLPortObjectContainer(const std::string& sectionname);

        protected:
            virtual void createSuperFunctionCaller() const = 0;

        private:
            void verifyIdentifierTrace() const;
            void addIfNotExists(std::list<const Identifier*>& list, const Identifier* identifierToAdd) const;

            std::list<const InheritsFrom*> manualDirectParents_;            
            std::list<const Identifier*> directParents_;                    
            std::list<const Identifier*> parents_;                          

            std::set<const Identifier*> directChildren_;                   
            std::set<const Identifier*> children_;                         

            bool bInitialized_;                                            
            bool bLoadable_;                                               
            bool bIsVirtualBase_;                                          
            std::string name_;                                             
            Factory* factory_;                                             
            uint32_t networkID_;                                           
            unsigned int classID_;                                         

            bool bHasConfigValues_;                                        
            std::map<std::string, ConfigValueContainer*> configValues_;    

            std::map<std::string, XMLPortParamContainer*> xmlportParamContainers_;     
            std::map<std::string, XMLPortObjectContainer*> xmlportObjectContainers_;   
    };

    _CoreExport std::ostream& operator<<(std::ostream& out, const std::set<const Identifier*>& list);


    // ###############################
    // ###     ClassIdentifier     ###
    // ###############################
    template <class T>
    class ClassIdentifier : public Identifier
    {
        static_assert(std::is_base_of<Identifiable, T>::value, "ClassIdentifier can only be used with Identifiables");

        #ifndef DOXYGEN_SHOULD_SKIP_THIS
          #define SUPER_INTRUSIVE_DECLARATION_INCLUDE
          #include "Super.h"
        #endif

        public:
            ClassIdentifier(const std::string& name, Factory* factory, bool bLoadable) : Identifier(name, factory, bLoadable)
            {
                OrxVerify(ClassIdentifier<T>::classIdentifier_s == nullptr, "Assertion failed in ClassIdentifier of type " << typeid(T).name());
                ClassIdentifier<T>::classIdentifier_s = this;

                SuperFunctionInitialization<0, T>::initialize(this);
            }
            ~ClassIdentifier()
            {
                SuperFunctionDestruction<0, T>::destroy(this);
            }

            bool initializeObject(T* object);

            virtual void updateConfigValues(bool updateChildren = true) const override;

            virtual const std::type_info& getTypeInfo() override
                { return typeid(T); }

            virtual bool canDynamicCastObjectToIdentifierClass(Identifiable* object) const override
                { return dynamic_cast<T*>(object) != nullptr; }

            virtual void destroyObjects() override;

            static ClassIdentifier<T>* getIdentifier();

        private:
            // non-copyable:
            ClassIdentifier(const ClassIdentifier<T>&) = delete;
            ClassIdentifier& operator=(const ClassIdentifier<T>&) = delete;

            void setConfigValues(T* object, Configurable*) const;
            void setConfigValues(T* object, Identifiable*) const;

            void addObjectToList(T* object, Listable*);
            void addObjectToList(T* object, Identifiable*);

            void destroyObjects(Listable*);
            void destroyObjects(void*);

            void destroyObject(Destroyable* object);
            void destroyObject(void* object);

            void updateConfigValues(bool updateChildren, Listable*) const;
            void updateConfigValues(bool updateChildren, Identifiable*) const;

            static WeakPtr<ClassIdentifier<T>> classIdentifier_s;
    };

    template <class T>
    WeakPtr<ClassIdentifier<T>> ClassIdentifier<T>::classIdentifier_s;

    template <class T>
    /*static*/ inline ClassIdentifier<T>* ClassIdentifier<T>::getIdentifier()
    {
        if (ClassIdentifier<T>::classIdentifier_s == nullptr)
            ClassIdentifier<T>::classIdentifier_s = (ClassIdentifier<T>*) IdentifierManager::getInstance().getIdentifierByTypeInfo(typeid(T));

        OrxVerify(ClassIdentifier<T>::classIdentifier_s != nullptr, "Did you forget to register the class of type " << typeid(T).name() << "?");
        return ClassIdentifier<T>::classIdentifier_s;
    }

    template <class T>
    bool ClassIdentifier<T>::initializeObject(T* object)
    {
        orxout(verbose, context::object_list) << "Register Object: " << this->getName() << endl;

        object->identifier_ = this;
        if (IdentifierManager::getInstance().isCreatingHierarchy())
        {
            IdentifierManager::getInstance().createdObject(object);

            if (Identifier::initConfigValues_s)
                this->setConfigValues(object, object);

            return true;
        }
        else
        {
            this->addObjectToList(object, object);

            // Add pointer of type T to the map in the Identifiable instance that enables "dynamic_casts"
            object->objectPointers_.emplace_back(this->getClassID(), static_cast<void*>(object));
            return false;
        }
    }

    template <class T>
    void ClassIdentifier<T>::setConfigValues(T* object, Configurable*) const
    {
        object->setConfigValues();
    }

    template <class T>
    void ClassIdentifier<T>::setConfigValues(T*, Identifiable*) const
    {
        // no action
    }

    template <class T>
    void ClassIdentifier<T>::addObjectToList(T* object, Listable* listable)
    {
        if (listable->getContext())
            listable->getContext()->addObject(object);
    }

    template <class T>
    void ClassIdentifier<T>::addObjectToList(T*, Identifiable*)
    {
        // no action
    }

    template <class T>
    void ClassIdentifier<T>::destroyObjects()
    {
        this->destroyObjects((T*)nullptr);
    }

    template <class T>
    void ClassIdentifier<T>::destroyObjects(Listable*)
    {
        ObjectList<T> list(Context::getRootContext()->getObjectList(this));
        for (typename ObjectList<T>::iterator it = list.begin(); it != list.end(); )
            this->destroyObject(*(it++));
    }

    template <class T>
    void ClassIdentifier<T>::destroyObjects(void*)
    {
        // no action
    }

    template <class T>
    void ClassIdentifier<T>::destroyObject(Destroyable* object)
    {
        object->destroy();
    }

    template <class T>
    void ClassIdentifier<T>::destroyObject(void* object)
    {
        delete static_cast<Identifiable*>(object);
    }

    template <class T>
    void ClassIdentifier<T>::updateConfigValues(bool updateChildren) const
    {
        this->updateConfigValues(updateChildren, static_cast<T*>(nullptr));
    }

    template <class T>
    void ClassIdentifier<T>::updateConfigValues(bool updateChildren, Listable*) const
    {
        if (!this->hasConfigValues())
            return;

        for (T* object : ObjectList<T>())
            this->setConfigValues(object, object);

        if (updateChildren)
            for (const Identifier* child : this->getChildren())
                child->updateConfigValues(false);
    }

    template <class T>
    void ClassIdentifier<T>::updateConfigValues(bool updateChildren, Identifiable*) const
    {
        // no action
    }


    // ###############################
    // ###      orxonox_cast       ###
    // ###############################
    template <class T, class U>
    ORX_FORCEINLINE T orxonox_cast(U* source)
    {
#ifdef ORXONOX_COMPILER_MSVC
        typedef Loki::TypeTraits<typename Loki::TypeTraits<T>::PointeeType>::NonConstType ClassType;
        if (source != nullptr)
            return source->template getDerivedPointer<ClassType>(ClassIdentifier<ClassType>::getIdentifier()->getClassID());
        else
            return nullptr;
#else
        return dynamic_cast<T>(source);
#endif
    }
}

#endif /* _Identifier_H__ */