QHttp2Configuration

The QHttp2Configuration class controls HTTP/2 parameters and settings. More…

Synopsis

Functions

• def __eq__ (rhs)

• def __ne__ (rhs)

• def huffmanCompressionEnabled ()

• def maxFrameSize ()

• def serverPushEnabled ()

• def sessionReceiveWindowSize ()

• def setHuffmanCompressionEnabled (enable)

• def setMaxFrameSize (size)

• def setServerPushEnabled (enable)

• def setSessionReceiveWindowSize (size)

• def setStreamReceiveWindowSize (size)

• def streamReceiveWindowSize ()

• def swap (other)

Detailed Description

QHttp2Configuration controls HTTP/2 parameters and settings that QNetworkAccessManager will use to send requests and process responses when the HTTP/2 protocol is enabled.

The HTTP/2 parameters that QHttp2Configuration currently supports include:

• The session window size for connection-level flow control. Will be sent to a remote peer when needed as ‘WINDOW_UPDATE’ frames on the stream with an identifier 0.

• The stream receiving window size for stream-level flow control. Sent as ‘SETTINGS_INITIAL_WINDOW_SIZE’ parameter in the initial SETTINGS frame and, when needed, ‘WINDOW_UPDATE’ frames will be sent on streams that QNetworkAccessManager opens.

• The maximum frame size. This parameter limits the maximum payload a frame coming from the remote peer can have. Sent by QNetworkAccessManager as ‘SETTINGS_MAX_FRAME_SIZE’ parameter in the initial ‘SETTINGS’ frame.

• The server push. Allows to enable or disable server push. Sent as ‘SETTINGS_ENABLE_PUSH’ parameter in the initial ‘SETTINGS’ frame.

The QHttp2Configuration class also controls if the header compression algorithm (HPACK) is additionally using Huffman coding for string compression.

Note

The configuration must be set before the first request was sent to a given host (and thus an HTTP/2 session established).

Note

Details about flow control, server push and ‘SETTINGS’ can be found in RFC 7540 . Different modes and parameters of the HPACK compression algorithm are described in RFC 7541 .

See also

setHttp2Configuration() http2Configuration() QNetworkAccessManager

class PySide6.QtNetwork.QHttp2Configuration

PySide6.QtNetwork.QHttp2Configuration(other)

Parameters

other – PySide6.QtNetwork.QHttp2Configuration

Default constructs a QHttp2Configuration object.

Such a configuration has the following values:

• Server push is disabled

• Huffman string compression is enabled

• Window size for connection-level flow control is 65535 octets

• Window size for stream-level flow control is 65535 octets

• Frame size is 16384 octets

PySide6.QtNetwork.QHttp2Configuration.huffmanCompressionEnabled()

Return type

bool

Returns true if the Huffman coding in HPACK is enabled.

See also

setHuffmanCompressionEnabled

PySide6.QtNetwork.QHttp2Configuration.maxFrameSize()

Return type

int

Returns the maximum payload size that HTTP/2 frames can have. The default (initial) value is 16384 octets.

See also

setMaxFrameSize()

PySide6.QtNetwork.QHttp2Configuration.__ne__(rhs)

Parameters

rhs – PySide6.QtNetwork.QHttp2Configuration

Return type

bool

PySide6.QtNetwork.QHttp2Configuration.__eq__(rhs)

Parameters

rhs – PySide6.QtNetwork.QHttp2Configuration

Return type

bool

PySide6.QtNetwork.QHttp2Configuration.serverPushEnabled()

Return type

bool

Returns true if server push was enabled.

Note

By default, QNetworkAccessManager disables server push via the ‘SETTINGS’ frame.

See also

setServerPushEnabled

PySide6.QtNetwork.QHttp2Configuration.sessionReceiveWindowSize()

Return type

int

Returns the window size for connection-level flow control. The default value QNetworkAccessManager will be using is 2147483647 octets.

See also

setSessionReceiveWindowSize()

PySide6.QtNetwork.QHttp2Configuration.setHuffmanCompressionEnabled(enable)

Parameters

enable – bool

If enable is true, HPACK compression will additionally compress string using the Huffman coding. Enabled by default.

Note

This parameter only affects ‘HEADERS’ frames that QNetworkAccessManager is sending.

See also

huffmanCompressionEnabled

PySide6.QtNetwork.QHttp2Configuration.setMaxFrameSize(size)

Parameters

size – int

Return type

bool

Sets the maximum frame size that QNetworkAccessManager will advertise to the server when sending its initial SETTINGS frame.

Note

While this size is required to be within a range between 16384 and 16777215 inclusive, the actual payload size in frames that carry payload maybe be less than 16384.

Returns true on success, false otherwise.

See also

maxFrameSize()

PySide6.QtNetwork.QHttp2Configuration.setServerPushEnabled(enable)

Parameters

enable – bool

If enable is true, a remote server can potentially use server push to send responses in advance.

See also

serverPushEnabled

PySide6.QtNetwork.QHttp2Configuration.setSessionReceiveWindowSize(size)

Parameters

size – int

Return type

bool

Sets the window size for connection-level flow control. size cannot be 0 and must not exceed 2147483647 octets.

Returns true on success, false otherwise.

See also

sessionReceiveWindowSize

PySide6.QtNetwork.QHttp2Configuration.setStreamReceiveWindowSize(size)

Parameters

size – int

Return type

bool

Sets the window size for stream-level flow control. size cannot be 0 and must not exceed 2147483647 octets.

Returns true on success, false otherwise.

See also

streamReceiveWindowSize

PySide6.QtNetwork.QHttp2Configuration.streamReceiveWindowSize()

Return type

int

Returns the window size for stream-level flow control. The default value QNetworkAccessManager will be using is 65535 octets (see RFC 7540 ).

See also

setStreamReceiveWindowSize()

PySide6.QtNetwork.QHttp2Configuration.swap(other)

Parameters

other – PySide6.QtNetwork.QHttp2Configuration

Swaps this configuration with the other configuration.