service_server_link.h

Go to the documentation of this file.

/*
 * Software License Agreement (BSD License)
 *
 *  Copyright (c) 2008, Willow Garage, Inc.
 *  All rights reserved.
 *
 *  Redistribution and use in source and binary forms, with or without
 *  modification, are permitted provided that the following conditions
 *  are met:
 *
 *   * Redistributions of source code must retain the above copyright
 *     notice, this list of conditions and the following disclaimer.
 *   * Redistributions in binary form must reproduce the above
 *     copyright notice, this list of conditions and the following
 *     disclaimer in the documentation and/or other materials provided
 *     with the distribution.
 *   * Neither the name of Willow Garage, Inc. nor the names of its
 *     contributors may be used to endorse or promote products derived
 *     from this software without specific prior written permission.
 *
 *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 *  "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 *  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
 *  FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
 *  COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
 *  INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
 *  BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
 *  LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
 *  CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 *  LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
 *  ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 *  POSSIBILITY OF SUCH DAMAGE.
 */
 
#ifndef ROSCPP_SERVICE_SERVER_LINK_H
#define ROSCPP_SERVICE_SERVER_LINK_H
 
#include "ros/common.h"
 
#include <boost/thread/condition_variable.hpp>
#include <boost/thread/mutex.hpp>
#include <boost/shared_array.hpp>
#include <boost/enable_shared_from_this.hpp>
#include <boost/thread.hpp>
 
#include <queue>
 
namespace ros
{
class Header;
class Message;
class Connection;
typedef boost::shared_ptr<Connection> ConnectionPtr;
 
class ROSCPP_DECL ServiceServerLink : public boost::enable_shared_from_this<ServiceServerLink>
{
private:
  struct CallInfo
  {
    SerializedMessage req_;
    SerializedMessage* resp_;
 
    bool finished_;
    boost::condition_variable finished_condition_;
    boost::mutex finished_mutex_;
    boost::thread::id caller_thread_id_;
 
    bool success_;
    bool call_finished_;
 
    std::string exception_string_;
  };
  typedef boost::shared_ptr<CallInfo> CallInfoPtr;
  typedef std::queue<CallInfoPtr> Q_CallInfo;
 
public:
  typedef std::map<std::string, std::string> M_string;
  ServiceServerLink(const std::string& service_name, bool persistent, const std::string& request_md5sum, const std::string& response_md5sum, const M_string& header_values);
  virtual ~ServiceServerLink();
 
  //
  bool initialize(const ConnectionPtr& connection);
 
  bool isValid() const;
  bool isPersistent() const { return persistent_; }
 
  const ConnectionPtr& getConnection() const { return connection_; }
 
  const std::string& getServiceName() const { return service_name_; }
  const std::string& getRequestMD5Sum() const { return request_md5sum_; }
  const std::string& getResponseMD5Sum() const { return response_md5sum_; }
 
  bool call(const SerializedMessage& req, SerializedMessage& resp);
 
private:
  void onConnectionDropped(const ConnectionPtr& conn);
  bool onHeaderReceived(const ConnectionPtr& conn, const Header& header);
 
  void callFinished();
  void processNextCall();
  void clearCalls();
  void cancelCall(const CallInfoPtr& info);
 
  void onHeaderWritten(const ConnectionPtr& conn);
  void onRequestWritten(const ConnectionPtr& conn);
  void onResponseOkAndLength(const ConnectionPtr& conn, const boost::shared_array<uint8_t>& buffer, uint32_t size, bool success);
  void onResponse(const ConnectionPtr& conn, const boost::shared_array<uint8_t>& buffer, uint32_t size, bool success);
 
  ConnectionPtr connection_;
  std::string service_name_;
  bool persistent_;
  std::string request_md5sum_;
  std::string response_md5sum_;
 
  M_string extra_outgoing_header_values_;
  bool header_written_;
  bool header_read_;
 
  Q_CallInfo call_queue_;
  boost::mutex call_queue_mutex_;
 
  CallInfoPtr current_call_;
 
  bool dropped_;
};
typedef boost::shared_ptr<ServiceServerLink> ServiceServerLinkPtr;
 
} // namespace ros
 
#endif // ROSCPP_SERVICE_SERVER_LINK_H