Skip to main content

GroupsClient

Trait GroupsClient 

Source
pub trait GroupsClient<'a>: ImClient<'a> {
    // Provided method
    fn groups(self) -> GroupsClientView<'a> { ... }
}
Expand description

Single-shot IM-client convenience trait for the Groups cluster. use this trait to call .groups() on an crate::transport::exchange::Exchange; the returned GroupsClientView exposes one method per command and per attribute. Scalar attributes get a by-value <attr>_read(endpoint); non-scalar ones (string/octet/struct/list, whose value borrows the response) get <attr>_read_with(endpoint, |v| …), which hands the borrowed value to the closure and returns its owned result. The cluster ID, command/attribute ID, request opcode, retransmit loop, response-chunk iteration, and status-only handling are all baked in. DefaultSuccess commands return Result<(), Error> and drain the response internally; response-bearing commands return Result<<RespStruct>Handle<'a>, Error> — the handle keeps the RX buffer alive so the caller can read the borrowed response via .response()? before .complete().await?ing the exchange.

The indirection through GroupsClientView keeps each cluster’s API surface narrow: at the call site exchange.groups(). shows only this cluster’s methods in IDE completion.

Provided Methods§

Source

fn groups(self) -> GroupsClientView<'a>

Enter this cluster’s client view. Consumes the exchange — call methods on the returned view to drive a single IM transaction (one command invoke or one attribute read/write).

Dyn Compatibility§

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors§

Source§

impl<'a> GroupsClient<'a> for Exchange<'a>