sdbusplus/bus/match.hpp

#pragma once

#include <functional>
#include <memory>
#include <string>
#include <sdbusplus/slot.hpp>
#include <sdbusplus/bus.hpp>
#include <sdbusplus/message.hpp>

namespace sdbusplus
{

namespace bus
{

namespace match
{

struct match
{
    /* 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.
     */
    match() = delete;
    match(const match&) = delete;
    match& operator=(const match&) = delete;
    match(match&&) = default;
    match& operator=(match&&) = default;
    ~match() = default;

    /** @brief Register a signal match.
     *
     *  @param[in] bus - The bus to register on.
     *  @param[in] match - The match to register.
     *  @param[in] handler - The callback for matches.
     *  @param[in] context - An optional context to pass to the handler.
     */
    match(sdbusplus::bus::bus& bus, const char* match,
          sd_bus_message_handler_t handler, void* context = nullptr)
                : _slot(nullptr)
    {
        sd_bus_slot* slot = nullptr;
        sd_bus_add_match(bus.get(), &slot, match, handler, context);

        _slot = decltype(_slot){slot};
    }
    match(sdbusplus::bus::bus& bus, const std::string& _match,
          sd_bus_message_handler_t handler, void* context = nullptr)
                : match(bus, _match.c_str(), handler, context) {}

    using callback_t = std::function<void(sdbusplus::message::message&)>;

    /** @brief Register a signal match.
     *
     *  @param[in] bus - The bus to register on.
     *  @param[in] match - The match to register.
     *  @param[in] callback - The callback for matches.
     */
    match(sdbusplus::bus::bus& bus, const char* match,
          callback_t callback)
                : _slot(nullptr),
                  _callback(std::make_unique<callback_t>(std::move(callback)))
    {
        sd_bus_slot* slot = nullptr;
        sd_bus_add_match(bus.get(), &slot, match, callCallback,
                         _callback.get());

        _slot = decltype(_slot){slot};
    }
    match(sdbusplus::bus::bus& bus, const std::string& _match,
          callback_t callback)
                : match(bus, _match.c_str(), callback) {}

    private:
        slot::slot _slot;
        std::unique_ptr<callback_t> _callback = nullptr;

        static int callCallback(sd_bus_message *m, void* context,
                                sd_bus_error* e)
        {
            auto c = static_cast<callback_t*>(context);
            message::message message{m};

            (*c)(message);

            return 0;
        }
};

/** Utilities for defining match rules based on the DBus specification */
namespace rules
{

using namespace std::string_literals;

namespace type
{

inline auto signal() { return "type='signal',"s; }
inline auto method() { return "type='method',"s; }
inline auto method_return() { return "type='method_return',"s; }
inline auto error() { return "type='error',"s; }

} // namespace type

inline auto sender(const std::string& s) { return "sender='"s + s + "',"; }
inline auto interface(const std::string& s)
        { return "interface='"s + s + "',"; }
inline auto member(const std::string& s) { return "member='"s + s + "',"; }
inline auto path(const std::string& s) { return "path='"s + s + "',"; }
inline auto path_namespace(const std::string& s)
        { return "path_namespace='"s + s + "',"; }
inline auto destination(const std::string& s)
        { return "destination='"s + s + "',"; }
inline auto argN(size_t n, const std::string& s)
        { return "arg"s + std::to_string(n) + "='"s + s + "',"; }
inline auto argNpath(size_t n, const std::string& s)
        { return "arg"s + std::to_string(n) + "path='"s + s + "',"; }
inline auto arg0namespace(const std::string& s)
        { return "arg0namespace='"s + s + "',"; }
inline auto eavesdrop() { return "eavesdrop='true',"s; }

inline auto nameOwnerChanged()
{
    return "type='signal',"
           "sender='org.freedesktop.DBus',"
           "member='NameOwnerChanged',"s;
}

inline auto interfacesAdded()
{
    return "type='signal',"
           "interface='org.freedesktop.DBus.ObjectManager',"
           "member='InterfacesAdded',"s;
}

inline auto interfacesRemoved()
{
    return "type='signal',"
           "interface='org.freedesktop.DBus.ObjectManager',"
           "member='InterfacesRemoved',"s;
}

inline auto interfacesAdded(const std::string& p)
{
    return interfacesAdded() + path(p);
}

inline auto interfacesRemoved(const std::string& p)
{
    return interfacesRemoved() + path(p);
}

inline auto propertiesChanged(const std::string& p, const std::string& i)
{
    return type::signal() +
           path(p) +
           member("PropertiesChanged"s) +
           interface("org.freedesktop.DBus.Properties"s) +
           argN(0, i);
}

/**
 * @brief Constructs a NameOwnerChanged match string for a service name
 *
 * @param[in] s - Service name
 *
 * @return NameOwnerChanged match string for a service name
 */
inline auto nameOwnerChanged(const std::string& s)
{
    return nameOwnerChanged() + argN(0, s);
}

} // namespace rules
} // namespace match

using match_t = match::match;

} // namespace bus
} // namespace sdbusplus