/** * (C) 2016 - 2021 KISTLER INSTRUMENTE AG, Winterthur, Switzerland * (C) 2016 - 2024 Stanislav Angelovic * * @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 . */ #ifndef SDBUS_CXX_STANDARDINTERFACES_H_ #define SDBUS_CXX_STANDARDINTERFACES_H_ #include #include #include #include #include #include #include namespace sdbus { // Proxy for peer class Peer_proxy { static inline const char* INTERFACE_NAME = "org.freedesktop.DBus.Peer"; protected: Peer_proxy(sdbus::IProxy& proxy) : m_proxy(proxy) { } Peer_proxy(const Peer_proxy&) = delete; Peer_proxy& operator=(const Peer_proxy&) = delete; Peer_proxy(Peer_proxy&&) = delete; Peer_proxy& operator=(Peer_proxy&&) = delete; ~Peer_proxy() = default; void registerProxy() { } public: void Ping() { m_proxy.callMethod("Ping").onInterface(INTERFACE_NAME); } std::string GetMachineId() { std::string machineUUID; m_proxy.callMethod("GetMachineId").onInterface(INTERFACE_NAME).storeResultsTo(machineUUID); return machineUUID; } private: sdbus::IProxy& m_proxy; }; // Proxy for introspection class Introspectable_proxy { static inline const char* INTERFACE_NAME = "org.freedesktop.DBus.Introspectable"; protected: Introspectable_proxy(sdbus::IProxy& proxy) : m_proxy(proxy) { } Introspectable_proxy(const Introspectable_proxy&) = delete; Introspectable_proxy& operator=(const Introspectable_proxy&) = delete; Introspectable_proxy(Introspectable_proxy&&) = delete; Introspectable_proxy& operator=(Introspectable_proxy&&) = delete; ~Introspectable_proxy() = default; void registerProxy() { } public: std::string Introspect() { std::string xml; m_proxy.callMethod("Introspect").onInterface(INTERFACE_NAME).storeResultsTo(xml); return xml; } private: sdbus::IProxy& m_proxy; }; // Proxy for properties class Properties_proxy { static inline const char* INTERFACE_NAME = "org.freedesktop.DBus.Properties"; protected: Properties_proxy(sdbus::IProxy& proxy) : m_proxy(proxy) { } Properties_proxy(const Properties_proxy&) = delete; Properties_proxy& operator=(const Properties_proxy&) = delete; Properties_proxy(Properties_proxy&&) = delete; Properties_proxy& operator=(Properties_proxy&&) = delete; ~Properties_proxy() = default; void registerProxy() { m_proxy .uponSignal("PropertiesChanged") .onInterface(INTERFACE_NAME) .call([this]( const InterfaceName& interfaceName , const std::map& changedProperties , const std::vector& invalidatedProperties ) { this->onPropertiesChanged(interfaceName, changedProperties, invalidatedProperties); }); } virtual void onPropertiesChanged( const InterfaceName& interfaceName , const std::map& changedProperties , const std::vector& invalidatedProperties ) = 0; public: sdbus::Variant Get(const InterfaceName& interfaceName, const PropertyName& propertyName) { return m_proxy.getProperty(propertyName).onInterface(interfaceName); } sdbus::Variant Get(std::string_view interfaceName, std::string_view propertyName) { return m_proxy.getProperty(propertyName).onInterface(interfaceName); } template PendingAsyncCall GetAsync(const InterfaceName& interfaceName, const PropertyName& propertyName, _Function&& callback) { return m_proxy.getPropertyAsync(propertyName).onInterface(interfaceName).uponReplyInvoke(std::forward<_Function>(callback)); } template [[nodiscard]] Slot GetAsync(const InterfaceName& interfaceName, const PropertyName& propertyName, _Function&& callback, return_slot_t) { return m_proxy.getPropertyAsync(propertyName).onInterface(interfaceName).uponReplyInvoke(std::forward<_Function>(callback), return_slot); } std::future GetAsync(const InterfaceName& interfaceName, const PropertyName& propertyName, with_future_t) { return m_proxy.getPropertyAsync(propertyName).onInterface(interfaceName).getResultAsFuture(); } template PendingAsyncCall GetAsync(std::string_view interfaceName, std::string_view propertyName, _Function&& callback) { return m_proxy.getPropertyAsync(propertyName).onInterface(interfaceName).uponReplyInvoke(std::forward<_Function>(callback)); } template [[nodiscard]] Slot GetAsync(std::string_view interfaceName, std::string_view propertyName, _Function&& callback, return_slot_t) { return m_proxy.getPropertyAsync(propertyName).onInterface(interfaceName).uponReplyInvoke(std::forward<_Function>(callback), return_slot); } std::future GetAsync(std::string_view interfaceName, std::string_view propertyName, with_future_t) { return m_proxy.getPropertyAsync(propertyName).onInterface(interfaceName).getResultAsFuture(); } void Set(const InterfaceName& interfaceName, const PropertyName& propertyName, const sdbus::Variant& value) { m_proxy.setProperty(propertyName).onInterface(interfaceName).toValue(value); } void Set(std::string_view interfaceName, const std::string_view propertyName, const sdbus::Variant& value) { m_proxy.setProperty(propertyName).onInterface(interfaceName).toValue(value); } void Set(const InterfaceName& interfaceName, const PropertyName& propertyName, const sdbus::Variant& value, dont_expect_reply_t) { m_proxy.setProperty(propertyName).onInterface(interfaceName).toValue(value, dont_expect_reply); } void Set(std::string_view interfaceName, const std::string_view propertyName, const sdbus::Variant& value, dont_expect_reply_t) { m_proxy.setProperty(propertyName).onInterface(interfaceName).toValue(value, dont_expect_reply); } template PendingAsyncCall SetAsync(const InterfaceName& interfaceName, const PropertyName& propertyName, const sdbus::Variant& value, _Function&& callback) { return m_proxy.setPropertyAsync(propertyName).onInterface(interfaceName).toValue(value).uponReplyInvoke(std::forward<_Function>(callback)); } template [[nodiscard]] Slot SetAsync(const InterfaceName& interfaceName, const PropertyName& propertyName, const sdbus::Variant& value, _Function&& callback, return_slot_t) { return m_proxy.setPropertyAsync(propertyName).onInterface(interfaceName).toValue(value).uponReplyInvoke(std::forward<_Function>(callback), return_slot); } std::future SetAsync(const InterfaceName& interfaceName, const PropertyName& propertyName, const sdbus::Variant& value, with_future_t) { return m_proxy.setPropertyAsync(propertyName).onInterface(interfaceName).toValue(value).getResultAsFuture(); } template PendingAsyncCall SetAsync(std::string_view interfaceName, std::string_view propertyName, const sdbus::Variant& value, _Function&& callback) { return m_proxy.setPropertyAsync(propertyName).onInterface(interfaceName).toValue(value).uponReplyInvoke(std::forward<_Function>(callback)); } template [[nodiscard]] Slot SetAsync(std::string_view interfaceName, std::string_view propertyName, const sdbus::Variant& value, _Function&& callback, return_slot_t) { return m_proxy.setPropertyAsync(propertyName).onInterface(interfaceName).toValue(value).uponReplyInvoke(std::forward<_Function>(callback), return_slot); } std::future SetAsync(std::string_view interfaceName, std::string_view propertyName, const sdbus::Variant& value, with_future_t) { return m_proxy.setPropertyAsync(propertyName).onInterface(interfaceName).toValue(value).getResultAsFuture(); } std::map GetAll(const InterfaceName& interfaceName) { return m_proxy.getAllProperties().onInterface(interfaceName); } std::map GetAll(std::string_view interfaceName) { return m_proxy.getAllProperties().onInterface(interfaceName); } template PendingAsyncCall GetAllAsync(const InterfaceName& interfaceName, _Function&& callback) { return m_proxy.getAllPropertiesAsync().onInterface(interfaceName).uponReplyInvoke(std::forward<_Function>(callback)); } template [[nodiscard]] Slot GetAllAsync(const InterfaceName& interfaceName, _Function&& callback, return_slot_t) { return m_proxy.getAllPropertiesAsync().onInterface(interfaceName).uponReplyInvoke(std::forward<_Function>(callback), return_slot); } std::future> GetAllAsync(const InterfaceName& interfaceName, with_future_t) { return m_proxy.getAllPropertiesAsync().onInterface(interfaceName).getResultAsFuture(); } template PendingAsyncCall GetAllAsync(std::string_view interfaceName, _Function&& callback) { return m_proxy.getAllPropertiesAsync().onInterface(interfaceName).uponReplyInvoke(std::forward<_Function>(callback)); } template [[nodiscard]] Slot GetAllAsync(std::string_view interfaceName, _Function&& callback, return_slot_t) { return m_proxy.getAllPropertiesAsync().onInterface(interfaceName).uponReplyInvoke(std::forward<_Function>(callback), return_slot); } std::future> GetAllAsync(std::string_view interfaceName, with_future_t) { return m_proxy.getAllPropertiesAsync().onInterface(interfaceName).getResultAsFuture(); } private: sdbus::IProxy& m_proxy; }; // Proxy for object manager class ObjectManager_proxy { static inline const char* INTERFACE_NAME = "org.freedesktop.DBus.ObjectManager"; protected: ObjectManager_proxy(sdbus::IProxy& proxy) : m_proxy(proxy) { } ObjectManager_proxy(const ObjectManager_proxy&) = delete; ObjectManager_proxy& operator=(const ObjectManager_proxy&) = delete; ObjectManager_proxy(ObjectManager_proxy&&) = delete; ObjectManager_proxy& operator=(ObjectManager_proxy&&) = delete; ~ObjectManager_proxy() = default; void registerProxy() { m_proxy .uponSignal("InterfacesAdded") .onInterface(INTERFACE_NAME) .call([this]( const sdbus::ObjectPath& objectPath , const std::map>& interfacesAndProperties ) { this->onInterfacesAdded(objectPath, interfacesAndProperties); }); m_proxy .uponSignal("InterfacesRemoved") .onInterface(INTERFACE_NAME) .call([this]( const sdbus::ObjectPath& objectPath , const std::vector& interfaces ) { this->onInterfacesRemoved(objectPath, interfaces); }); } virtual void onInterfacesAdded( const sdbus::ObjectPath& objectPath , const std::map>& interfacesAndProperties) = 0; virtual void onInterfacesRemoved( const sdbus::ObjectPath& objectPath , const std::vector& interfaces) = 0; public: std::map>> GetManagedObjects() { std::map>> objectsInterfacesAndProperties; m_proxy.callMethod("GetManagedObjects").onInterface(INTERFACE_NAME).storeResultsTo(objectsInterfacesAndProperties); return objectsInterfacesAndProperties; } template PendingAsyncCall GetManagedObjectsAsync(_Function&& callback) { return m_proxy.callMethodAsync("GetManagedObjects").onInterface(INTERFACE_NAME).uponReplyInvoke(std::forward<_Function>(callback)); } template [[nodiscard]] Slot GetManagedObjectsAsync(_Function&& callback, return_slot_t) { return m_proxy.callMethodAsync("GetManagedObjects").onInterface(INTERFACE_NAME).uponReplyInvoke(std::forward<_Function>(callback), return_slot); } std::future>>> GetManagedObjectsAsync(with_future_t) { return m_proxy.callMethodAsync("GetManagedObjects").onInterface(INTERFACE_NAME).getResultAsFuture>>>(); } private: sdbus::IProxy& m_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 inline const char* INTERFACE_NAME = "org.freedesktop.DBus.Properties"; protected: Properties_adaptor(sdbus::IObject& object) : m_object(object) { } Properties_adaptor(const Properties_adaptor&) = delete; Properties_adaptor& operator=(const Properties_adaptor&) = delete; Properties_adaptor(Properties_adaptor&&) = delete; Properties_adaptor& operator=(Properties_adaptor&&) = delete; ~Properties_adaptor() = default; void registerAdaptor() { } public: void emitPropertiesChangedSignal(const InterfaceName& interfaceName, const std::vector& properties) { m_object.emitPropertiesChangedSignal(interfaceName, properties); } void emitPropertiesChangedSignal(const char* interfaceName, const std::vector& properties) { m_object.emitPropertiesChangedSignal(interfaceName, properties); } void emitPropertiesChangedSignal(const InterfaceName& interfaceName) { m_object.emitPropertiesChangedSignal(interfaceName); } void emitPropertiesChangedSignal(const char* interfaceName) { m_object.emitPropertiesChangedSignal(interfaceName); } private: sdbus::IObject& m_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 inline const char* INTERFACE_NAME = "org.freedesktop.DBus.ObjectManager"; protected: explicit ObjectManager_adaptor(sdbus::IObject& object) : m_object(object) { } ObjectManager_adaptor(const ObjectManager_adaptor&) = delete; ObjectManager_adaptor& operator=(const ObjectManager_adaptor&) = delete; ObjectManager_adaptor(ObjectManager_adaptor&&) = delete; ObjectManager_adaptor& operator=(ObjectManager_adaptor&&) = delete; ~ObjectManager_adaptor() = default; void registerAdaptor() { m_object.addObjectManager(); } private: sdbus::IObject& m_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) : m_object(object) { } ManagedObject_adaptor(const ManagedObject_adaptor&) = delete; ManagedObject_adaptor& operator=(const ManagedObject_adaptor&) = delete; ManagedObject_adaptor(ManagedObject_adaptor&&) = delete; ManagedObject_adaptor& operator=(ManagedObject_adaptor&&) = delete; ~ManagedObject_adaptor() = default; void registerAdaptor() { } public: /*! * @brief Emits InterfacesAdded signal for this object path * * See IObject::emitInterfacesAddedSignal(). */ void emitInterfacesAddedSignal() { m_object.emitInterfacesAddedSignal(); } /*! * @brief Emits InterfacesAdded signal for this object path * * See IObject::emitInterfacesAddedSignal(). */ void emitInterfacesAddedSignal(const std::vector& interfaces) { m_object.emitInterfacesAddedSignal(interfaces); } /*! * @brief Emits InterfacesRemoved signal for this object path * * See IObject::emitInterfacesRemovedSignal(). */ void emitInterfacesRemovedSignal() { m_object.emitInterfacesRemovedSignal(); } /*! * @brief Emits InterfacesRemoved signal for this object path * * See IObject::emitInterfacesRemovedSignal(). */ void emitInterfacesRemovedSignal(const std::vector& interfaces) { m_object.emitInterfacesRemovedSignal(interfaces); } private: sdbus::IObject& m_object; }; } #endif /* SDBUS_CXX_STANDARDINTERFACES_H_ */