remote_client.hpp

/** @addtogroup Network
 *  @{
 */

/**
 * Represents one single remote client. It is kept in a list, by the Server
 * object. Using the CommandHandler interface, it executes callbacks
 * upon receiving command from the client, and sends commands when
 * we need to communicate something to it.
 * @class RemoteClient
 */

#include <boost/asio.hpp>
#include <boost/bind.hpp>

#ifndef __REMOTE_CLIENT_HPP__
# define __REMOTE_CLIENT_HPP__


#include <database/user.hpp>
#include <network/command_handler.hpp>
#include <network/command.hpp>
#include <network/timed_event_handler.hpp>
#include <network/timed_event.hpp>
#include <network/transfer_sender.hpp>

class Server;

using boost::asio::ip::tcp;

class RemoteClient: public CommandHandler, public TimedEventHandler
{
public:
  RemoteClient(boost::asio::io_service&, Server*);
  ~RemoteClient();
  /**
   * starts the client (install the read handler, etc)
   */
  void start();
  /**
   * @return tcp::socket&
   */
  tcp::socket& get_socket(void);
  /**
   * The number of clients is incremented each time
   * a new client is accepted.
   */
  static unsigned long int clients_number;

  virtual void on_connection_closed();

  virtual boost::asio::io_service& get_io_service();
  /**
   * Sends a file to the remote client.
   * @param filename The file to send.
   */
  void send_file(const std::string&);
  /**
   * To be called whenever a file transfer ends.
   * Removes the TransferSender from the list.
   * @param transfer The TransferSender to remove from the list.
   */
  void on_transfer_ended(const TransferSender*);
  /**
   * Called when the client is successfully authenticated.
   * For example, checks if there are news to send, or offline messages, etc
   */
  void on_auth_success();

  User* get_user();

private:
  /**
   * Creates the default callbacks associated with a network command.
   * It is executed whenever that command is received.
   * See CommandHandler for details
   */
  void install_callbacks();
  void install_read_handler(void);
  void auth_callback(Command*);
  void transfer_callback(Command*);
  const unsigned long int number;
  /**
   * A pointer to the server, to call its method when the RemoteClient
   * has to be deleted.
   */
  Server* server;
  User* user;
  /**
   * A list of all the current file transfers with tha client.
   */
  std::vector<TransferSender*> senders;
};

#endif
/**@}*/