Struct InterfaceRef

pub struct InterfaceRef<I> { /* private fields */ }

Wrapper over an interface, along with its corresponding SignalContext instance. A reference to the underlying interface may be obtained via InterfaceRef::get and InterfaceRef::get_mut.

Implementations

impl<I> InterfaceRef<I>

where I: 'static,

pub fn get(&self) -> InterfaceDeref<'_, I>

Get a reference to the underlying interface.

pub fn get_mut(&self) -> InterfaceDerefMut<'_, I>

Get a reference to the underlying interface.

WARNINGS: Since the ObjectServer will not be able to access the interface in question until the return value of this method is dropped, it is highly recommended that the scope of the interface returned is restricted.

Errors

If the interface at this instance’s path is not valid, Error::InterfaceNotFound error is returned.

Examples

struct MyIface(u32);

#[dbus_interface(name = "org.myiface.MyIface")]
impl MyIface {
   #[dbus_interface(property)]
   fn count(&self) -> u32 {
       self.0
   }
}
// Setup connection and object_server etc here and then in another part of the code:
let object_server = connection.object_server();
let iface_ref = object_server.interface::<_, MyIface>(path)?;
let mut iface = iface_ref.get_mut();
iface.0 = 42;
block_on(iface.count_changed(iface_ref.signal_context()))?;

pub fn signal_context(&self) -> &SignalContext<'static>