QNetworkRequest Class

Documentation des fonctions membres

QNetworkRequest::QNetworkRequest()

Crée un objet `QNetworkRequest` sans URL à interroger. Utilisez ` setUrl()` pour en définir une.

Voir également url() et setUrl().

[explicit] QNetworkRequest::QNetworkRequest(const QUrl &url)

Crée un objet QNetworkRequest avec l'URL url comme URL à interroger.

Voir également url() et setUrl().

QNetworkRequest::QNetworkRequest(const QNetworkRequest &other)

Crée une copie de other.

[noexcept] QNetworkRequest::~QNetworkRequest()

Supprime l'objet « QNetworkRequest ».

QVariant QNetworkRequest::attribute(QNetworkRequest::Attribute code, const QVariant &defaultValue = QVariant()) const

Renvoie l'attribut associé au code code. Si l'attribut n'a pas été défini, la fonction renvoie defaultValue.

Voir également ` setAttribute()` et ` QNetworkRequest::Attribute`.

[since 6.2] qint64 QNetworkRequest::decompressedSafetyCheckThreshold() const

Renvoie le seuil utilisé pour la détection des « archive bombs ».

Si la taille décompressée d'une réponse est inférieure à cette valeur, Qt se contentera de la décompresser, sans effectuer d'autres vérifications.

Cette fonction a été introduite dans Qt 6.2.

Voir également setDecompressedSafetyCheckThreshold().

bool QNetworkRequest::hasRawHeader(QAnyStringView headerName) const

Renvoie « true » si l'en-tête brut « headerName » est présent dans cette requête réseau.

Voir également rawHeader() et setRawHeader().

QVariant QNetworkRequest::header(QNetworkRequest::KnownHeaders header) const

Renvoie la valeur de l'en-tête réseau connu « header » s'il est présent dans cette requête. S'il n'est pas présent, renvoie QVariant() (c'est-à-dire un variant non valide).

Voir également KnownHeaders, rawHeader() et setHeader().

[since 6.8] QHttpHeaders QNetworkRequest::headers() const

Renvoie les en-têtes définis dans cette requête réseau.

Cette fonction a été introduite dans Qt 6.8.

Voir également setHeaders().

[since 6.5] QHttp1Configuration QNetworkRequest::http1Configuration() const

Renvoie les paramètres actuels utilisés par ` QNetworkAccessManager ` pour la connexion HTTP/1 sous-jacente de cette requête.

Cette fonction a été introduite dans Qt 6.5.

Voir aussi setHttp1Configuration.

QHttp2Configuration QNetworkRequest::http2Configuration() const

Renvoie les paramètres actuels utilisés par QNetworkAccessManager pour cette requête et sa connexion HTTP/2 sous-jacente. Il s'agit soit d'une configuration précédemment définie par une application, soit d'une configuration par défaut.

Les valeurs par défaut utilisées par QNetworkAccessManager sont les suivantes :

• La taille de la fenêtre pour le contrôle de flux au niveau de la connexion est de 2147483647 octets
• La taille de fenêtre pour le contrôle de flux au niveau du flux est de 2 147 483 64 octets
• La taille maximale de trame est de 16 384

Par défaut, la fonctionnalité « server push » est désactivée, tandis que la compression Huffman et l’indexation des chaînes de caractères sont activées.

Voir également setHttp2Configuration.

int QNetworkRequest::maximumRedirectsAllowed() const

Renvoie le nombre maximal de redirections autorisées pour cette requête.

Voir également setMaximumRedirectsAllowed().

QObject *QNetworkRequest::originatingObject() const

Renvoie une référence à l'objet qui a lancé cette requête réseau ; renvoie « nullptr » si cette référence n'est pas définie ou si l'objet a été détruit.

Voir également setOriginatingObject().

QString QNetworkRequest::peerVerifyName() const

Renvoie le nom d'hôte défini pour la validation du certificat, tel qu'il a été configuré via setPeerVerifyName. Par défaut, cette fonction renvoie une chaîne vide.

Voir également setPeerVerifyName.

QNetworkRequest::Priority QNetworkRequest::priority() const

Renvoie la priorité de cette requête.

Voir également setPriority().

QByteArray QNetworkRequest::rawHeader(QAnyStringView headerName) const

Renvoie la forme brute de l'en-tête headerName. Si cet en-tête n'existe pas, un QByteArray vide est renvoyé, ce qui peut être impossible à distinguer d'un en-tête présent mais sans contenu (utilisez hasRawHeader() pour vérifier si l'en-tête existe ou non).

