forked from Kistler-Group/sdbus-cpp
316 lines
10 KiB
C++
316 lines
10 KiB
C++
/**
|
|
* (C) 2016 - 2021 KISTLER INSTRUMENTE AG, Winterthur, Switzerland
|
|
* (C) 2016 - 2022 Stanislav Angelovic <stanislav.angelovic@protonmail.com>
|
|
*
|
|
* @file StandardInterfaces.h
|
|
*
|
|
* Created on: Dec 13, 2016
|
|
* Project: sdbus-c++
|
|
* Description: High-level D-Bus IPC C++ library based on sd-bus
|
|
*
|
|
* This file is part of sdbus-c++.
|
|
*
|
|
* sdbus-c++ is free software; you can redistribute it and/or modify it
|
|
* under the terms of the GNU Lesser General Public License as published by
|
|
* the Free Software Foundation, either version 2.1 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* sdbus-c++ is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public License
|
|
* along with sdbus-c++. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef SDBUS_CXX_STANDARDINTERFACES_H_
|
|
#define SDBUS_CXX_STANDARDINTERFACES_H_
|
|
|
|
#include <sdbus-c++/IObject.h>
|
|
#include <sdbus-c++/IProxy.h>
|
|
#include <sdbus-c++/Types.h>
|
|
#include <string>
|
|
#include <map>
|
|
#include <vector>
|
|
|
|
namespace sdbus {
|
|
|
|
// Proxy for peer
|
|
class Peer_proxy
|
|
{
|
|
static constexpr const char* INTERFACE_NAME = "org.freedesktop.DBus.Peer";
|
|
|
|
protected:
|
|
Peer_proxy(sdbus::IProxy& proxy)
|
|
: proxy_(proxy)
|
|
{
|
|
}
|
|
|
|
~Peer_proxy() = default;
|
|
|
|
public:
|
|
void Ping()
|
|
{
|
|
proxy_.callMethod("Ping").onInterface(INTERFACE_NAME);
|
|
}
|
|
|
|
std::string GetMachineId()
|
|
{
|
|
std::string machineUUID;
|
|
proxy_.callMethod("GetMachineId").onInterface(INTERFACE_NAME).storeResultsTo(machineUUID);
|
|
return machineUUID;
|
|
}
|
|
|
|
private:
|
|
sdbus::IProxy& proxy_;
|
|
};
|
|
|
|
// Proxy for introspection
|
|
class Introspectable_proxy
|
|
{
|
|
static constexpr const char* INTERFACE_NAME = "org.freedesktop.DBus.Introspectable";
|
|
|
|
protected:
|
|
Introspectable_proxy(sdbus::IProxy& proxy)
|
|
: proxy_(proxy)
|
|
{
|
|
}
|
|
|
|
~Introspectable_proxy() = default;
|
|
|
|
public:
|
|
std::string Introspect()
|
|
{
|
|
std::string xml;
|
|
proxy_.callMethod("Introspect").onInterface(INTERFACE_NAME).storeResultsTo(xml);
|
|
return xml;
|
|
}
|
|
|
|
private:
|
|
sdbus::IProxy& proxy_;
|
|
};
|
|
|
|
// Proxy for properties
|
|
class Properties_proxy
|
|
{
|
|
static constexpr const char* INTERFACE_NAME = "org.freedesktop.DBus.Properties";
|
|
|
|
protected:
|
|
Properties_proxy(sdbus::IProxy& proxy)
|
|
: proxy_(proxy)
|
|
{
|
|
proxy_
|
|
.uponSignal("PropertiesChanged")
|
|
.onInterface(INTERFACE_NAME)
|
|
.call([this]( const std::string& interfaceName
|
|
, const std::map<std::string, sdbus::Variant>& changedProperties
|
|
, const std::vector<std::string>& invalidatedProperties )
|
|
{
|
|
this->onPropertiesChanged(interfaceName, changedProperties, invalidatedProperties);
|
|
});
|
|
}
|
|
|
|
~Properties_proxy() = default;
|
|
|
|
virtual void onPropertiesChanged( const std::string& interfaceName
|
|
, const std::map<std::string, sdbus::Variant>& changedProperties
|
|
, const std::vector<std::string>& invalidatedProperties ) = 0;
|
|
|
|
public:
|
|
sdbus::Variant Get(const std::string& interfaceName, const std::string& propertyName)
|
|
{
|
|
return proxy_.getProperty(propertyName).onInterface(interfaceName);
|
|
}
|
|
|
|
void Set(const std::string& interfaceName, const std::string& propertyName, const sdbus::Variant& value)
|
|
{
|
|
proxy_.setProperty(propertyName).onInterface(interfaceName).toValue(value);
|
|
}
|
|
|
|
std::map<std::string, sdbus::Variant> GetAll(const std::string& interfaceName)
|
|
{
|
|
std::map<std::string, sdbus::Variant> props;
|
|
proxy_.callMethod("GetAll").onInterface(INTERFACE_NAME).withArguments(interfaceName).storeResultsTo(props);
|
|
return props;
|
|
}
|
|
|
|
private:
|
|
sdbus::IProxy& proxy_;
|
|
};
|
|
|
|
// Proxy for object manager
|
|
class ObjectManager_proxy
|
|
{
|
|
static constexpr const char* INTERFACE_NAME = "org.freedesktop.DBus.ObjectManager";
|
|
|
|
protected:
|
|
ObjectManager_proxy(sdbus::IProxy& proxy)
|
|
: proxy_(proxy)
|
|
{
|
|
proxy_
|
|
.uponSignal("InterfacesAdded")
|
|
.onInterface(INTERFACE_NAME)
|
|
.call([this]( const sdbus::ObjectPath& objectPath
|
|
, const std::map<std::string, std::map<std::string, sdbus::Variant>>& interfacesAndProperties )
|
|
{
|
|
this->onInterfacesAdded(objectPath, interfacesAndProperties);
|
|
});
|
|
|
|
proxy_
|
|
.uponSignal("InterfacesRemoved")
|
|
.onInterface(INTERFACE_NAME)
|
|
.call([this]( const sdbus::ObjectPath& objectPath
|
|
, const std::vector<std::string>& interfaces )
|
|
{
|
|
this->onInterfacesRemoved(objectPath, interfaces);
|
|
});
|
|
}
|
|
|
|
~ObjectManager_proxy() = default;
|
|
|
|
virtual void onInterfacesAdded( const sdbus::ObjectPath& objectPath
|
|
, const std::map<std::string, std::map<std::string, sdbus::Variant>>& interfacesAndProperties) = 0;
|
|
virtual void onInterfacesRemoved( const sdbus::ObjectPath& objectPath
|
|
, const std::vector<std::string>& interfaces) = 0;
|
|
|
|
public:
|
|
std::map<sdbus::ObjectPath, std::map<std::string, std::map<std::string, sdbus::Variant>>> GetManagedObjects()
|
|
{
|
|
std::map<sdbus::ObjectPath, std::map<std::string, std::map<std::string, sdbus::Variant>>> objectsInterfacesAndProperties;
|
|
proxy_.callMethod("GetManagedObjects").onInterface(INTERFACE_NAME).storeResultsTo(objectsInterfacesAndProperties);
|
|
return objectsInterfacesAndProperties;
|
|
}
|
|
|
|
private:
|
|
sdbus::IProxy& proxy_;
|
|
};
|
|
|
|
// Adaptors for the above-listed standard D-Bus interfaces are not necessary because the functionality
|
|
// is provided by underlying libsystemd implementation. The exception is Properties_adaptor,
|
|
// ObjectManager_adaptor and ManagedObject_adaptor, which provide convenience functionality to emit signals.
|
|
|
|
// Adaptor for properties
|
|
class Properties_adaptor
|
|
{
|
|
static constexpr const char* INTERFACE_NAME = "org.freedesktop.DBus.Properties";
|
|
|
|
protected:
|
|
Properties_adaptor(sdbus::IObject& object)
|
|
: object_(object)
|
|
{
|
|
}
|
|
|
|
~Properties_adaptor() = default;
|
|
|
|
public:
|
|
void emitPropertiesChangedSignal(const std::string& interfaceName, const std::vector<std::string>& properties)
|
|
{
|
|
object_.emitPropertiesChangedSignal(interfaceName, properties);
|
|
}
|
|
|
|
void emitPropertiesChangedSignal(const std::string& interfaceName)
|
|
{
|
|
object_.emitPropertiesChangedSignal(interfaceName);
|
|
}
|
|
|
|
private:
|
|
sdbus::IObject& object_;
|
|
};
|
|
|
|
/*!
|
|
* @brief Object Manager Convenience Adaptor
|
|
*
|
|
* Adding this class as _Interfaces.. template parameter of class AdaptorInterfaces
|
|
* implements the *GetManagedObjects()* method of the [org.freedesktop.DBus.ObjectManager.GetManagedObjects](https://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-objectmanager)
|
|
* interface.
|
|
*
|
|
* Note that there can be multiple object managers in a path hierarchy. InterfacesAdded/InterfacesRemoved
|
|
* signals are sent from the closest object manager at either the same path or the closest parent path of an object.
|
|
*/
|
|
class ObjectManager_adaptor
|
|
{
|
|
static constexpr const char* INTERFACE_NAME = "org.freedesktop.DBus.ObjectManager";
|
|
|
|
protected:
|
|
explicit ObjectManager_adaptor(sdbus::IObject& object)
|
|
: object_(object)
|
|
{
|
|
object_.addObjectManager();
|
|
}
|
|
|
|
~ObjectManager_adaptor() = default;
|
|
|
|
private:
|
|
sdbus::IObject& object_;
|
|
};
|
|
|
|
/*!
|
|
* @brief Managed Object Convenience Adaptor
|
|
*
|
|
* Adding this class as _Interfaces.. template parameter of class AdaptorInterfaces
|
|
* will extend the resulting object adaptor with emitInterfacesAddedSignal()/emitInterfacesRemovedSignal()
|
|
* according to org.freedesktop.DBus.ObjectManager.InterfacesAdded/.InterfacesRemoved.
|
|
*
|
|
* Note that objects which implement this adaptor require an object manager (e.g via ObjectManager_adaptor) to be
|
|
* instantiated on one of it's parent object paths or the same path. InterfacesAdded/InterfacesRemoved
|
|
* signals are sent from the closest object manager at either the same path or the closest parent path of an object.
|
|
*/
|
|
class ManagedObject_adaptor
|
|
{
|
|
protected:
|
|
explicit ManagedObject_adaptor(sdbus::IObject& object) : object_(object)
|
|
{
|
|
}
|
|
|
|
~ManagedObject_adaptor() = default;
|
|
|
|
public:
|
|
/*!
|
|
* @brief Emits InterfacesAdded signal for this object path
|
|
*
|
|
* See IObject::emitInterfacesAddedSignal().
|
|
*/
|
|
void emitInterfacesAddedSignal()
|
|
{
|
|
object_.emitInterfacesAddedSignal();
|
|
}
|
|
|
|
/*!
|
|
* @brief Emits InterfacesAdded signal for this object path
|
|
*
|
|
* See IObject::emitInterfacesAddedSignal().
|
|
*/
|
|
void emitInterfacesAddedSignal(const std::vector<std::string>& interfaces)
|
|
{
|
|
object_.emitInterfacesAddedSignal(interfaces);
|
|
}
|
|
|
|
/*!
|
|
* @brief Emits InterfacesRemoved signal for this object path
|
|
*
|
|
* See IObject::emitInterfacesRemovedSignal().
|
|
*/
|
|
void emitInterfacesRemovedSignal()
|
|
{
|
|
object_.emitInterfacesRemovedSignal();
|
|
}
|
|
|
|
/*!
|
|
* @brief Emits InterfacesRemoved signal for this object path
|
|
*
|
|
* See IObject::emitInterfacesRemovedSignal().
|
|
*/
|
|
void emitInterfacesRemovedSignal(const std::vector<std::string>& interfaces)
|
|
{
|
|
object_.emitInterfacesRemovedSignal(interfaces);
|
|
}
|
|
|
|
private:
|
|
sdbus::IObject& object_;
|
|
};
|
|
|
|
}
|
|
|
|
#endif /* SDBUS_CXX_STANDARDINTERFACES_H_ */
|