Struct HttpClientStd 

pub struct HttpClientStd { /* private fields */ }

Available on crate feature client only.

Std-blocking HTTP client wrapping a boxed Read + Write + Send stream.

Implementations

impl HttpClientStd

pub fn connect(url: &Url, tls: &Tls) -> Result<Self, HttpClientError>

Available on crate features native-tls or rustls-aws or rustls-ring only.

Connects to url (TLS handshake on https), reading ALPN from tls.rustls.alpn (see Self::default_alpn).

impl HttpClientStd

pub fn new<S: Read + Write + Send + 'static>(stream: S) -> Self

Wraps a pre-connected stream; caller handles TCP and TLS.

pub fn default_alpn() -> Vec<String>

Default ALPN identifier for HTTPS connections: http/1.1 (RFC 7301 + IANA registry).

pub fn set_stream<S: Read + Write + Send + 'static>(&mut self, stream: S)

Replaces the underlying stream (e.g. after Connection: close or a cross-authority redirect).

impl HttpClientStd

pub fn send_streaming( self, request: HttpRequest, ) -> Result<SseStream, HttpClientError>

Opens an HTTP/1.1 SSE stream; requires Transfer-Encoding: chunked. Consumes self because the connection is dedicated to the stream.

Trait Implementations

impl HttpClient for HttpClientStd

fn run_send<C, E>( &mut self, coroutine: C, ) -> Result<HttpSendOutput, HttpClientError>

where C: HttpCoroutine<Yield = HttpSendYield, Return = Result<HttpSendOutput, E>>, HttpClientError: From<E>,

Refuses a redirect with HttpClientError::UnexpectedRedirect, this client following none: a request carrying credentials must not replay them against whatever host a 3xx names, and the caller is the only party that knows whether the new target is one it meant to talk to.

fn run<C, T, E>(&mut self, coroutine: C) -> Result<T, HttpClientError>

where C: HttpCoroutine<Yield = HttpYield, Return = Result<T, E>>, HttpClientError: From<E>,

Runs a standard-shape coroutine to completion, fulfilling its read and write requests against the transport.

fn send( &mut self, request: HttpRequest, ) -> Result<HttpSendOutput, HttpClientError>

Sends one HTTP/1.1 request and reads its response.

fn send_http10( &mut self, request: HttpRequest, ) -> Result<HttpSendOutput, HttpClientError>

HTTP/1.0 counterpart of send.