Struct Service 

pub struct Service { /* private fields */ }

Handle to a registered service.

Dropping the handle implicitly unregisters the service: it is flagged cancelled and the driver’s post-pump sweep begins the endpoint-owned RFC 6762 §10.1 withdrawal — the endpoint holds the route (reserving the name) while it multicasts the TTL=0 goodbye a few times, then frees the route.

Implementations

impl Service

pub const fn handle(&self) -> ServiceHandle

The underlying proto-layer ServiceHandle for this registration.

pub async fn next(&self) -> Option<ServiceUpdate>

Wait for the next ServiceUpdate event, or None once the service has been retired (terminal delivered) or the driver task exited.

Drains the handle-owned mailbox: non-terminal updates first (FIFO), then the reserved terminal, then end-of-stream. Mirrors crate::Query::next’s wakeup discipline — a brief synchronous borrow, then a park on the shared driver notifier when nothing is ready.

Trait Implementations

impl Drop for Service

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.