Struct ControllerProxy 

pub struct ControllerProxy { /* private fields */ }

Implementations

impl ControllerProxy

pub fn new(channel: Channel) -> Self

Create a new Proxy for fuchsia.component/Controller.

pub fn take_event_stream(&self) -> ControllerEventStream

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

Panics

Panics if the event stream was already taken.

pub fn start( &self, args: StartChildArgs, execution_controller: ServerEnd<ExecutionControllerMarker>, ) -> QueryResponseFut<ControllerStartResult, FDomainResourceDialect>

Start the component, optionally providing additional handles to be given to the component. Returns INSTANCE_ALREADY_RUNNING if the instance is currently running.

pub fn is_started( &self, ) -> QueryResponseFut<ControllerIsStartedResult, FDomainResourceDialect>

Returns true if this instance is currently running.

pub fn open_exposed_dir( &self, exposed_dir: ServerEnd<DirectoryMarker>, ) -> QueryResponseFut<ControllerOpenExposedDirResult, FDomainResourceDialect>

Opens the exposed directory of the controlled component, through which capabilities the component exposed via ComponentDecl.exposes are available, on success.

Binding to the exposed directory requires that the component be resolved, but it will not be started until/unless some capability is requested that requires it to be.

If this component is destroyed, any outstanding connections to exposed_dir will be closed.

Errors:

• INSTANCE_CANNOT_RESOLVE: This component failed to resolve.

pub fn get_exposed_dictionary( &self, ) -> QueryResponseFut<ControllerGetExposedDictionaryResult, FDomainResourceDialect>

Returns the dictionary containing the component’s exposed capabilities.

pub fn destroy( &self, ) -> QueryResponseFut<ControllerDestroyResult, FDomainResourceDialect>

Destroys this component. When this method returns, the component is either destroyed or in the case of an error no destruction happened.

Errors:

• ACCESS_DENIED: Destruction of this component is not allowed. Currently, this can happen if the component is a static child of its parent.
• INTERNAL: Something prevented destruction from succeeding – component manager’s logs will contain more detail.

Trait Implementations

impl Clone for ControllerProxy

fn clone(&self) -> ControllerProxy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ControllerProxyInterface for ControllerProxy

type StartResponseFut = QueryResponseFut<Result<(), Error>, FDomainResourceDialect>

type IsStartedResponseFut = QueryResponseFut<Result<bool, Error>, FDomainResourceDialect>

type OpenExposedDirResponseFut = QueryResponseFut<Result<(), Error>, FDomainResourceDialect>

type GetExposedDictionaryResponseFut = QueryResponseFut<Result<DictionaryRef, Error>, FDomainResourceDialect>

type DestroyResponseFut = QueryResponseFut<Result<(), Error>, FDomainResourceDialect>

fn start( &self, args: StartChildArgs, execution_controller: ServerEnd<ExecutionControllerMarker>, ) -> Self::StartResponseFut

fn is_started(&self) -> Self::IsStartedResponseFut

fn open_exposed_dir( &self, exposed_dir: ServerEnd<DirectoryMarker>, ) -> Self::OpenExposedDirResponseFut

fn get_exposed_dictionary(&self) -> Self::GetExposedDictionaryResponseFut

fn destroy(&self) -> Self::DestroyResponseFut

impl Debug for ControllerProxy

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

Formats the value using the given formatter.

impl Proxy for ControllerProxy

type Protocol = ControllerMarker

The protocol which this Proxy controls.

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.

fn as_channel(&self) -> &Channel

Get a reference to the proxy’s underlying channel.

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

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