Struct h2::server::Builder[][src]

pub struct Builder { /* fields omitted */ }
Expand description

Builds server connections with custom configuration values.

Methods can be chained in order to set the configuration values.

The server is constructed by calling handshake and passing the I/O handle that will back the HTTP/2.0 server.

New instances of Builder are obtained via Builder::new.

See function level documentation for details on the various server configuration settings.

Examples

// `server_fut` is a future representing the completion of the HTTP/2.0
// handshake.
let server_fut = Builder::new()
    .initial_window_size(1_000_000)
    .max_concurrent_streams(1000)
    .handshake(my_io);

Implementations

Returns a new server builder instance initialized with default configuration values.

Configuration methods can be chained on the return value.

Examples
// `server_fut` is a future representing the completion of the HTTP/2.0
// handshake.
let server_fut = Builder::new()
    .initial_window_size(1_000_000)
    .max_concurrent_streams(1000)
    .handshake(my_io);

Indicates the initial window size (in octets) for stream-level flow control for received data.

The initial window of a stream is used as part of flow control. For more details, see FlowControl.

The default value is 65,535.

Examples
// `server_fut` is a future representing the completion of the HTTP/2.0
// handshake.
let server_fut = Builder::new()
    .initial_window_size(1_000_000)
    .handshake(my_io);

Indicates the initial window size (in octets) for connection-level flow control for received data.

The initial window of a connection is used as part of flow control. For more details, see FlowControl.

The default value is 65,535.

Examples
// `server_fut` is a future representing the completion of the HTTP/2.0
// handshake.
let server_fut = Builder::new()
    .initial_connection_window_size(1_000_000)
    .handshake(my_io);

Indicates the size (in octets) of the largest HTTP/2.0 frame payload that the configured server is able to accept.

The sender may send data frames that are smaller than this value, but any data larger than max will be broken up into multiple DATA frames.

The value must be between 16,384 and 16,777,215. The default value is 16,384.

Examples
// `server_fut` is a future representing the completion of the HTTP/2.0
// handshake.
let server_fut = Builder::new()
    .max_frame_size(1_000_000)
    .handshake(my_io);
Panics

This function panics if max is not within the legal range specified above.

Sets the max size of received header frames.

This advisory setting informs a peer of the maximum size of header list that the sender is prepared to accept, in octets. The value is based on the uncompressed size of header fields, including the length of the name and value in octets plus an overhead of 32 octets for each header field.

This setting is also used to limit the maximum amount of data that is buffered to decode HEADERS frames.

Examples
// `server_fut` is a future representing the completion of the HTTP/2.0
// handshake.
let server_fut = Builder::new()
    .max_header_list_size(16 * 1024)
    .handshake(my_io);

Sets the maximum number of concurrent streams.

The maximum concurrent streams setting only controls the maximum number of streams that can be initiated by the remote peer. In other words, when this setting is set to 100, this does not limit the number of concurrent streams that can be created by the caller.

It is recommended that this value be no smaller than 100, so as to not unnecessarily limit parallelism. However, any value is legal, including 0. If max is set to 0, then the remote will not be permitted to initiate streams.

Note that streams in the reserved state, i.e., push promises that have been reserved but the stream has not started, do not count against this setting.

Also note that if the remote does exceed the value set here, it is not a protocol level error. Instead, the h2 library will immediately reset the stream.

See Section 5.1.2 in the HTTP/2.0 spec for more details.

Examples
// `server_fut` is a future representing the completion of the HTTP/2.0
// handshake.
let server_fut = Builder::new()
    .max_concurrent_streams(1000)
    .handshake(my_io);

Sets the maximum number of concurrent locally reset streams.

When a stream is explicitly reset by either calling SendResponse::send_reset or by dropping a SendResponse instance before completing the stream, the HTTP/2.0 specification requires that any further frames received for that stream must be ignored for “some time”.

In order to satisfy the specification, internal state must be maintained to implement the behavior. This state grows linearly with the number of streams that are locally reset.

The max_concurrent_reset_streams setting configures sets an upper bound on the amount of state that is maintained. When this max value is reached, the oldest reset stream is purged from memory.

Once the stream has been fully purged from memory, any additional frames received for that stream will result in a connection level protocol error, forcing the connection to terminate.

The default value is 10.

Examples
// `server_fut` is a future representing the completion of the HTTP/2.0
// handshake.
let server_fut = Builder::new()
    .max_concurrent_reset_streams(1000)
    .handshake(my_io);

Sets the maximum number of concurrent locally reset streams.

When a stream is explicitly reset by either calling SendResponse::send_reset or by dropping a SendResponse instance before completing the stream, the HTTP/2.0 specification requires that any further frames received for that stream must be ignored for “some time”.

In order to satisfy the specification, internal state must be maintained to implement the behavior. This state grows linearly with the number of streams that are locally reset.

The reset_stream_duration setting configures the max amount of time this state will be maintained in memory. Once the duration elapses, the stream state is purged from memory.

Once the stream has been fully purged from memory, any additional frames received for that stream will result in a connection level protocol error, forcing the connection to terminate.

The default value is 30 seconds.

Examples
// `server_fut` is a future representing the completion of the HTTP/2.0
// handshake.
let server_fut = Builder::new()
    .reset_stream_duration(Duration::from_secs(10))
    .handshake(my_io);

Creates a new configured HTTP/2.0 server backed by io.

It is expected that io already be in an appropriate state to commence the HTTP/2.0 handshake. See Handshake for more details.

Returns a future which resolves to the Connection instance once the HTTP/2.0 handshake has been completed.

This function also allows the caller to configure the send payload data type. See Outbound data type for more details.

Examples

Basic usage:

// `server_fut` is a future representing the completion of the HTTP/2.0
// handshake.
let server_fut = Builder::new()
    .handshake(my_io);

Configures the send-payload data type. In this case, the outbound data type will be &'static [u8].

// `server_fut` is a future representing the completion of the HTTP/2.0
// handshake.
let server_fut: Handshake<_, &'static [u8]> = Builder::new()
    .handshake(my_io);

Trait Implementations

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

Formats the value using the given formatter. Read more

Returns the “default value” for a type. 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.

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.

The resulting type after obtaining ownership.

Creates owned data from borrowed data, usually by cloning. Read more

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

Uses borrowed data to replace owned data, usually by cloning. Read more

The type returned in the event of a conversion error.

Performs the conversion.

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