Les en-têtes bruts peuvent être définis à l'aide de ` setRawHeader()` ou de ` setHeader()`.

Voir également header() et setRawHeader().

QList<QByteArray> QNetworkRequest::rawHeaderList() const

Renvoie une liste de tous les en-têtes bruts définis dans cette requête réseau. La liste est classée dans l'ordre dans lequel les en-têtes ont été définis.

Voir également hasRawHeader() et rawHeader().

void QNetworkRequest::setAttribute(QNetworkRequest::Attribute code, const QVariant &value)

Définit l'attribut associé au code code sur la valeur value. Si l'attribut est déjà défini, la valeur précédente est ignorée. En particulier, si value correspond à un code QVariant non valide, l'attribut est désactivé.

Voir également attribute() et QNetworkRequest::Attribute.

[since 6.2] void QNetworkRequest::setDecompressedSafetyCheckThreshold(qint64 threshold)

Définit l'threshold e des vérifications de « bombe d'archive ».

Certains algorithmes de compression pris en charge peuvent, à partir d’un fichier compressé de très petite taille, générer un fichier décompressé d’une taille spectaculairement importante. Cela n’est possible que si le contenu décompressé est extrêmement monotone, ce qui est rarement le cas pour de véritables fichiers transmis de bonne foi : les fichiers présentant des taux de compression aussi démesurés sont généralement des charges utiles d’attaques par débordement de tampon ou d’attaques par déni de service (en consommant trop de mémoire). Par conséquent, les fichiers qui, une fois décompressés, atteignent des tailles gigantesques, en particulier s'ils proviennent de fichiers compressés de très petite taille, doivent de préférence être rejetés car soupçonnés d'être des logiciels malveillants.

Si la taille décompressée d’une réponse dépasse ce seuil (par défaut, 10 Mio, soit 10 * 1024 * 1024), Qt vérifiera le taux de compression : s’il est déraisonnablement élevé (40:1 pour GZip et Deflate, ou 100:1 pour Brotli et ZStandard), la réponse sera traitée comme une erreur. Définir le seuil sur -1 désactive cette vérification.

Cette fonction a été introduite dans Qt 6.2.

Voir également decompressedSafetyCheckThreshold().

void QNetworkRequest::setHeader(QNetworkRequest::KnownHeaders header, const QVariant &value)

Définit la valeur de l'en-tête connu « header » sur « value », en remplaçant tout en-tête précédemment défini. Cette opération définit également l'en-tête HTTP brut équivalent.

Voir également KnownHeaders, setRawHeader() et header().

[since 6.8] void QNetworkRequest::setHeaders(QHttpHeaders &&newHeaders)

Définit les en-têtes suivants : newHeaders dans cette requête réseau, en remplaçant tous les en-têtes précédemment définis.

Si certains en-têtes correspondent à des en-têtes connus, leurs valeurs seront analysées et la forme analysée correspondante sera également définie.

Cette fonction a été introduite dans Qt 6.8.

Voir également headers() et KnownHeaders.

[since 6.8] void QNetworkRequest::setHeaders(const QHttpHeaders &newHeaders)

Cette fonction a été introduite dans Qt 6.8.

[since 6.5] void QNetworkRequest::setHttp1Configuration(const QHttp1Configuration &configuration)

Définit les paramètres HTTP/1 de la requête à partir de configuration.

