Struct LocalBackend 

pub struct LocalBackend { /* private fields */ }

The local service.json transport: discovery through the suite, identity through Client::connect_expecting.

Implementations

impl LocalBackend

pub fn new(client: ClientConfig, expect: HostExpectation) -> Self

client names the service, the app label and the suite (see ClientConfig); expect names the executable the host may be. An expectation is required: attaching to a host whose program was never checked is not offered.

Trait Implementations

impl HostBackend for LocalBackend

fn discover(&self) -> Result<Option<HostGeneration>>

The live published host now, or None. An unreadable record is Err (unknown), never None: the lifecycle must not start a second host on an unknown.

fn connect( &self, host: &HostGeneration, ) -> Result<Box<dyn HostLink>, LifecycleError>

Open a connection to exactly host, after verifying who is on the other end. A host that fails the identity check is LifecycleError::HostIdentity; nothing application-level was sent to it.

fn is_current(&self, host: &HostGeneration) -> Result<bool>

Whether host is still the published, live generation. Called before every request and before every reply is handed back, so it should be cheap (no connection).

fn claim_spawn(&self) -> Result<SpawnPermit>

Take the cross-process claim that serialises starting a host.