Struct HttpsConnector

pub struct HttpsConnector<T> { /* private fields */ }

Available on (crate features http1 or http2) and crate feature https only.

A Connector for the https scheme.

Implementations

impl HttpsConnector<HttpConnector>

pub fn new() -> HttpsConnector<HttpConnector>

Construct a new HttpsConnector.

This uses hyper’s default HttpConnector, and default TlsConnector. If you wish to use something besides the defaults, use From::from.

Note

By default this connector will use plain HTTP if the URL provided uses the HTTP scheme (eg: http://example.com/).

If you would like to force the use of HTTPS then call https_only(true) on the returned connector.

Panics

This will panic if the underlying TLS context could not be created.

To handle that error yourself, you can use the HttpsConnector::from constructor after trying to make a TlsConnector.

impl<T> HttpsConnector<T>

pub fn https_only(&mut self, enable: bool)

Force the use of HTTPS when connecting.

If a URL is not https when connecting, an error is returned.

pub fn new_with_connector(http: T) -> HttpsConnector<T>

With connector constructor

Panics

This will panic if the underlying TLS context could not be created.

To handle that error yourself, you can use the HttpsConnector::from constructor after trying to make a TlsConnector.

Trait Implementations

impl<T> Clone for HttpsConnector<T>

where T: Clone,

fn clone(&self) -> HttpsConnector<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for HttpsConnector<T>

where T: Debug,

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

Formats the value using the given formatter.

impl<T> Default for HttpsConnector<T>

where T: Default,

fn default() -> HttpsConnector<T>

Returns the “default value” for a type.

impl<T> From<(T, TlsConnector)> for HttpsConnector<T>

fn from(args: (T, TlsConnector)) -> HttpsConnector<T>

Converts to this type from the input type.

impl<T> Service<Uri> for HttpsConnector<T>

where T: Service<Uri>, <T as Service<Uri>>::Response: Read + Write + Send + Unpin, <T as Service<Uri>>::Future: Send + 'static, <T as Service<Uri>>::Error: Into<Box<dyn Error + Sync + Send>>,

type Response = MaybeHttpsStream<<T as Service<Uri>>::Response>

Responses given by the service.

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

Errors produced by the service.

type Future = HttpsConnecting<<T as Service<Uri>>::Response>

The future response value.

fn poll_ready( &mut self, cx: &mut Context<'_>, ) -> Poll<Result<(), <HttpsConnector<T> as Service<Uri>>::Error>>

Returns Poll::Ready(Ok(())) when the service is able to process requests.

fn call(&mut self, dst: Uri) -> <HttpsConnector<T> as Service<Uri>>::Future

Process the request and return the response asynchronously.