Cette fonction a été introduite dans Qt 6.5.

Voir également http1Configuration, QNetworkAccessManager et QHttp1Configuration.

void QNetworkRequest::setHttp2Configuration(const QHttp2Configuration &configuration)

Définit les paramètres HTTP/2 de la requête à partir de configuration.

Voir également http2Configuration, QNetworkAccessManager et QHttp2Configuration.

void QNetworkRequest::setMaximumRedirectsAllowed(int maxRedirectsAllowed)

Définit le nombre maximal de redirections autorisées pour cette requête vers maxRedirectsAllowed.

Voir également maximumRedirectsAllowed().

void QNetworkRequest::setOriginatingObject(QObject *object)

Permet de définir une référence à l'object e à l'origine de la requête.

Par exemple, Qt WebKit définit l'objet d'origine comme étant le QWebFrame qui a lancé la requête.

Voir également ` originatingObject()` ().

void QNetworkRequest::setPeerVerifyName(const QString &peerName)

Définit peerName comme nom d'hôte pour la validation du certificat, à la place de celui utilisé pour la connexion TCP.

Voir également peerVerifyName.

void QNetworkRequest::setPriority(QNetworkRequest::Priority priority)

Définissez la priorité de cette requête sur « priority ».

Voir également priority().

void QNetworkRequest::setRawHeader(const QByteArray &headerName, const QByteArray &headerValue)

Définit l'headerName de l'en-tête sur la valeur headerValue. Si headerName correspond à un en-tête connu (voir QNetworkRequest::KnownHeaders), le format brut sera analysé et l'en-tête « préparé » correspondant sera également défini.

Par exemple :

request.setRawHeader(QByteArray("Last-Modified"), QByteArray("Sun, 06 Nov 1994 08:49:37 GMT"));

définira également l’en-tête connu LastModifiedHeader comme étant l’objet QDateTime correspondant à la date analysée.

Voir également KnownHeaders, setHeader(), hasRawHeader() et rawHeader().

void QNetworkRequest::setSslConfiguration(const QSslConfiguration &config)

Définit la configuration SSL de cette requête réseau sur config. Les paramètres concernés sont la clé privée, le certificat local, le protocole TLS (par exemple TLS 1.3), les certificats d'autorité de certification (CA) et les algorithmes de chiffrement que le backend SSL est autorisé à utiliser.

Voir également sslConfiguration() et QSslConfiguration::defaultConfiguration().

[since 6.11] void QNetworkRequest::setTcpKeepAliveIdleTimeBeforeProbes(std::chrono::seconds idle)

Définit la durée pendant laquelle la connexion doit rester inactive avant que le protocole TCP ne commence à envoyer des requêtes de maintien de connexion (keepalive) à l'adresse idle, si la fonctionnalité TCP Keepalive a été activée.

Cette fonction a été introduite dans Qt 6.11.

Voir également tcpKeepAliveIdleTimeBeforeProbes().

[since 6.11] void QNetworkRequest::setTcpKeepAliveIntervalBetweenProbes(std::chrono::seconds interval)

Définit l'intervalle entre chaque requête de maintien de connexion (keepalive) à interval, si la fonctionnalité TCP Keepalive a été activée.

Cette fonction a été introduite dans Qt 6.11.

Voir également tcpKeepAliveIntervalBetweenProbes().

[since 6.11] void QNetworkRequest::setTcpKeepAliveProbeCount(int probes)

Définit le nombre maximal d'probes s « keepalive » que le protocole TCP doit envoyer avant de couper la connexion, si la fonctionnalité TCP Keepalive a été activée.

Cette fonction a été introduite dans Qt 6.11.

Voir également ` tcpKeepAliveProbeCount()`.

void QNetworkRequest::setTransferTimeout(int timeout)

Définit la valeur timeout comme délai d'expiration du transfert, en millisecondes.

Voir également setTransferTimeout(std::chrono::milliseconds), transferTimeout() et transferTimeoutAsDuration().

