Struct Router 

pub struct Router<T: CapabilityBound> { /* private fields */ }

A Router is a capability that lets the holder obtain other capabilities asynchronously. Router is the object capability representation of Routable.

During routing, a request usually traverses through the component topology, passing through several routers, ending up at some router that will fulfill the request instead of forwarding it upstream.

Implementations

impl<T: CapabilityBound> Router<T>

pub fn new(routable: impl Routable<T> + 'static) -> Arc<Self>

Package a Routable object into a Router.

pub fn new_error(error: impl Into<RouterError>) -> Arc<Self>

Creates a router that will always fail a request with the provided error.

pub fn new_debug(source: CapabilitySource) -> Arc<Self>

Creates a router that will always return the given debug info.

pub async fn route( &self, request: RouteRequest, target: Arc<WeakInstanceToken>, ) -> Result<Option<Arc<T>>, RouterError>

Obtain a capability from this router, following the description in request.

pub async fn route_debug( &self, request: RouteRequest, target: Arc<WeakInstanceToken>, ) -> Result<CapabilitySource, RouterError>

Obtain a CapabilitySource from this router, following the description in request.

impl<T: CapabilityBound> Router<T>

pub fn new_ok(c: impl Into<Arc<T>>) -> Arc<Self>

Creates a router that will always resolve with the provided capability.

impl Router<Connector>

pub fn serve_and_register( self: Arc<Self>, stream: ConnectorRouterRequestStream, koid: Koid, token: Arc<WeakInstanceToken>, )

Serves the fuchsia.sandbox.Router protocol and moves ourself into the registry.

impl Router<Data>

pub fn serve_and_register( self: Arc<Self>, stream: DataRouterRequestStream, koid: Koid, token: Arc<WeakInstanceToken>, )

Serves the fuchsia.sandbox.Router protocol and moves ourself into the registry.

impl Router<Dictionary>

pub fn serve_and_register( self: Arc<Self>, stream: DictionaryRouterRequestStream, koid: Koid, token: Arc<WeakInstanceToken>, )

Serves the fuchsia.sandbox.Router protocol and moves ourself into the registry.

impl Router<DirConnector>

pub fn serve_and_register( self: Arc<Self>, stream: DirConnectorRouterRequestStream, koid: Koid, token: Arc<WeakInstanceToken>, )

Serves the fuchsia.sandbox.Router protocol and moves ourself into the registry.

Trait Implementations

impl CapabilityBound for Router<Connector>

fn debug_typename() -> &'static str

fn try_into_directory_entry( self: Arc<Self>, scope: ExecutionScope, token: Arc<WeakInstanceToken>, ) -> Result<Arc<dyn DirectoryEntry>, ConversionError>

Converts this capability into a directory entry.

impl CapabilityBound for Router<Data>

fn debug_typename() -> &'static str

fn try_into_directory_entry( self: Arc<Self>, scope: ExecutionScope, token: Arc<WeakInstanceToken>, ) -> Result<Arc<dyn DirectoryEntry>, ConversionError>

Converts this capability into a directory entry.

impl CapabilityBound for Router<Dictionary>

fn debug_typename() -> &'static str

fn try_into_directory_entry( self: Arc<Self>, scope: ExecutionScope, token: Arc<WeakInstanceToken>, ) -> Result<Arc<dyn DirectoryEntry>, ConversionError>

Converts this capability into a directory entry.

impl CapabilityBound for Router<DirConnector>

fn debug_typename() -> &'static str

fn try_into_directory_entry( self: Arc<Self>, scope: ExecutionScope, token: Arc<WeakInstanceToken>, ) -> Result<Arc<dyn DirectoryEntry>, ConversionError>

Converts this capability into a directory entry.

impl<T: CapabilityBound> Debug for Router<T>

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

Formats the value using the given formatter.

impl<T: CapabilityBound> Routable<T> for Router<T>

fn route<'life0, 'async_trait>( &'life0 self, request: RouteRequest, target: Arc<WeakInstanceToken>, ) -> Pin<Box<dyn Future<Output = Result<Option<Arc<T>>, RouterError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

fn route_debug<'life0, 'async_trait>( &'life0 self, request: RouteRequest, target: Arc<WeakInstanceToken>, ) -> Pin<Box<dyn Future<Output = Result<CapabilitySource, RouterError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Performs the same operation as route, but returns a fidl_fuchsia_internal::CapabilitySource persisted into bytes.