Struct NamespaceControllerProxy

pub struct NamespaceControllerProxy { /* private fields */ }

Implementations

impl NamespaceControllerProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.net.filter/NamespaceController.

pub fn take_event_stream(&self) -> NamespaceControllerEventStream

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

Panics

Panics if the event stream was already taken.

pub fn detach( &self, ) -> QueryResponseFut<[u8; 16], DefaultFuchsiaResourceDialect>

Detaches the client end from the controller’s lifetime.

After calling Detach, closing this client end no longer causes the filtering state owned by the controller to be removed. The key returned by the method can be used once by a client to reconnect to a detached controller. This allows clients to ensure the filtering state they install is resilient to client-side crashes and disconnections. (Note, however, that closing the client end of the channel will flush any pending changes that have been pushed but not yet committed.)

Detach can be called multiple times; the key returned by the most recent call is valid to reconnect to the controller. Calling Detach will always return a new key and invalidate any previous keys.

Note that, once a client has called Detach on a controller, the controller remains detached even after a reconnection. This means that, for example, if a client detached, closed the client end, reconnected, and then closed the client end again, the filtering state owned by the controller would not be removed. After reconnection, the only reason a client would call Detach is to be able to reconnect again in the future, given the key is invalidated after use.

pub fn push_changes( &self, changes: &[Change], ) -> QueryResponseFut<ChangeValidationResult, DefaultFuchsiaResourceDialect>

Append a set of changes to a pending transactional update to the filtering configuration.

To apply these changes, a client must call Commit.

pub fn commit( &self, payload: CommitOptions, ) -> QueryResponseFut<CommitResult, DefaultFuchsiaResourceDialect>

Apply all pending changes. The set of changes will either be applied in its entirety or, in case of an error, not applied at all.

Trait Implementations

impl Clone for NamespaceControllerProxy

fn clone(&self) -> NamespaceControllerProxy

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for NamespaceControllerProxy

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

Formats the value using the given formatter.

impl NamespaceControllerProxyInterface for NamespaceControllerProxy

type DetachResponseFut = QueryResponseFut<[u8; 16]>

type PushChangesResponseFut = QueryResponseFut<ChangeValidationResult>

type CommitResponseFut = QueryResponseFut<CommitResult>

fn detach(&self) -> Self::DetachResponseFut

fn push_changes(&self, changes: &[Change]) -> Self::PushChangesResponseFut

fn commit(&self, payload: CommitOptions) -> Self::CommitResponseFut

impl Proxy for NamespaceControllerProxy

type Protocol = NamespaceControllerMarker

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 into_client_end(self) -> Result<ClientEnd<Self::Protocol>, Self>

Attempt to convert the proxy back into a client end.

fn is_closed(&self) -> bool

Returns true if the proxy has received the PEER_CLOSED signal.

fn on_closed(&self) -> OnSignals<'_, Unowned<'_, Handle>>

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