TransportIface.hh
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2012-2016 Open Source Robotics Foundation
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  *
16 */
17 #ifndef _GAZEBO_TRANSPORTIFACE_HH_
18 #define _GAZEBO_TRANSPORTIFACE_HH_
19 
20 #include <boost/bind.hpp>
21 #include <string>
22 #include <list>
23 #include <map>
24 
27 #include "gazebo/transport/Node.hh"
29 
30 namespace gazebo
31 {
32  namespace transport
33  {
37 
44  GZ_TRANSPORT_VISIBLE
45  bool get_master_uri(std::string &_master_host, unsigned int &_master_port);
46 
55  GZ_TRANSPORT_VISIBLE
56  bool init(const std::string &_masterHost = "",
57  unsigned int _masterPort = 0,
58  uint32_t _timeoutIterations = 30);
59 
63  GZ_TRANSPORT_VISIBLE
64  void run();
65 
68  GZ_TRANSPORT_VISIBLE
69  void get_topic_namespaces(std::list<std::string> &_namespaces);
70 
73  GZ_TRANSPORT_VISIBLE
74  bool is_stopped();
75 
77  GZ_TRANSPORT_VISIBLE
78  void stop();
79 
81  GZ_TRANSPORT_VISIBLE
82  void fini();
83 
85  GZ_TRANSPORT_VISIBLE
86  void clear_buffers();
87 
91  GZ_TRANSPORT_VISIBLE
92  void pause_incoming(bool _pause);
93 
101  GZ_TRANSPORT_VISIBLE
102  boost::shared_ptr<msgs::Response> request(const std::string &_worldName,
103  const std::string &_request,
104  const std::string &_data = "");
105 
112  GZ_TRANSPORT_VISIBLE
113  void requestNoReply(const std::string &_worldName,
114  const std::string &_request,
115  const std::string &_data = "");
116 
122  GZ_TRANSPORT_VISIBLE
123  void requestNoReply(NodePtr _node, const std::string &_request,
124  const std::string &_data = "");
125 
132  template<typename M>
133  void publish(const std::string &_topic,
134  const google::protobuf::Message &_message)
135  {
137  node->Init();
138  node->Publish<M>(_topic, _message);
139  }
140 
144  GZ_TRANSPORT_VISIBLE
145  std::map<std::string, std::list<std::string> > getAdvertisedTopics();
146 
152  GZ_TRANSPORT_VISIBLE
153  std::list<std::string> getAdvertisedTopics(const std::string &_msgType);
154 
158  GZ_TRANSPORT_VISIBLE
159  std::string getTopicMsgType(const std::string &_topicName);
160 
163  GZ_TRANSPORT_VISIBLE
164  void setMinimalComms(bool _enabled);
165 
168  GZ_TRANSPORT_VISIBLE
169  bool getMinimalComms();
170 
173  GZ_TRANSPORT_VISIBLE
175 
179  GZ_TRANSPORT_VISIBLE
180  bool waitForNamespaces(const gazebo::common::Time &_maxWait);
182  }
183 }
184 #endif
bool init(const std::string &_masterHost="", unsigned int _masterPort=0, uint32_t _timeoutIterations=30)
Initialize the transport system.
void run()
Run the transport component.
void pause_incoming(bool _pause)
Pause or unpause incoming messages.
void fini()
Cleanup the transport component.
Forward declarations for transport.
boost::shared_ptr< Node > NodePtr
Definition: TransportTypes.hh:57
void stop()
Stop the transport component from running.
void setMinimalComms(bool _enabled)
Set whether minimal comms should be used.
boost::shared_ptr< Connection > ConnectionPtr
Definition: Connection.hh:50
std::string getTopicMsgType(const std::string &_topicName)
Get the message typename that is published on the given topic.
std::map< std::string, std::list< std::string > > getAdvertisedTopics()
Get a list of all the topics and their message types.
bool get_master_uri(std::string &_master_host, unsigned int &_master_port)
Get the hostname and port of the master from the GAZEBO_MASTER_URI environment variable.
A node can advertise and subscribe topics, publish on advertised topics and listen to subscribed topi...
Definition: Node.hh:78
void publish(const std::string &_topic, const google::protobuf::Message &_message)
A convenience function for a one-time publication of a message.
Definition: TransportIface.hh:133
transport::ConnectionPtr connectToMaster()
Create a connection to master.
bool is_stopped()
Is the transport system stopped?
void clear_buffers()
Clear any remaining communication buffers.
boost::shared_ptr< msgs::Response > request(const std::string &_worldName, const std::string &_request, const std::string &_data="")
Send a request and receive a response.
bool getMinimalComms()
Get whether minimal comms has been enabled.
bool waitForNamespaces(const gazebo::common::Time &_maxWait)
Blocks while waiting for topic namespaces from the Master.
void requestNoReply(const std::string &_worldName, const std::string &_request, const std::string &_data="")
Send a request and don't wait for a response.
void get_topic_namespaces(std::list< std::string > &_namespaces)
Return all the namespace (world names) on the master.
A Time class, can be used to hold wall- or sim-time.
Definition: Time.hh:44