Struct h2::client::Connection[][src]

pub struct Connection<T, B: Buf = Bytes> { /* fields omitted */ }
Expand description

Manages all state associated with an HTTP/2.0 client connection.

A Connection is backed by an I/O resource (usually a TCP socket) and implements the HTTP/2.0 client logic for that connection. It is responsible for driving the internal state forward, performing the work requested of the associated handles (SendRequest, ResponseFuture, SendStream, RecvStream).

Connection values are created by calling handshake. Once a Connection value is obtained, the caller must repeatedly call poll until Ready is returned. The easiest way to do this is to submit the Connection instance to an executor.

Examples

    let (send_request, connection) = client::handshake(my_io).await?;
    // Submit the connection handle to an executor.
    tokio::spawn(async { connection.await.expect("connection failed"); });

    // Now, use `send_request` to initialize HTTP/2.0 streams.
    // ...

Implementations

Sets the target window size for the whole connection.

If size is greater than the current value, then a WINDOW_UPDATE frame will be immediately sent to the remote, increasing the connection level window by size - current_value.

If size is less than the current value, nothing will happen immediately. However, as window capacity is released by FlowControl instances, no WINDOW_UPDATE frames will be sent out until the number of “in flight” bytes drops below size.

The default value is 65,535.

See FlowControl documentation for more details.

Set a new INITIAL_WINDOW_SIZE setting (in octets) for stream-level flow control for received data.

The SETTINGS will be sent to the remote, and only applied once the remote acknowledges the change.

This can be used to increase or decrease the window size for existing streams.

Errors

Returns an error if a previous call is still pending acknowledgement from the remote endpoint.

Takes a PingPong instance from the connection.

Note

This may only be called once. Calling multiple times will return None.

Returns the maximum number of concurrent streams that may be initiated by this client.

This limit is configured by the server peer by sending the [SETTINGS_MAX_CONCURRENT_STREAMS parameter][1] in a SETTINGS frame. This method returns the currently acknowledged value recieved from the remote.

Returns the maximum number of concurrent streams that may be initiated by the server on this connection.

This returns the value of the SETTINGS_MAX_CONCURRENT_STREAMS parameter sent in a SETTINGS frame that has been acknowledged by the remote peer. The value to be sent is configured by the Builder::max_concurrent_streams method before handshaking with the remote peer.

Trait Implementations

Formats the value using the given formatter. Read more

The type of value produced on completion.

Attempt to resolve the future to a final value, registering the current task for wakeup if the value is not yet available. Read more

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Performs the conversion.

Map this future’s output to a different type, returning a new future of the resulting type. Read more

Map this future’s output to a different type, returning a new future of the resulting type. Read more

Chain on a computation for when a future finished, passing the result of the future to the provided closure f. Read more

Wrap this future in an Either future, making it the left-hand variant of that Either. Read more

Wrap this future in an Either future, making it the right-hand variant of that Either. Read more

Convert this future into a single element stream. Read more

Flatten the execution of this future when the output of this future is itself another future. Read more

Flatten the execution of this future when the successful result of this future is a stream. Read more

Fuse a future such that poll will never again be called once it has completed. This method can be used to turn any Future into a FusedFuture. Read more

Do something with the output of a future before passing it on. Read more

Catches unwinding panics while polling the future. Read more

Create a cloneable handle to this future where all handles will resolve to the same result. Read more

Turn this future into a future that yields () on completion and sends its output to another future on a separate task. Read more

Wrap the future in a Box, pinning it. Read more

Wrap the future in a Box, pinning it. Read more

A convenience for calling Future::poll on Unpin future types.

Evaluates and consumes the future, returning the resulting output if the future is ready after the first call to Future::poll. Read more

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

Performs the conversion.

🔬 This is a nightly-only experimental API. (into_future)

The output that the future will produce on completion.

🔬 This is a nightly-only experimental API. (into_future)

Which kind of future are we turning this into?

🔬 This is a nightly-only experimental API. (into_future)

Creates a future from a value.

The type returned in the event of a conversion error.

Performs the conversion.

The type of successful values yielded by this future

The type of failures yielded by this future

Poll this TryFuture as if it were a Future. Read more

Flattens the execution of this future when the successful result of this future is a Sink. Read more

Maps this future’s success value to a different value. Read more

Maps this future’s success value to a different value, and permits for error handling resulting in the same type. Read more

Maps this future’s error value to a different value. Read more

Maps this future’s Error to a new error type using the Into trait. Read more

Maps this future’s Ok to a new type using the Into trait. Read more

Executes another future after this one resolves successfully. The success value is passed to a closure to create this subsequent future. Read more

Executes another future if this one resolves to an error. The error value is passed to a closure to create this subsequent future. Read more

Do something with the success value of a future before passing it on. Read more

Do something with the error value of a future before passing it on. Read more

Flatten the execution of this future when the successful result of this future is another future. Read more

Flatten the execution of this future when the successful result of this future is a stream. Read more

Unwraps this future’s output, producing a future with this future’s Ok type as its Output type. Read more

Wraps a TryFuture into a type that implements Future. Read more

A convenience method for calling TryFuture::try_poll on Unpin future types. Read more

The type returned in the event of a conversion error.

Performs the conversion.

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more