User Manual, Developers Guide and API Documentation

Interface.hpp

Go to the documentation of this file.

/*******************************************************************************
 * 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 WNS_NODE_INTERFACE_HPP
#define WNS_NODE_INTERFACE_HPP

#include <WNS/node/component/FQSN.hpp>
#include <WNS/pyconfig/View.hpp>
#include <WNS/Assure.hpp>
#include <WNS/probe/bus/ContextProviderCollection.hpp>

namespace wns{ namespace service {
    class Service;
}}


namespace wns { namespace node {


    class Interface
    {
    public:
        Interface()
        {}

        virtual
        ~Interface()
        {}

        virtual void
        addService(const std::string& name, service::Service* si) = 0;

        virtual void
        startup() = 0;

        virtual void
        onWorldCreated() = 0;

        virtual void
        onShutdown() = 0;

        template <typename SERVICETYPE>
        SERVICETYPE
        getService(const std::string& serviceName) const
        {
            return getRemoteService<SERVICETYPE>(wns::node::component::FQSN(getName(), serviceName));
        }

        template <typename SERVICETYPE>
        SERVICETYPE
        getRemoteService(const component::FQSN& fqsn) const
        {
            wns::service::Service* si = getAnyService(fqsn);
            assureType(si, SERVICETYPE);
            // we can't use C-Style downcasts here!
            return dynamic_cast<SERVICETYPE>(si);
        }

        virtual probe::bus::ContextProviderCollection&
        getContextProviderCollection() = 0;

        virtual std::string
        getName() const = 0;

        virtual unsigned int
        getNodeID() const = 0;

        virtual bool
        isEqual(Interface* second) const
        { assure(second!=NULL,"operand==NULL");
          return getNodeID()==second->getNodeID(); };

    private:
        virtual wns::service::Service*
        getAnyService(const component::FQSN& fqsn) const = 0;

        // Disallow Copy Constructor
        Interface(const Interface&);
    };

} // node
} // wns

#endif

/*
  Local Variables:
  mode: c++
  fill-column: 80
  c-basic-offset: 8
  c-tab-always-indent: t
  indent-tabs-mode: t
  tab-width: 8
  End:
*/

---