pxmlw6n2f/Gazebo_Distributed/gazebo/msgs/MsgFactory.hh

91 lines
2.9 KiB
C++

/*
* Copyright (C) 2012 Open Source Robotics Foundation
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*/
#ifndef _MSGFACTORY_HH_
#define _MSGFACTORY_HH_
#include <string>
#include <map>
#include <vector>
#include <google/protobuf/message.h>
#include <boost/shared_ptr.hpp>
#include "gazebo/util/system.hh"
namespace gazebo
{
namespace msgs
{
/// \def MsgFactoryFn
/// \brief Prototype for message factory generation
typedef boost::shared_ptr<google::protobuf::Message> (*MsgFactoryFn) ();
/// \addtogroup gazebo_msgs Messages
/// \{
/// \class MsgFactory MsgFactory.hh msgs/msgs.hh
/// \brief A factory that generates protobuf message based on a string
/// type.
class GAZEBO_VISIBLE MsgFactory
{
/// \brief Register a message.
/// \param[in] _msgType Type of message to register.
/// \param[in] _factoryfn Function that generates the message.
public: static void RegisterMsg(const std::string &_msgType,
MsgFactoryFn _factoryfn);
/// \brief Create a new instance of a message.
/// \param[in] _msgType Type of message to create.
/// \return Pointer to a google protobuf message. Null if the message
/// type could not be handled.
public: static boost::shared_ptr<google::protobuf::Message> NewMsg(
const std::string &_msgType);
/// \brief Get all the message types
/// \param[out] _types Vector of strings of the message types.
public: static void GetMsgTypes(std::vector<std::string> &_types);
/// \brief A list of registered message types
private: static std::map<std::string, MsgFactoryFn> *msgMap;
};
/// \brief Static message registration macro
///
/// Use this macro to register messages.
/// \param[in] _msgtype Message type name.
/// \param[in] _classname Class name for message.
#define GZ_REGISTER_STATIC_MSG(_msgtype, _classname) \
GAZEBO_VISIBLE \
boost::shared_ptr<google::protobuf::Message> New##_classname() \
{ \
return boost::shared_ptr<gazebo::msgs::_classname>(\
new gazebo::msgs::_classname); \
} \
class GAZEBO_VISIBLE Msg##_classname \
{ \
public: Msg##_classname() \
{ \
gazebo::msgs::MsgFactory::RegisterMsg(_msgtype, New##_classname);\
} \
}; \
static Msg##_classname GzMsgInitializer;
/// \}
}
}
#endif