Struct Destination 

pub struct Destination { /* private fields */ }

A set of properties to describe where and how to try to connect.

This type is passed an argument for the Connect trait.

Implementations

impl Destination

pub fn try_from_uri(uri: Uri) -> Result<Destination, Error>

Try to convert a Uri into a Destination

Error

Returns an error if the uri contains no authority or no scheme.

pub fn scheme(&self) -> &str

Get the protocol scheme.

pub fn host(&self) -> &str

Get the hostname.

pub fn port(&self) -> Option<u16>

Get the port, if specified.

pub fn set_scheme(&mut self, scheme: &str) -> Result<(), Error>

Update the scheme of this destination.

Example

// let mut dst = some_destination...
// Change from "http://"...
assert_eq!(dst.scheme(), "http");

// to "ws://"...
dst.set_scheme("ws");
assert_eq!(dst.scheme(), "ws");

Error

Returns an error if the string is not a valid scheme.

pub fn set_host(&mut self, host: &str) -> Result<(), Error>

Update the host of this destination.

Example

// let mut dst = some_destination...
// Change from "hyper.rs"...
assert_eq!(dst.host(), "hyper.rs");

// to "some.proxy"...
dst.set_host("some.proxy");
assert_eq!(dst.host(), "some.proxy");

Error

Returns an error if the string is not a valid hostname.

pub fn set_port<P>(&mut self, port: P)

where P: Into<Option<u16>>,

Update the port of this destination.

Example

// let mut dst = some_destination...
// Change from "None"...
assert_eq!(dst.port(), None);

// to "4321"...
dst.set_port(4321);
assert_eq!(dst.port(), Some(4321));

// Or remove the port...
dst.set_port(None);
assert_eq!(dst.port(), None);

Trait Implementations

impl Clone for Destination

fn clone(&self) -> Destination

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Destination

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

Formats the value using the given formatter.

impl<C> Service<Destination> for Connector<C>

where C: Connect,

type Response = <C as Connect>::Transport

Responses given by the service.

type Error = <C as Connect>::Error

Errors produced by the service.

type Future = ConnectorFuture<C>

The future response value.

fn poll_ready(&mut self) -> Poll<(), Self::Error>

Returns Ready when the service is able to process requests.

fn call(&mut self, target: Destination) -> Self::Future

Process the request and return the response asynchronously.

impl TryFrom<Uri> for Destination

Available on try_from only.

type Error = Error

The type returned in the event of a conversion error.

fn try_from( uri: Uri, ) -> Result<Destination, <Destination as TryFrom<Uri>>::Error>

Performs the conversion.