Struct Client

pub struct Client<D: ResourceDialect = DefaultFuchsiaResourceDialect> { /* private fields */ }

A FIDL client which can be used to send buffers and receive responses via a channel.

Implementations

impl<D: ResourceDialect> Client<D>

pub fn new(channel: D::ProxyChannel, protocol_name: &'static str) -> Client<D>

Create a new client.

channel is the asynchronous channel over which data is sent and received. event_ordinals are the ordinals on which events will be received.

pub fn as_channel(&self) -> &D::ProxyChannel

Get a reference to the client’s underlying channel.

pub fn into_channel(self) -> Result<D::ProxyChannel, Self>

Attempt to convert the Client back into a channel.

This will only succeed if there are no active clones of this Client, no currently-alive EventReceiver or MessageResponses that came from this Client, and no outstanding messages awaiting a response, even if that response will be discarded.

pub fn take_event_receiver(&self) -> EventReceiver<D>

Retrieve the stream of event messages for the Client. Panics if the stream was already taken.

pub fn send<T: TypeMarker>( &self, body: impl Encode<T, D>, ordinal: u64, dynamic_flags: DynamicFlags, ) -> Result<(), Error>

Encodes and sends a request without expecting a response.

pub fn send_query<Request: TypeMarker, Response: TypeMarker, const ORDINAL: u64>( &self, body: impl Encode<Request, D>, dynamic_flags: DynamicFlags, ) -> QueryResponseFut<Response::Owned, D>

where Response::Owned: Decode<Response, D>,

Encodes and sends a request. Returns a future that decodes the response.

pub fn send_query_and_decode<Request: TypeMarker, Output>( &self, body: impl Encode<Request, D>, ordinal: u64, dynamic_flags: DynamicFlags, decode: fn(_: Result<D::MessageBufEtc, Error>) -> Result<Output, Error>, ) -> QueryResponseFut<Output, D>

Encodes and sends a request. Returns a future that decodes the response using the given decode function.

pub fn send_raw( &self, bytes: &[u8], handles: &mut [<D::ProxyChannel as ProxyChannelFor<D>>::HandleDisposition], ) -> Result<(), Error>

Sends a raw message without expecting a response.

pub fn send_raw_query<F>( &self, encode_msg: F, ) -> Result<MessageResponse<D>, Error>

where F: for<'a, 'b> FnOnce(Txid, &'a mut Vec<u8>, &'b mut Vec<<D::ProxyChannel as ProxyChannelFor<D>>::HandleDisposition>) -> Result<(), Error>,

Sends a raw query and receives a response future.

Trait Implementations

impl<D: Clone + ResourceDialect> Clone for Client<D>

fn clone(&self) -> Client<D>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<D: Debug + ResourceDialect> Debug for Client<D>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.