QNetworkRequest Class

Documentation des fonctions membres

QNetworkRequest::QNetworkRequest()

Construit un objet QNetworkRequest sans URL à demander. Utilisez setUrl() pour en définir une.

Voir aussi url() et setUrl().

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

Construit un objet QNetworkRequest avec url comme URL à demander.

Voir aussi url() et setUrl().

QNetworkRequest::QNetworkRequest(const QNetworkRequest &other)

Crée une copie de other.

[noexcept] QNetworkRequest::~QNetworkRequest()

Se débarrasse de 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 de vérification des bombes d'archives.

Si la taille décompressée d'une réponse est inférieure à ce seuil, Qt la décompressera simplement, sans autre vérification.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi 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 aussi rawHeader() et setRawHeader().

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

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

Voir aussi KnownHeaders, rawHeader(), et setHeader().

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

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

Cette fonction a été introduite dans Qt 6.8.

Voir aussi setHeaders().

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

Renvoie les paramètres actuels que QNetworkAccessManager utilise 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 que QNetworkAccessManager utilise 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 la fenêtre pour le contrôle de flux au niveau du flux est de 214748364 octets.
• La taille maximale de la trame est de 16384

Par défaut, le server push est désactivé, la compression Huffman et l'indexation des chaînes sont activées.

Voir aussi setHttp2Configuration.

int QNetworkRequest::maximumRedirectsAllowed() const

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

Voir aussi setMaximumRedirectsAllowed().

QObject *QNetworkRequest::originatingObject() const

Renvoie une référence à l'objet qui a initié cette requête réseau ; renvoie nullptr s'il n'est pas défini ou si l'objet a été détruit.

Voir aussi setOriginatingObject().

QString QNetworkRequest::peerVerifyName() const

Renvoie le nom d'hôte défini pour la validation du certificat, tel que défini par setPeerVerifyName. Par défaut, ce nom renvoie une chaîne de caractères nulle.

Voir aussi setPeerVerifyName.

QNetworkRequest::Priority QNetworkRequest::priority() const

Renvoie la priorité de cette demande.

Voir aussi setPriority().

QByteArray QNetworkRequest::rawHeader(QAnyStringView headerName) const

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

Les en-têtes bruts peuvent être définis avec setRawHeader() ou avec setHeader().

Voir aussi 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 dans l'ordre dans lequel les en-têtes ont été définis.

Voir aussi hasRawHeader() et rawHeader().

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

Attribue la valeur value à l'attribut associé au code code. Si l'attribut est déjà défini, la valeur précédente est supprimée. En particulier, si value est un QVariant invalide, l'attribut est désactivé.

Voir aussi attribute() et QNetworkRequest::Attribute.

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

Définit l'adresse threshold pour les vérifications des bombes d'archives.

Certains algorithmes de compression pris en charge peuvent, dans un minuscule fichier compressé, coder un fichier décompressé spectaculairement énorme. Cela n'est possible que si le contenu décompressé est extrêmement monotone, ce qui est rarement le cas pour les fichiers réels transmis en toute bonne foi : les fichiers présentant des taux de compression aussi élevés sont généralement des charges utiles d'attaques par dépassement de mémoire tampon ou par déni de service (en raison de l'utilisation d'une trop grande quantité de mémoire). Par conséquent, il est préférable de rejeter les fichiers qui se décompressent pour atteindre des tailles énormes, en particulier à partir de formes compressées minuscules, car ils sont soupçonnés d'être des logiciels malveillants.

Si la taille décompressée d'une réponse est supérieure à ce seuil (par défaut, 10 MiB, c'est-à-dire 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 à -1 désactive cette vérification.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi decompressedSafetyCheckThreshold().

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

Fixe la valeur de l'en-tête connu header à 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 aussi KnownHeaders, setRawHeader(), et header().

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

Définit newHeaders en tant qu'en-tête dans cette demande de réseau, en remplaçant tout en-tête précédemment défini.

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

Cette fonction a été introduite dans Qt 6.8.

