Struct OptionsRequest 

pub struct OptionsRequest { /* private fields */ }

Available on crate features icap and std only.

One prebuilt OPTIONS exchange.

Implementations

impl OptionsRequest

pub fn new( connect: ConnectRequest, request: Request, ) -> Result<OptionsRequest, OptionsRequestError>

Create a discovery request from validated transport and message parts.

The cache service URI is derived from the encoded request target, so wire routing and cached capabilities cannot disagree.

The request starts in a fresh cache partition. Clone this request or set a stable OptionsCachePartition when independently constructed requests should share cached state.

This constructor derives the cache identity from the encoded request target. A transport-specific configuration scheme such as icaps is therefore unavailable here after its request target is normalized to icap; high-level ICAP endpoints retain that configured identity.

pub fn with_cache_partition( self, partition: OptionsCachePartition, ) -> OptionsRequest

Set the cache partition for authentication and connector policy.

pub fn set_cache_partition( &mut self, partition: OptionsCachePartition, ) -> &mut OptionsRequest

Set the cache partition for authentication and connector policy.

pub const fn service_uri(&self) -> &Uri

Return the exact ICAP service URI used as the cache identity.

pub fn connect_request(&self) -> ConnectRequest

Return an isolated transport connection request derived from the reusable template.

Connection-local extension mutations cannot affect this OPTIONS request or sibling attempts. OptionsService performs the same fork internally before each connection.

pub const fn request(&self) -> &Request

Return the encoded ICAP OPTIONS request.

Trait Implementations

impl Clone for OptionsRequest

fn clone(&self) -> OptionsRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OptionsRequest

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

Formats the value using the given formatter.

impl Service<OptionsRequest> for NoOptionsDiscovery

type Output = Arc<ServiceCapabilities>

The type of the output returned by the service.

type Error = Box<dyn Error + Sync + Send>

The type of error returned by the service.

async fn serve( &self, _input: OptionsRequest, ) -> Result<<NoOptionsDiscovery as Service<OptionsRequest>>::Output, <NoOptionsDiscovery as Service<OptionsRequest>>::Error>

Serve an output or an error for the given input

fn boxed(self) -> BoxService<Input, Self::Output, Self::Error>

Box this service to allow for dynamic dispatch.

impl<S> Service<OptionsRequest> for OptionsCache<S>

where S: Service<OptionsRequest, Output = ServiceCapabilities>, <S as Service<OptionsRequest>>::Error: Into<Box<dyn Error + Sync + Send>>,

type Output = Arc<ServiceCapabilities>

The type of the output returned by the service.

type Error = Box<dyn Error + Sync + Send>

The type of error returned by the service.

async fn serve( &self, input: OptionsRequest, ) -> Result<<OptionsCache<S> as Service<OptionsRequest>>::Output, <OptionsCache<S> as Service<OptionsRequest>>::Error>

Serve an output or an error for the given input

fn boxed(self) -> BoxService<Input, Self::Output, Self::Error>

Box this service to allow for dynamic dispatch.

impl<C, IO> Service<OptionsRequest> for OptionsService<C>

where C: ConnectorService<ConnectRequest, Connection = ClientConnection<IO>>, IO: Io + Unpin + ExtensionsRef,

type Output = ServiceCapabilities

The type of the output returned by the service.

type Error = Box<dyn Error + Sync + Send>

The type of error returned by the service.

async fn serve( &self, input: OptionsRequest, ) -> Result<<OptionsService<C> as Service<OptionsRequest>>::Output, <OptionsService<C> as Service<OptionsRequest>>::Error>

Serve an output or an error for the given input

fn boxed(self) -> BoxService<Input, Self::Output, Self::Error>

Box this service to allow for dynamic dispatch.