Trait Proxy

pub trait Proxy:
    Sized
    + Send
    + Sync {
    type Protocol: ProtocolMarker<Proxy = Self>;

    // Required methods
    fn from_channel(inner: Channel) -> Self;
    fn into_channel(self) -> Result<Channel, Self>;
    fn as_channel(&self) -> &Channel;

    // Provided method
    fn domain(&self) -> Arc<Client> { ... }
}

A type which allows querying a remote FIDL server over a channel.

Required Associated Types

type Protocol: ProtocolMarker<Proxy = Self>

The protocol which this Proxy controls.

Required Methods

fn from_channel(inner: Channel) -> Self

Create a proxy over the given channel.

fn into_channel(self) -> Result<Channel, Self>

Attempt to convert the proxy back into a channel.

This will only succeed if there are no active clones of this proxy and no currently-alive EventStream or response futures that came from this proxy.

fn as_channel(&self) -> &Channel

Get a reference to the proxy’s underlying channel.

This should only be used for non-effectful operations. Reading or writing to the channel is unsafe because the proxy assumes it has exclusive control over these operations.

Provided Methods

fn domain(&self) -> Arc<Client>

Get the client supporting this proxy. We call this a “domain” here because:

• Client is especially overloaded in contexts where this is useful.
• We simulate this call for target-side FIDL proxies, so it isn’t always really a client.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors