wamp_invocation.hpp

//
// Copyright (c) Crossbar.io Technologies GmbH and contributors
//
// Boost Software License - Version 1.0 - August 17th, 2003
//
// Permission is hereby granted, free of charge, to any person or organization
// obtaining a copy of the software and accompanying documentation covered by
// this license (the "Software") to use, reproduce, display, distribute,
// execute, and transmit the Software, and to prepare derivative works of the
// Software, and to permit third-parties to whom the Software is furnished to
// do so, all subject to the following:
//
// The copyright notices in the Software and this entire statement, including
// the above license grant, this restriction and the following disclaimer,
// must be included in all copies of the Software, in whole or in part, and
// all derivative works of the Software, unless such copies or derivative
// works are solely in the form of machine-executable object code generated by
// a source language processor.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
// SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
// FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
// ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
// DEALINGS IN THE SOFTWARE.
//

#ifndef AUTOBAHN_WAMP_INVOCATION_HPP
#define AUTOBAHN_WAMP_INVOCATION_HPP

#include "wamp_arguments.hpp"

#include <cstdint>
#include <functional>
#include <memory>
#include <msgpack.hpp>
#include <string>

namespace autobahn {

class wamp_message;

class wamp_invocation_impl
{
public:
    wamp_invocation_impl();
    wamp_invocation_impl(wamp_invocation_impl&&) = delete; // copy wamp_invocation instead

    //add URI and details
    const std::string& uri() const;
    std::size_t number_of_arguments() const;

    std::size_t number_of_kw_arguments() const;

    template <typename T>
    T argument(std::size_t index) const;

    template <typename List>
    List arguments() const;

    template <typename List>
    void get_arguments(List& args) const;

    template <typename... T>
    inline void get_each_argument(T&... args) const;

    template <typename T>
    T kw_argument(const std::string& key) const;

    template <typename T>
    T kw_argument(const char* key) const;

    template <typename T>
    T kw_argument_or(const std::string& key, const T& fallback) const;

    template <typename T>
    T kw_argument_or(const char* key, const T& fallback) const;

    template <typename Map>
    Map kw_arguments() const;

    template <typename Map>
    void get_kw_arguments(Map& kw_args) const;

    template <typename T>
    T detail(const std::string& key) const;

    template <typename T>
    T detail(const char* key) const;

    template <typename T>
    T detail_or(const std::string& key, const T& fallback) const;

    template <typename T>
    T detail_or(const char* key, const T& fallback) const;

    template <typename Map>
    Map details() const;

    template <typename Map>
    void get_details(Map& details) const;
    bool progressive_results_expected() const;

    void empty_result();

    template <typename List>
    void progress(const List& arguments);

    template <typename List, typename Map>
    void progress(const List& arguments, const Map& kw_arguments);

    template <typename List>
    void result(const List& arguments);

    template <typename List, typename Map>
    void result(const List& arguments, const Map& kw_arguments);

    void error(const std::string& error_uri);

    template <typename List>
    void error(const std::string& error_uri, const List& arguments);

    template <typename List, typename Map>
    void error(
            const std::string& error_uri,
            const List& arguments, const Map& kw_arguments);

    //
    // functions only called internally by wamp_session

    using result_type = enum {
        final = 0,
        intermediary
    } ;

    using send_result_fn = std::function<void(const std::shared_ptr<wamp_message>&)>;
    void set_send_result_fn(send_result_fn&&);
    void set_details(const msgpack::object& details);
    void set_request_id(std::uint64_t);
    void set_zone(msgpack::zone&&);
    void set_arguments(const msgpack::object& arguments);
    void set_kw_arguments(const msgpack::object& kw_arguments);
    bool sendable() const;

private:
    void throw_if_not_sendable() const;

    template <typename List>
    void send_result(const List& arguments, result_type resultType);

    template <typename List, typename Map>
    void send_result(const List& arguments, const Map& kw_arguments, result_type resultType);
private:


    msgpack::zone m_zone;
    msgpack::object m_arguments;
    msgpack::object m_kw_arguments;
    msgpack::object m_details;
    send_result_fn m_send_result_fn;
    std::uint64_t m_request_id;
    std::string m_uri;
    bool m_progressive_results_expected;
};

using wamp_invocation = std::shared_ptr<wamp_invocation_impl>;

} // namespace autobahn

#include "wamp_invocation.ipp"

#endif // AUTOBAHN_WAMP_INVOCATION_HPP