[since 6.7] void QNetworkRequest::setTransferTimeout(std::chrono::milliseconds duration = DefaultTransferTimeout)

Définit le délai d'duration, au-delà duquel le transfert est interrompu si aucune donnée n'est échangée.

Les transferts sont interrompus si aucun octet n’est transféré avant l’expiration du délai d’attente. La valeur zéro signifie qu’aucun délai d’attente n’est défini. Si aucun argument n’est fourni, le délai d’attente est QNetworkRequest::DefaultTransferTimeout. Si cette fonction n’est pas appelée, le délai d’attente est désactivé et prend la valeur zéro.

Cette fonction a été introduite dans Qt 6.7.

Voir également transferTimeoutAsDuration().

void QNetworkRequest::setUrl(const QUrl &url)

Définit l'URL à laquelle cette requête réseau fait référence comme étant url.

Voir aussi url().

QSslConfiguration QNetworkRequest::sslConfiguration() const

Renvoie la configuration SSL de cette requête réseau. Par défaut, elle est identique à celle renvoyée par la fonction QSslConfiguration::defaultConfiguration().

Voir également setSslConfiguration() et QSslConfiguration::defaultConfiguration().

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

Permet d'échanger cette requête réseau contre celle de other. Cette opération est très rapide et ne rencontre jamais d'échec.

[since 6.11] std::chrono::seconds QNetworkRequest::tcpKeepAliveIdleTimeBeforeProbes() const

Renvoie la durée pendant laquelle la connexion doit rester inactive avant que le protocole TCP ne commence à envoyer des requêtes de maintien de connexion (keepalive), si la fonctionnalité TCP Keepalive a été activée.

Cette fonction a été introduite dans Qt 6.11.

Voir également ` setTcpKeepAliveIdleTimeBeforeProbes()`.

[since 6.11] std::chrono::seconds QNetworkRequest::tcpKeepAliveIntervalBetweenProbes() const

Renvoie le délai entre deux requêtes de maintien de connexion, si la fonctionnalité TCP Keepalive a été activée.

Cette fonction a été introduite dans Qt 6.11.

Voir également ` setTcpKeepAliveIntervalBetweenProbes()`.

[since 6.11] int QNetworkRequest::tcpKeepAliveProbeCount() const

Renvoie le nombre maximal de requêtes de maintien de connexion (keepalive) que le protocole TCP doit envoyer avant de fermer la connexion, si la fonctionnalité TCP Keepalive a été activée.

Cette fonction a été introduite dans Qt 6.11.

Voir également ` setTcpKeepAliveProbeCount()`.

int QNetworkRequest::transferTimeout() const

Renvoie le délai d'expiration utilisé pour les transferts, en millisecondes.

Si transferTimeoutAsDuration().count() ne peut pas être représenté sous la forme int, cette fonction renvoie à la place INT_MAX/INT_MIN.

Voir également setTransferTimeout() et transferTimeoutAsDuration().

[since 6.7] std::chrono::milliseconds QNetworkRequest::transferTimeoutAsDuration() const

Renvoie la durée du délai d'expiration au-delà duquel le transfert est interrompu si aucune donnée n'est échangée.

La durée par défaut est zéro, ce qui signifie que le délai d'expiration n'est pas utilisé.

Cette fonction a été introduite dans Qt 6.7.

Voir également setTransferTimeout(std::chrono::milliseconds).

QUrl QNetworkRequest::url() const

Renvoie l'URL à laquelle se réfère cette requête réseau.

Voir également setUrl().

bool QNetworkRequest::operator!=(const QNetworkRequest &other) const

Renvoie « false » si cet objet n'est pas identique à « other ».

Voir également operator==().

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

Crée une copie de other

bool QNetworkRequest::operator==(const QNetworkRequest &other) const

Renvoie « true » si cet objet est identique à « other » (c'est-à-dire s'ils ont la même URL, les mêmes en-têtes et les mêmes paramètres de métadonnées).

Voir également operator!=().