Struct HttpsConnector

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

A Connector for the https scheme.

Implementations

impl HttpsConnector<HttpConnector>

pub fn new() -> Self

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) -> Self

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> Clone for HttpsConnector<T>

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> Debug for HttpsConnector<T>

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

Formats the value using the given formatter.

impl<T: Default> Default for HttpsConnector<T>

fn default() -> Self

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::Response: Read + Write + Send + Unpin, T::Future: Send + 'static, T::Error: Into<Box<dyn Error + Send + Sync>>,

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

Responses given by the service.

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

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<(), Self::Error>>

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

fn call(&mut self, dst: Uri) -> Self::Future

Process the request and return the response asynchronously.