Struct Service

pub struct Service<S> { /* private fields */ }

A service from an incoming namespace’s /svc directory.

Implementations

impl<S: ServiceMarker> Service<S>

pub fn from_service_dir_proxy(dir: DirectoryProxy, _marker: S) -> Self

Returns a new Service that waits for instances to appear in the given service directory, probably opened by open_service

pub fn open(marker: S) -> Result<Self, Error>

Returns a new Service from the process’s incoming service namespace.

pub fn open_from_dir( svc_dir: impl AsRefDirectory, marker: S, ) -> Result<Self, Error>

Returns a new Service that is in the given directory.

pub fn open_from_dir_prefix( dir: impl AsRefDirectory, prefix: impl AsRef<str>, marker: S, ) -> Result<Self, Error>

Returns a new Service that is in the given directory under the given prefix (as “{prefix}/ServiceName”). A common case would be passing SVC_DIR as the prefix.

pub fn connect_to_instance( &self, name: impl AsRef<str>, ) -> Result<S::Proxy, Error>

Connects to the named instance without waiting for it to appear. You should only use this after the instance name has been returned by the Self::watch stream, or if the instance is statically routed so component manager will lazily load it.

pub async fn watch(self) -> Result<ServiceInstanceStream<S>, Error>

Returns an async stream of service instances that are enumerated within this service directory.

pub async fn watch_for_any(self) -> Result<S::Proxy, Error>

Asynchronously returns the first service instance available within this service directory.

pub async fn enumerate(self) -> Result<Vec<S::Proxy>, Error>

Returns an list of all instances that are currently available.

Trait Implementations

impl<S: Clone> Clone for Service<S>

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<S> From<DirectoryProxy> for Service<S>

where S: Default,

Returns a new Service that waits for instances to appear in the given service directory, probably opened by open_service

fn from(dir: DirectoryProxy) -> Self

Converts to this type from the input type.