ServiceRequester.hpp

/***************************************************************************
  tag: The SourceWorks  Tue Sep 7 00:55:18 CEST 2010  ServiceRequester.hpp

                        ServiceRequester.hpp -  description
                           -------------------
    begin                : Tue September 07 2010
    copyright            : (C) 2010 The SourceWorks
    email                : peter@thesourceworks.com

 ***************************************************************************
 *   This library 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;                 *
 *   version 2 of the License.                                             *
 *                                                                         *
 *   As a special exception, you may use this file as part of a free       *
 *   software library without restriction.  Specifically, if other files   *
 *   instantiate templates or use macros or inline functions from this     *
 *   file, or you compile this file and link it with other files to        *
 *   produce an executable, this file does not by itself cause the         *
 *   resulting executable to be covered by the GNU General Public          *
 *   License.  This exception does not however invalidate any other        *
 *   reasons why the executable file might be covered by the GNU General   *
 *   Public License.                                                       *
 *                                                                         *
 *   This library 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 General Public             *
 *   License along with this library; if not, write to the Free Software   *
 *   Foundation, Inc., 59 Temple Place,                                    *
 *   Suite 330, Boston, MA  02111-1307  USA                                *
 *                                                                         *
 ***************************************************************************/


#ifndef ORO_SERVICEREQUESTER_HPP_
#define ORO_SERVICEREQUESTER_HPP_

#include "rtt-config.h"
#include "rtt-fwd.hpp"
#include "base/OperationCallerBaseInvoker.hpp"
#include "Service.hpp"
#include <map>
#include <vector>
#include <string>

namespace RTT
{
    class RTT_API ServiceRequester
    {
    public:
        typedef std::vector<std::string> RequesterNames;
        typedef std::vector<std::string> OperationCallerNames;
        ServiceRequester(const std::string& name, TaskContext* owner = 0);
        virtual ~ServiceRequester();

        const std::string& getRequestName() const { return mrname; }

        RequesterNames getRequesterNames() const;

        TaskContext* getServiceOwner() const { return mrowner; }

        Service::shared_ptr getReferencedService();

        bool addOperationCaller( base::OperationCallerBaseInvoker& mbi);

        OperationCallerNames getOperationCallerNames() const;

        base::OperationCallerBaseInvoker* getOperationCaller(const std::string& name);

        ServiceRequester* requires() { return this; }

        ServiceRequester* requires(const std::string& service_name) {
            ServiceRequester* sp = mrequests[service_name];
            if (sp)
                return sp;
            sp = new ServiceRequester(service_name, mrowner);
            mrequests[service_name] = sp;
            return sp;
        }

        bool requiresService(const std::string& service_name) {
            return mrequests.find(service_name) != mrequests.end();
        }

        bool connectTo(Service::shared_ptr sp);

        bool ready() const;

        void disconnect();

    protected:
        typedef std::map< std::string, ServiceRequester* > Requests;
        Requests mrequests;

        typedef std::map<std::string, base::OperationCallerBaseInvoker*> OperationCallers;
        OperationCallers mmethods;

        std::string mrname;
        TaskContext* mrowner;
        Service::shared_ptr mprovider;
    };
}

#endif /* ORO_SERVICEREQUESTER_HPP_ */