sdbusplus/message.hpp

#pragma once

#include <memory>
#include <systemd/sd-bus.h>
#include <sdbusplus/message/append.hpp>
#include <sdbusplus/message/read.hpp>

namespace sdbusplus
{

    // Forward declare sdbusplus::bus::bus for 'friend'ship.
namespace bus { struct bus; };

namespace message
{

using msgp_t = sd_bus_message*;
class message;

namespace details
{

/** @brief unique_ptr functor to release a msg reference. */
struct MsgDeleter
{
    void operator()(msgp_t ptr) const
    {
        sd_bus_message_unref(ptr);
    }
};

/* @brief Alias 'msg' to a unique_ptr type for auto-release. */
using msg = std::unique_ptr<sd_bus_message, MsgDeleter>;

} // namespace details

/** @class message
 *  @brief Provides C++ bindings to the sd_bus_message_* class functions.
 */
struct message
{
        /* Define all of the basic class operations:
         *     Not allowed:
         *         - Default constructor to avoid nullptrs.
         *         - Copy operations due to internal unique_ptr.
         *     Allowed:
         *         - Move operations.
         *         - Destructor.
         */
    message() = delete;
    message(const message&) = delete;
    message& operator=(const message&) = delete;
    message(message&&) = default;
    message& operator=(message&&) = default;
    ~message() = default;

    /** @brief Conversion constructor for 'msgp_t'.
     *
     *  Takes ownership of the msg-pointer and releases it when done.
     */
    explicit message(msgp_t m) : _msg(m) {}

    /** @brief Release ownership of the stored msg-pointer. */
    msgp_t release() { return _msg.release(); }

    /** @brief Check if message contains a real pointer. (non-nullptr). */
    explicit operator bool() const { return bool(_msg); }


    /** @brief Perform sd_bus_message_append, with automatic type deduction.
     *
     *  @tparam ...Args - Type of items to append to message.
     *  @param[in] args - Items to append to message.
     */
    template <typename ...Args> void append(Args&&... args)
    {
        sdbusplus::message::append(_msg.get(), std::forward<Args>(args)...);
    }

    /** @brief Perform sd_bus_message_read, with automatic type deduction.
     *
     *  @tparam ...Args - Type of items to read from message.
     *  @param[out] args - Items to read from message.
     */
    template <typename ...Args> void read(Args&&... args)
    {
        sdbusplus::message::read(_msg.get(), std::forward<Args>(args)...);
    }

    /** @brief Get the signature of a message.
     *
     *  @return A [weak] pointer to the signature of the message.
     */
    const char* get_signature()
    {
        return sd_bus_message_get_signature(_msg.get(), true);
    }

    /** @brief Check if message is a method call for an interface/method.
     *
     *  @param[in] interface - The interface to match.
     *  @param[in] method - The method to match.
     *
     *  @return True - if message is a method call for interface/method.
     */
    bool is_method_call(const char* interface, const char* method)
    {
        return sd_bus_message_is_method_call(_msg.get(), interface, method);
    }

    /** @brief Create a 'method_return' type message from an existing message.
     *
     *  @return method-return message.
     */
    message new_method_return()
    {
        msgp_t reply = nullptr;
        sd_bus_message_new_method_return(this->get(), &reply);

        return message(reply);
    }

    /** @brief Perform a 'method-return' response call. */
    void method_return()
    {
        auto b = sd_bus_message_get_bus(this->get());
        sd_bus_send(b, this->get(), nullptr);
    }

    friend struct sdbusplus::bus::bus;

    private:
        /** @brief Get a pointer to the owned 'msgp_t'. */
        msgp_t get() { return _msg.get(); }
        details::msg _msg;
};

} // namespace message

} // namespace sdbusplus