source: src/Fragmentation/Automation/Operations/AsyncOperation.hpp@ 267b8d

/*
 * AsyncOperation.hpp
 *
 *  Created on: Nov 11, 2011
 *      Author: heber
 */

#ifndef FRAGMENTCONTROLLER_ASYNCOPERATION_HPP_
#define FRAGMENTCONTROLLER_ASYNCOPERATION_HPP_

// include config.h
#ifdef HAVE_CONFIG_H
#include <config.h>
#endif

#include <boost/asio.hpp>
#include <boost/function.hpp>
#include <functional>
#include <string>
#include <vector>

#include "CodePatterns/Observer/Observable.hpp"

#include "Operation.hpp"

/** This class represents an asynchronous operation that is initiated by
 * calling AsyncOperation::operator() and gives an update with the Observer
 * construct when the operation has finished.
 *
 * \note Make sure that deriving classes still end the asynchronous operation
 * chain by calling AsyncOperation::handle_FinishOperation(). Otherwise the
 * update signal at operation's end is not triggered.
 */
class AsyncOperation : public Operation, public Observable {
public:
  /** Constructor for class AsyncOperation.
   *
   * \param _name name for this AsyncOperation for retrieval from a registry
   * \param _connection connection to operate on
   */
  AsyncOperation(
      const std::string &_name,
      Connection &_connection) :
    Operation(_name, _connection),
    Observable(_name)
  {}

  /** Destructor for class AsyncOperation.
   *
   */
  virtual ~AsyncOperation()
  {}

public:
  // virtual function pointer to the operation to do
  void operator()(const std::string& _host, const std::string& _service);

protected:
  // virtual function pointer to the connection handler
  virtual void handle_connect(const boost::system::error_code& e,
      boost::asio::ip::tcp::resolver::iterator endpoint_iterator) = 0;

  /// Handle completion of an operation.
  void handle_FinishOperation(const boost::system::error_code& e);

protected:
  /// internal function to disconnect from server
  void disconnect();
};

#endif /* FRAGMENTCONTROLLER_ASYNCOPERATION_HPP_ */