Struct TargetLayer 

pub struct TargetLayer { /* private fields */ }

Available on crate feature client only.

Set a Target as the destination forcely.

The layer only sets destination address, including target address, target domain name (for DNS) and SNI of target host (if using HTTPS).

Note that this layer MUST be set as an outer layer because outer layers runs before service discover (DNS).

Implementations

impl TargetLayer

pub const fn new(target: Target) -> Self

Create a TargetLayer via a Target.

This layer will set the Target as request destination.

pub fn new_address<A>(addr: A) -> Self

where A: Into<Address>,

Create a TargetLayer via an address.

pub fn new_host<S>(host: S) -> Self

where S: Into<Cow<'static, str>>,

Create a TargetLayer via a host name.

pub fn from_uri(uri: &Uri) -> Self

Create a Target from a Uri.

Panics

This function will panic if the given Uri cannot be parsed to a Target.

pub fn with_service_name<S>(self, service_name: S) -> Self

where S: Into<FastStr>,

Set a service name for current TargetLayer.

When this layer sets Target as the destination, the service name is also set, and if the request uses HTTPS, the service name will be used as the SNI.

Trait Implementations

impl<S> Layer<S> for TargetLayer

type Service = TargetService<S>

The wrapped service

fn layer(self, inner: S) -> Self::Service

Wrap the given service with the middleware, returning a new service that has been decorated with the middleware. Consumes self.