Struct fidl_fuchsia_exception::HandlerProxy

pub struct HandlerProxy { /* private fields */ }

Implementations

impl HandlerProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for Handler

pub fn take_event_stream(&self) -> HandlerEventStream

Get a Stream of events from the remote end of the Handler protocol

Panics

Panics if the event stream was already taken.

pub fn is_active(&self) -> QueryResponseFut<()>

Requests the exception handler to send a signal indicating the server is active and able to respond to requests.

It’s recommended clients call IsActive and wait for a response before sending an exception to the server with OnException because a zx.handle:EXCEPTION can’t be released by the client once it’s sent across the channel.

Note: a response guarantees the server was active when it sent the response, but doesn’t preclcude the server being unresponsive after the reply was sent.

pub fn on_exception( &self, exception: Exception, info: &mut ExceptionInfo ) -> QueryResponseFut<()>

This exception mirrors closely the information provided by exception channels. The design is to have clients of this API behave as closely as possible to native exception handlers that are listening to an exception channel.

exception is an exception handle, which controls the exception’s lifetime. See exception zircon docs for more information.

info represents basic exception information as provided by the exception channel.

Trait Implementations

impl Clone for HandlerProxy

fn clone(&self) -> HandlerProxy

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for HandlerProxy

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

Formats the value using the given formatter.

impl HandlerProxyInterface for HandlerProxy

type IsActiveResponseFut = QueryResponseFut<()>

fn is_active(&self) -> Self::IsActiveResponseFut

type OnExceptionResponseFut = QueryResponseFut<()>

fn on_exception( &self, exception: Exception, info: &mut ExceptionInfo ) -> Self::OnExceptionResponseFut

impl Proxy for HandlerProxy

type Protocol = HandlerMarker

The protocol which this Proxy controls.

fn from_channel(inner: AsyncChannel) -> Self

Create a proxy over the given channel.

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

Attempt to convert the proxy back into a channel.

fn as_channel(&self) -> &AsyncChannel

Get a reference to the proxy’s underlying channel.

fn is_closed(&self) -> bool

Returns true if the proxy has received the PEER_CLOSED signal.

fn on_closed<'a>(&'a self) -> OnSignals<'a>

Returns a future that completes when the proxy receives the PEER_CLOSED signal.