publication.h
Go to the documentation of this file.
00001 /*
00002  * Copyright (C) 2008, Morgan Quigley and Willow Garage, Inc.
00003  *
00004  * Redistribution and use in source and binary forms, with or without
00005  * modification, are permitted provided that the following conditions are met:
00006  *   * Redistributions of source code must retain the above copyright notice,
00007  *     this list of conditions and the following disclaimer.
00008  *   * Redistributions in binary form must reproduce the above copyright
00009  *     notice, this list of conditions and the following disclaimer in the
00010  *     documentation and/or other materials provided with the distribution.
00011  *   * Neither the names of Stanford University or Willow Garage, Inc. nor the names of its
00012  *     contributors may be used to endorse or promote products derived from
00013  *     this software without specific prior written permission.
00014  *
00015  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
00016  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
00017  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
00018  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
00019  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
00020  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
00021  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
00022  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
00023  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
00024  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
00025  * POSSIBILITY OF SUCH DAMAGE.
00026  */
00027 
00028 #ifndef ROSCPP_PUBLICATION_H
00029 #define ROSCPP_PUBLICATION_H
00030 
00031 #include "ros/forwards.h"
00032 #include "ros/advertise_options.h"
00033 #include "common.h"
00034 #include "XmlRpc.h"
00035 
00036 #include <boost/thread/mutex.hpp>
00037 
00038 #include <boost/shared_ptr.hpp>
00039 #include <boost/shared_array.hpp>
00040 
00041 #include <vector>
00042 
00043 namespace ros
00044 {
00045 
00046 class SubscriberLink;
00047 typedef boost::shared_ptr<SubscriberLink> SubscriberLinkPtr;
00048 typedef std::vector<SubscriberLinkPtr> V_SubscriberLink;
00049 
00053 class ROSCPP_DECL Publication
00054 {
00055 public:
00056   Publication(const std::string &name,
00057             const std::string& datatype,
00058             const std::string& _md5sum,
00059             const std::string& message_definition,
00060             size_t max_queue,
00061             bool latch,
00062             bool has_header);
00063 
00064   ~Publication();
00065 
00066   void addCallbacks(const SubscriberCallbacksPtr& callbacks);
00067   void removeCallbacks(const SubscriberCallbacksPtr& callbacks);
00068 
00072   bool enqueueMessage(const SerializedMessage& m);
00076   inline size_t getMaxQueue() { return max_queue_; }
00080   XmlRpc::XmlRpcValue getStats();
00084   void getInfo(XmlRpc::XmlRpcValue& info);
00085 
00089   bool hasSubscribers();
00093   uint32_t getNumSubscribers();
00094 
00095   void getPublishTypes(bool& serialize, bool& nocopy, const std::type_info& ti);
00096 
00100   const std::string& getName() const { return name_; }
00104   const std::string& getDataType() const { return datatype_; }
00108   const std::string& getMD5Sum() const { return md5sum_; }
00112   const std::string& getMessageDefinition() const { return message_definition_; }
00116   uint32_t getSequence() { return seq_; }
00117 
00118   bool isLatched() { return latch_; }
00119 
00123   void addSubscriberLink(const SubscriberLinkPtr& sub_link);
00127   void removeSubscriberLink(const SubscriberLinkPtr& sub_link);
00128 
00132   void drop();
00136   bool isDropped() { return dropped_; }
00137 
00138   uint32_t incrementSequence();
00139 
00140   size_t getNumCallbacks();
00141 
00142   bool isLatching() { return latch_; }
00143 
00144   void publish(SerializedMessage& m);
00145   void processPublishQueue();
00146 
00147   bool validateHeader(const Header& h, std::string& error_msg);
00148 
00149 private:
00150   void dropAllConnections();
00151 
00155   void peerConnect(const SubscriberLinkPtr& sub_link);
00159   void peerDisconnect(const SubscriberLinkPtr& sub_link);
00160 
00161   std::string name_;
00162   std::string datatype_;
00163   std::string md5sum_;
00164   std::string message_definition_;
00165   size_t max_queue_;
00166   uint32_t seq_;
00167   boost::mutex seq_mutex_;
00168 
00169   typedef std::vector<SubscriberCallbacksPtr> V_Callback;
00170   V_Callback callbacks_;
00171   boost::mutex callbacks_mutex_;
00172 
00173   V_SubscriberLink subscriber_links_;
00174   // We use a recursive mutex here for the rare case that a publish call causes another one (like in the case of a rosconsole call)
00175   boost::mutex subscriber_links_mutex_;
00176 
00177   bool dropped_;
00178 
00179   bool latch_;
00180   bool has_header_;
00181   SerializedMessage last_message_;
00182 
00183   uint32_t intraprocess_subscriber_count_;
00184 
00185   typedef std::vector<SerializedMessage> V_SerializedMessage;
00186   V_SerializedMessage publish_queue_;
00187   boost::mutex publish_queue_mutex_;
00188 };
00189 
00190 }
00191 
00192 #endif // ROSCPP_PUBLICATION_H


roscpp
Author(s): Morgan Quigley mquigley@cs.stanford.edu, Josh Faust jfaust@willowgarage.com, Brian Gerkey gerkey@willowgarage.com, Troy Straszheim straszheim@willowgarage.com
autogenerated on Sat Dec 28 2013 17:35:52