Struct gain::service::Service

pub struct Service { /* fields omitted */ }

Handle to a registered service.

If a stream is opened as a result of service registration or a call, the appropriate stream constructor must be called immediately. Care must be taken when using input buffering with streams which carry stream ids.

Implementations

impl Service

pub fn register(name: &'static str) -> Self

Register a service or panic.

pub fn try_register(name: &'static str) -> Result<Self, RegistrationError>

Register a service.

pub fn call<'a, R, T>(&self, content: &'a [u8], receptor: R) -> Call<'a, R, T> where
    R: FnOnce(&[u8]) -> T + Unpin, 

Call the service. Returns a future.

The receptor is invoked with the reply content, and its return value is passed through.

pub fn recv_info<R>(&self, receptor: R) -> InfoRecv<R> where
    R: Fn(&[u8]) + Unpin, 

Receive info packets from the service repeatedly. Returns a future.

pub fn send_info<'a>(&self, content: &'a [u8]) -> InfoSend<'a>

Send an info packet to the service. Returns a future.

pub fn stream(&self, id: i32) -> RecvWriteStream

Construct a handle to a new bidirectional stream.

pub fn input_stream(&self, id: i32) -> RecvStream

Construct a handle to a new unidirectional stream.

pub fn output_stream(&self, id: i32) -> WriteStream

Construct a handle to a new unidirectional stream.