Voir aussi 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 aussi 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 maximum de redirections autorisées pour cette requête à maxRedirectsAllowed.

Voir aussi maximumRedirectsAllowed().

void QNetworkRequest::setOriginatingObject(QObject *object)

Permet de définir une référence à l'adresse object à l'origine de la demande.

Par exemple, Qt WebKit définit l'objet d'origine comme étant la QWebFrame qui a initié 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, au lieu de celui utilisé pour la connexion TCP.

Voir aussi peerVerifyName.

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

Définissez la priorité de cette demande à priority.

Voir aussi priority().

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

Fixe l'en-tête headerName à la valeur headerValue. Si headerName correspond à un en-tête connu (voir QNetworkRequest::KnownHeaders), le format brut sera analysé et l'en-tête "cuit" 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 de la date analysée.

Voir aussi KnownHeaders, setHeader(), hasRawHeader(), et rawHeader().

void QNetworkRequest::setSslConfiguration(const QSslConfiguration &config)

Définit la configuration SSL de cette demande de réseau comme étant config. Les paramètres applicables sont la clé privée, le certificat local, le protocole TLS (par exemple TLS 1.3), les certificats 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 le temps d'inactivité de la connexion avant que TCP ne commence à envoyer des sondes keepalive à idle, si la fonctionnalité TCP Keepalive a été activée.

Cette fonction a été introduite dans Qt 6.11.

Voir aussi tcpKeepAliveIdleTimeBeforeProbes().

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

Définit le temps entre les sondes keepalive individuelles à être interval, si la fonctionnalité TCP Keepalive a été activée.

Cette fonction a été introduite dans Qt 6.11.

Voir aussi tcpKeepAliveIntervalBetweenProbes().

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

Définit le nombre maximum de keepalive probes que TCP doit envoyer avant d'abandonner la connexion, si la fonctionnalité TCP Keepalive a été activée.

Cette fonction a été introduite dans Qt 6.11.

Voir aussi tcpKeepAliveProbeCount().

void QNetworkRequest::setTransferTimeout(int timeout)

Définit timeout comme délai de transfert en millisecondes.

Voir aussi setTransferTimeout(std::chrono::millisecondes), transferTimeout(), et transferTimeoutAsDuration().

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

Définit le délai d'attente duration pour interrompre le transfert 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. Zéro signifie qu'aucun délai 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 demande de 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 de QSslConfiguration::defaultConfiguration().

Voir aussi setSslConfiguration() et QSslConfiguration::defaultConfiguration().

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

Remplace cette demande de réseau par other. Cette opération est très rapide et n'échoue jamais.

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

Renvoie le temps d'inactivité de la connexion avant que TCP ne commence à envoyer des sondes keepalive, si la fonctionnalité TCP Keepalive a été activée.

Cette fonction a été introduite dans Qt 6.11.

Voir aussi setTcpKeepAliveIdleTimeBeforeProbes().

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

Renvoie le temps entre les sondes keepalive individuelles, si la fonctionnalité TCP Keepalive a été activée.

Cette fonction a été introduite dans Qt 6.11.

Voir aussi setTcpKeepAliveIntervalBetweenProbes().

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

Renvoie le nombre maximum de sondes keepalive que TCP doit envoyer avant d'abandonner la connexion, si la fonctionnalité TCP Keepalive a été activée.

Cette fonction a été introduite dans Qt 6.11.

Voir aussi setTcpKeepAliveProbeCount().

int QNetworkRequest::transferTimeout() const

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

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

Voir aussi setTransferTimeout() et transferTimeoutAsDuration().

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

Renvoie le délai d'attente après lequel 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'attente n'est pas utilisé.

Cette fonction a été introduite dans Qt 6.7.

Voir aussi setTransferTimeout(std::chrono::millisecondes).

QUrl QNetworkRequest::url() const

Renvoie l'URL à laquelle cette requête réseau fait référence.

Voir aussi setUrl().

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

Renvoie false si cet objet est différent de other.

Voir aussi 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!=().