User Manual, Developers Guide and API Documentation

VirtualCapabilityInformationBase.hpp

Go to the documentation of this file.

/******************************************************************************
 * WiFiMac                                                                    *
 * This file is part of openWNS (open Wireless Network Simulator)
 * _____________________________________________________________________________
 *
 * Copyright (C) 2004-2007
 * Chair of Communication Networks (ComNets)
 * Kopernikusstr. 16, D-52074 Aachen, Germany
 * phone: ++49-241-80-27910,
 * fax: ++49-241-80-22242
 * email: info@openwns.org
 * www: http://www.openwns.org
 * _____________________________________________________________________________
 *
 * openWNS is free software; you can redistribute it and/or modify it under the
 * terms of the GNU Lesser General Public License version 2 as published by the
 * Free Software Foundation;
 *
 * openWNS 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 Lesser General Public License for more
 * details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 *
 ******************************************************************************/

#ifndef WIFIMAC_MANAGEMENT_VIRTUALCAPABILITYINFORMATIONBASE_HPP
#define WIFIMAC_MANAGEMENT_VIRTUALCAPABILITYINFORMATIONBASE_HPP

#include <DLL/UpperConvergence.hpp>

#include <WNS/container/Registry.hpp>
#include <WNS/container/UntypedRegistry.hpp>
#include <WNS/ldk/fun/Main.hpp>
#include <WNS/ldk/Layer.hpp>
#include <WNS/node/component/Component.hpp>
#include <WNS/logger/Logger.hpp>
#include <WNS/Singleton.hpp>


namespace wifimac { namespace management {


    typedef wns::container::UntypedRegistry<std::string> InformationBase;
    typedef wns::container::Registry<wns::service::dll::UnicastAddress, InformationBase*> NodeBase;

    class VirtualCapabilityInformationBase:
        virtual public wns::ldk::Layer,
        public wns::node::component::Component
    {
    public:
        VirtualCapabilityInformationBase(
            wns::node::Interface* _node,
            const wns::pyconfig::View& _config);

        virtual void
        doStartup()
            {};

        virtual ~VirtualCapabilityInformationBase()
        {
            delete nodeInformationBase;
            delete defaultValues;
        };

        virtual void
        onNodeCreated()
            {};

        virtual void
        onWorldCreated()
            {};

        virtual void
        onShutdown()
            {};

        bool
        knows(const wns::service::dll::UnicastAddress adr, const std::string& key) const;

        bool
        knows(const wns::service::dll::UnicastAddress adr) const;

        template <typename T>
        T
        get(const wns::service::dll::UnicastAddress adr, const std::string& key) const
        {
            assure(this->knows(adr, key), "Cannot get unknown information of node " << adr << " with key " << key);

            InformationBase* myIB;
            if(nodeInformationBase->knows(adr))
            {
                myIB = nodeInformationBase->find(adr);
                if(not myIB->knows(key))
                {
                    myIB = this->defaultValues;
                }
            }
            else
            {
                myIB = this->defaultValues;
            }

            MESSAGE_SINGLE(NORMAL, logger, "Query for node " << adr << ", key " << key << " --> " << myIB->find<T>(key));

            return(myIB->find<T>(key));
        } // get

        InformationBase*
        getAll(const wns::service::dll::UnicastAddress adr) const;

        template <typename T>
        void
        set(const wns::service::dll::UnicastAddress adr, const std::string& key, const T value)
        {
            if(not nodeInformationBase->knows(adr))
            {
                // first time information about this node is added
                nodeInformationBase->insert(adr, new InformationBase());
            }

            if(nodeInformationBase->find(adr)->knows(key))
            {
                throw wns::Exception("Cannot set the same information twice");
            }

            InformationBase* i = nodeInformationBase->find(adr);
        i->insert<T>(key, value);

            MESSAGE_SINGLE(NORMAL, logger, "Node " << adr << " inserted key " << key << " with value " << value);
        } // set

    private:
        wns::logger::Logger logger;

        NodeBase* nodeInformationBase;

        InformationBase* defaultValues;
    };

    class VirtualCapabilityInformationBaseService {
    public:
        VirtualCapabilityInformationBaseService();

        VirtualCapabilityInformationBase*
        getVCIB();

        void
        setVCIB(VirtualCapabilityInformationBase* _vcib);

    private:
        wns::logger::Logger logger;
        VirtualCapabilityInformationBase* vcib;
    };

    typedef wns::SingletonHolder<VirtualCapabilityInformationBaseService> TheVCIBService;

} // management
} // wifimac

#endif

---