wesnothd_connection.hpp

Go to the documentation of this file.

/*
   Copyright (C) 2011 - 2018 by Sergey Popov <loonycyborg@gmail.com>
   Part of the Battle for Wesnoth Project https://www.wesnoth.org/

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2 of the License, or
   (at your option) any later version.
   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY.

   See the COPYING file for more details.
*/

#pragma once

#ifdef _WIN32

#ifdef INADDR_ANY
#undef INADDR_ANY
#endif

#ifdef INADDR_BROADCAST
#undef INADDR_BROADCAST
#endif

#ifdef INADDR_NONE
#undef INADDR_NONE
#endif

#endif // endif _WIN32

#include "configr_assign.hpp"
#include "wesnothd_connection_error.hpp"

#if BOOST_VERSION >= 106600
#include <boost/asio/io_context.hpp>
#else
#include <boost/asio/io_service.hpp>
#endif
#include <boost/asio/ip/tcp.hpp>
#include <boost/asio/streambuf.hpp>

#include <condition_variable>
#include <deque>
#include <future>
#include <list>
#include <mutex>
#include <queue>
#include <thread>

class config;

union data_union {
    char binary[4];
    uint32_t num;
};

/** A class that represents a TCP/IP connection to the wesnothd server. */
class wesnothd_connection
{
public:
    using error = wesnothd_connection_error;

    wesnothd_connection(const wesnothd_connection&) = delete;
    wesnothd_connection& operator=(const wesnothd_connection&) = delete;

    ~wesnothd_connection();

    /**
     * Constructor.
     *
     * @param host        Name of the host to connect to
     * @param service     Service identifier such as "80" or "http"
     */
    wesnothd_connection(const std::string& host, const std::string& service);

    /**
     * Queues the given data to be sent to the server.
     *
     * @param request     The data to send
     */
    void send_data(const configr_of& request);

    /**
     * Receives the next pending data pack from the server, if available.
     *
     * @param result      The object to which the received data will be written.
     * @returns           True if any data was available, false otherwise.
     */
    bool receive_data(config& result);

    /**
     * Unlike @ref receive_data, waits until data is available instead of returning immediately.
     *
     * @param data        Config object passed to @ref receive_data
     * @returns           True, since data will always be available.
     */
    bool wait_and_receive_data(config& data);

    /** Waits until the server handshake is complete. */
    void wait_for_handshake();

    void cancel();

    void stop();

    std::size_t bytes_to_write() const
    {
        return bytes_to_write_;
    }

    std::size_t bytes_written() const
    {
        return bytes_written_;
    }

    std::size_t bytes_to_read() const
    {
        return bytes_to_read_;
    }

    std::size_t bytes_read() const
    {
        return bytes_read_;
    }

    bool has_data_received() const
    {
        return !recv_queue_.empty();
    }

    bool is_sending_data() const
    {
        return !send_queue_.empty();
    }

private:
    std::thread worker_thread_;

#if BOOST_VERSION >= 106600
    boost::asio::io_context io_context_;
#else
    boost::asio::io_service io_context_;
#endif

    typedef boost::asio::ip::tcp::resolver resolver;
    resolver resolver_;

    typedef boost::asio::ip::tcp::socket socket;
    socket socket_;

    boost::system::error_code last_error_;

    std::mutex last_error_mutex_;

    std::promise<void> handshake_finished_;

    boost::asio::streambuf read_buf_;

#if BOOST_VERSION >= 106600
    using results_type = resolver::results_type;
    using endpoint = const boost::asio::ip::tcp::endpoint&;
#else
    using results_type = resolver::iterator;
    using endpoint = resolver::iterator;
#endif

    void handle_resolve(const boost::system::error_code& ec, results_type results);
    void handle_connect(const boost::system::error_code& ec, endpoint endpoint);

    void handshake();
    void handle_handshake(const boost::system::error_code& ec);

    data_union handshake_response_;

    std::size_t is_write_complete(const boost::system::error_code& error, std::size_t bytes_transferred);
    void handle_write(const boost::system::error_code& ec, std::size_t bytes_transferred);

    std::size_t is_read_complete(const boost::system::error_code& error, std::size_t bytes_transferred);
    void handle_read(const boost::system::error_code& ec, std::size_t bytes_transferred);

    void send();
    void recv();

    template<typename T>
    using data_queue = std::queue<T, std::list<T>>;

#if BOOST_VERSION >= 106600
    data_queue<std::unique_ptr<boost::asio::streambuf>> send_queue_;
#else
    data_queue<std::shared_ptr<boost::asio::streambuf>> send_queue_;
#endif
    data_queue<config> recv_queue_;

    std::mutex recv_queue_mutex_;

    std::condition_variable recv_queue_lock_;

    uint32_t payload_size_;

    // TODO: do i need to guard the following 4 values with a mutex?
    std::size_t bytes_to_write_;
    std::size_t bytes_written_;
    std::size_t bytes_to_read_;
    std::size_t bytes_read_;
};