Struct ServiceOffer 

pub struct ServiceOffer<S> { /* private fields */ }

A builder for creating [Offer]-compatible values for crate::NodeBuilder::add_offer that serves a fidl service.

The methods on this that start with add_ are helpers that will both register a service handler with a [ServiceFs] and register the instance name in the structure. If you’re handling adding your service handlers to the outgoing directory yourself, you can just use the non-add_ methods to register them.

If no calls to add any instances are made, then when this is transformed into a service offer it will be as if a single default instance with the default name was added.

Implementations

impl<S> ServiceOffer<S>

pub fn new() -> Self

where S: ServiceMarker,

Builds an offer for a zircon transport service based on the ServiceMarker for S.

If the compiler can’t deduce the type of S (which may be the case if you’re not using the add_ methods to add to a [ServiceFs] at the same time), you can use Self::new_marker to make it explicit.

pub fn new_next() -> Self

where S: DiscoverableService,

Builds an offer for a service based on the fidl_next::DiscoverableService for S.

If the compiler can’t deduce the type of S (which may be the case if you’re not using the add_ methods to add to a [ServiceFs] at the same time), you can use Self::new_marker_next to make it explicit.

pub fn new_marker(_marker: S) -> Self

where S: ServiceMarker,

Builds an offer for a zircon transport service based on the given ServiceMarker.

This is mostly useful if the compiler can’t derive the type of S on its own.

pub fn new_marker_next(_marker: S) -> Self

where S: DiscoverableService,

Builds an offer for a service based on the fidl_next::DiscoverableService.

This is mostly useful if the compiler can’t derive the type of S on its own.

pub fn add_default_named<O: ServiceObjTrait, F, SR>( self, fs: &mut ServiceFs<O>, name: impl Into<String>, f: F, ) -> Self

where F: Fn(SR) -> O::Output + Clone, SR: ServiceRequest<Service = S>, FidlServiceMember<F, SR, O::Output>: Into<O>,

Adds the given service instance to this offer and to the [ServiceFs] passed in, using the generator function f. The type of the service will be derived from the result of the generator function and it will be added with the name name which will be mapped to the default instance name to child components (DEFAULT_SERVICE_INSTANCE).

pub fn add_default_named_next<H, O>( self, fs: &mut ServiceFs<O>, name: impl Into<String>, handler: H, ) -> Self

where O: ServiceObjTrait, S: DiscoverableService + DispatchServiceHandler<H, Channel> + 'static, H: Send + Sync + 'static,

Adds the given service instance to this offer and to the [ServiceFs] passed in, using the generator function f. The type of the service will be derived from the result of the generator function and it will be added with the name name which will be mapped to the default instance name to child components (DEFAULT_SERVICE_INSTANCE).

pub fn add_named<O: ServiceObjTrait, F, SR>( self, fs: &mut ServiceFs<O>, name: impl Into<String>, f: F, ) -> Self

where F: Fn(SR) -> O::Output + Clone, SR: ServiceRequest<Service = S>, FidlServiceMember<F, SR, O::Output>: Into<O>,

Adds the given service instance to this offer and to the [ServiceFs] passed in, using the generator function f. The type of the service will be derived from the result of the generator function and it will be added with the name name.

pub fn add_named_next<H, O>( self, fs: &mut ServiceFs<O>, name: impl Into<String>, handler: H, ) -> Self

where O: ServiceObjTrait, S: DiscoverableService + DispatchServiceHandler<H, Channel> + 'static, H: Send + Sync + 'static,

Adds the given service instance to this offer and to the [ServiceFs] passed in, using the generator function f. The type of the service will be derived from the result of the generator function and it will be added with the name name.

pub fn named_default_instance(self, name: impl Into<String>) -> Self

Adds the named instance as the default instance of this service offer (as specified by DEFAULT_SERVICE_INSTANCE). If you are only offering a single instance that is already called default, you do not need to call this.

pub fn named_instance(self, name: impl Into<String>) -> Self

Adds the named instance to the offer without mapping it to the default instance name. You can use this to add additional instances offered in your outgoing directory.

pub fn build_zircon_offer(self) -> Offer

where S: ServiceMarker,

Finalize the construction of the [Offer] object for use with super::NodeBuilder::add_offer when the service is a zircon transport service.

pub fn build_zircon_offer_next(self) -> Offer

where S: HasServiceRequest<Channel>,

Finalize the construction of the [Offer] object for use with super::NodeBuilder::add_offer when the service is a zircon transport service with the new wire bindings.

pub fn build_driver_offer(self) -> Offer

where S: HasServiceRequest<DriverChannel>,

Finalize the construction of the [Offer] object for use with super::NodeBuilder::add_offer when the service is a driver transport service.

Trait Implementations

impl<S: DiscoverableService> Default for ServiceOffer<S>

fn default() -> Self

Returns the “default value” for a type.