Struct MultiProtocolRoutingServiceBuilder 

pub struct MultiProtocolRoutingServiceBuilder<L = Identity> { /* private fields */ }

Collects routing inputs, validating and constructing them only in Self::build.

The service schema is required. Built-in protocols are always available; additional registries contribute protocols implemented outside this crate.

Implementations

impl MultiProtocolRoutingServiceBuilder

pub fn new(service: &'static ServiceSchema<'static>) -> Self

Starts configuring routing for the supplied schema.

pub fn from_operation_handler_bindings( service: &'static ServiceSchema<'static>, registries: impl IntoIterator<Item = &'static ProtocolRegistry>, bindings: impl IntoIterator<Item = (&'static OperationSchema<'static>, SyncRoute<RequestBody>)>, ) -> Self

Collects operation bindings and external protocol registries with default options.

pub fn from_operation_handler_bindings_with_options( service: &'static ServiceSchema<'static>, registries: impl IntoIterator<Item = &'static ProtocolRegistry>, bindings: impl IntoIterator<Item = (&'static OperationSchema<'static>, SyncRoute<RequestBody>)>, options: ProtocolOptions, ) -> Self

Collects operation bindings, external registries, and protocol options.

impl<L> MultiProtocolRoutingServiceBuilder<L>

pub fn registries( self, registries: impl IntoIterator<Item = &'static ProtocolRegistry>, ) -> Self

Replaces the external registries. ProtocolRegistry::BUILTIN is always consulted.

pub fn operation_handler_bindings( self, bindings: impl IntoIterator<Item = (&'static OperationSchema<'static>, SyncRoute<RequestBody>)>, ) -> Self

Replaces the protocol-independent (operation schema, handler route) bindings.

pub fn options(self, options: ProtocolOptions) -> Self

Replaces the protocol options.

pub fn layer<N>(self, layer: N) -> MultiProtocolRoutingServiceBuilder<N>

Sets the handler layer, replacing any previously configured layer.

The layer is applied during construction. It runs after routing; inspect the selection through crate::schema::SelectedOperation::get_from_request. Forwarded requests must preserve their extensions. Discarding them causes the upgrade or missing-handler fallback to return an empty 500 without reading input or invoking the handler. Routing may already have collected the input before the layer runs. Compose multiple layers with a Tower layer stack.

pub fn build(self) -> Result<MultiProtocolRoutingService, RouterBuildError>

where L: Layer<SyncRoute<RequestBody>>, L::Service: Service<Request<RequestBody>, Response = Response<BoxBody>, Error = Infallible> + Clone + Send + Sync + 'static, <L::Service as Service<Request<RequestBody>>>::Future: Send + 'static,

Validates the configuration and builds protocol routers and layered handlers.

Trait Implementations

impl<L: Debug> Debug for MultiProtocolRoutingServiceBuilder<L>

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

Formats the value using the given formatter.