就業培訓     下載中心     Wiki     聯絡
登錄   注冊
  1. 首頁
  2. Qt 6.10.1
  3. Qt Network
  4. C++ 類
  5. QHttp2Configuration

QHttp2Configuration Class

The QHttp2Configuration class controls HTTP/2 parameters and settings. 更多...

頭： #include <QHttp2Configuration>
CMake: find_package(Qt6 REQUIRED COMPONENTS Network)
target_link_libraries(mytarget PRIVATE Qt6::Network)
qmake: QT += network

注意： 此類的所有函數 可重入 .

公共函數

QHttp2Configuration ()
QHttp2Configuration (const QHttp2Configuration & other )
QHttp2Configuration (QHttp2Configuration && other )
~QHttp2Configuration ()
bool huffmanCompressionEnabled () const
(從 6.9 起) 無符號 int maxConcurrentStreams () const
無符號 int maxFrameSize () const
bool serverPushEnabled () const
無符號 int sessionReceiveWindowSize () const
void setHuffmanCompressionEnabled (bool enable )
(從 6.9 起) void setMaxConcurrentStreams (unsigned int value )
bool setMaxFrameSize (unsigned int size )
void setServerPushEnabled (bool enable )
bool setSessionReceiveWindowSize (unsigned int size )
bool setStreamReceiveWindowSize (unsigned int size )
無符號 int streamReceiveWindowSize () const
void swap (QHttp2Configuration & other )
QHttp2Configuration & operator= (QHttp2Configuration && other )
QHttp2Configuration & operator= (const QHttp2Configuration & other )
bool operator!= (const QHttp2Configuration & lhs , const QHttp2Configuration & rhs )
bool operator== (const QHttp2Configuration & lhs , const QHttp2Configuration & rhs )

詳細描述

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.

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

注意： 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 .

另請參閱 QNetworkRequest::setHttp2Configuration (), QNetworkRequest::http2Configuration ()，和 QNetworkAccessManager .

成員函數文檔編製

QHttp2Configuration:: 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

QHttp2Configuration:: QHttp2Configuration (const QHttp2Configuration & other )

Copy-constructs this QHttp2Configuration.

[noexcept] QHttp2Configuration:: QHttp2Configuration ( QHttp2Configuration && other )

Move-constructs this QHttp2Configuration from other

[noexcept] QHttp2Configuration:: ~QHttp2Configuration ()

析構函數。

bool QHttp2Configuration:: huffmanCompressionEnabled () const

返迴 true if the Huffman coding in HPACK is enabled.

另請參閱 setHuffmanCompressionEnabled .

[since 6.9] unsigned int QHttp2Configuration:: maxConcurrentStreams () const

Returns the maximum number of concurrent streams.

該函數在 Qt 6.9 引入。

另請參閱 setMaxConcurrentStreams ().

unsigned int QHttp2Configuration:: maxFrameSize () const

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

另請參閱 setMaxFrameSize ().

bool QHttp2Configuration:: serverPushEnabled () const

Returns true if server push was enabled.

注意： 默認情況下， QNetworkAccessManager disables server push via the 'SETTINGS' frame.

另請參閱 setServerPushEnabled .

unsigned int QHttp2Configuration:: sessionReceiveWindowSize () const

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

另請參閱 setSessionReceiveWindowSize ().

void QHttp2Configuration:: setHuffmanCompressionEnabled ( bool enable )

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

注意： This parameter only affects 'HEADERS' frames that QNetworkAccessManager is sending.

另請參閱 huffmanCompressionEnabled .

[since 6.9] void QHttp2Configuration:: setMaxConcurrentStreams ( unsigned int value )

設置 value as the maximum number of concurrent streams that will be advertised to the peer when sending SETTINGS frame.

該函數在 Qt 6.9 引入。

另請參閱 maxConcurrentStreams ().

bool QHttp2Configuration:: setMaxFrameSize ( unsigned int size )

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

注意： 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.

返迴 true 當成功時， false 否則。

另請參閱 maxFrameSize ().

void QHttp2Configuration:: setServerPushEnabled ( bool enable )

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

另請參閱 serverPushEnabled .

bool QHttp2Configuration:: setSessionReceiveWindowSize ( unsigned int size )

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

返迴 true 當成功時， false 否則。

另請參閱 sessionReceiveWindowSize .

bool QHttp2Configuration:: setStreamReceiveWindowSize ( unsigned int size )

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

返迴 true 當成功時， false 否則。

另請參閱 streamReceiveWindowSize .

unsigned int QHttp2Configuration:: streamReceiveWindowSize () const

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

另請參閱 setStreamReceiveWindowSize ().

[noexcept] void QHttp2Configuration:: swap ( QHttp2Configuration & other )

Swaps this configuration with other 。此操作很快且從不失敗。

[noexcept] QHttp2Configuration &QHttp2Configuration:: operator= ( QHttp2Configuration && other )

移動賦值 other 到此 QHttp2Configuration .

QHttp2Configuration &QHttp2Configuration:: operator= (const QHttp2Configuration & other )

Copy-assigns other 到此 QHttp2Configuration .

相關非成員

[noexcept] bool operator!= (const QHttp2Configuration & lhs , const QHttp2Configuration & rhs )

返迴 true if lhs and rhs do not have the same set of HTTP/2 parameters.

[noexcept] bool operator== (const QHttp2Configuration & lhs , const QHttp2Configuration & rhs )

返迴 true if lhs and rhs have the same set of HTTP/2 parameters.

內容

  1. 公共函數

  2. 相關非成員

  3. 詳細描述