QNetworkProxyQuery Class

Documentation des fonctions membres

QNetworkProxyQuery::QNetworkProxyQuery()

Crée un objet `QNetworkProxyQuery` par défaut. Par défaut, le type de requête sera ` QNetworkProxyQuery::TcpSocket`.

[explicit] QNetworkProxyQuery::QNetworkProxyQuery(const QUrl &requestUrl, QNetworkProxyQuery::QueryType queryType = UrlRequest)

Crée un objet `QNetworkProxyQuery` avec l'URL requestUrl et définit le type de requête sur ` queryType`.

Voir également protocolTag(), peerHostName() et peerPort().

[explicit] QNetworkProxyQuery::QNetworkProxyQuery(quint16 bindPort, const QString &protocolTag = QString(), QNetworkProxyQuery::QueryType queryType = TcpServer)

Crée un objet `QNetworkProxyQuery` de type ` queryType ` et définit la balise de protocole sur ` protocolTag`. Ce constructeur est adapté aux requêtes de type ` QNetworkProxyQuery::TcpSocket `, car il définit le numéro de port local sur ` bindPort`.

Notez que bindPort est de type quint16 afin d'indiquer le numéro de port exact demandé. La valeur -1 (inconnu) n’est pas autorisée dans ce contexte.

Voir également localPort().

QNetworkProxyQuery::QNetworkProxyQuery(const QString &hostname, int port, const QString &protocolTag = QString(), QNetworkProxyQuery::QueryType queryType = TcpSocket)

Crée un objet `QNetworkProxyQuery` de type ` queryType ` et définit l'identifiant de protocole sur ` protocolTag`. Ce constructeur est adapté aux requêtes de type « QNetworkProxyQuery::TcpSocket », car il définit le nom d'hôte du pair sur ` hostname ` et le numéro de port du pair sur ` port`.

QNetworkProxyQuery::QNetworkProxyQuery(const QNetworkProxyQuery &other)

Crée un objet `QNetworkProxyQuery` qui est une copie de ` other`.

[noexcept] QNetworkProxyQuery::~QNetworkProxyQuery()

Supprime cet objet « QNetworkProxyQuery ».

int QNetworkProxyQuery::localPort() const

Renvoie le numéro de port du socket qui acceptera les paquets entrants provenant de serveurs distants, ou -1 si le port n'est pas connu.

Voir également peerPort(), peerHostName() et setLocalPort().

QString QNetworkProxyQuery::peerHostName() const

Renvoie le nom d'hôte ou l'adresse IP de la connexion sortante demandée, ou une chaîne vide si le nom d'hôte distant n'est pas connu.

Si le type de requête est « QNetworkProxyQuery::UrlRequest », cette fonction renvoie la partie « hôte » de l’URL demandée.

Voir également peerPort(), localPort() et setPeerHostName().

int QNetworkProxyQuery::peerPort() const

Renvoie le numéro de port de la requête sortante ou -1 si ce numéro n'est pas connu.

Si le type de requête est « QNetworkProxyQuery::UrlRequest », cette fonction renvoie le numéro de port de l’URL demandée. En général, les frameworks renseignent le numéro de port à partir de leurs valeurs par défaut.

Voir également peerHostName(), localPort() et setPeerPort().

QString QNetworkProxyQuery::protocolTag() const

Renvoie la balise de protocole associée à cet objet QNetworkProxyQuery, ou un objet QString vide si la balise de protocole est inconnue.

Dans le cas de requêtes de type QNetworkProxyQuery::UrlRequest, cette fonction renvoie la valeur du composant « scheme » de l'URL.

Voir également setProtocolTag() et url().

QNetworkProxyQuery::QueryType QNetworkProxyQuery::queryType() const

Renvoie le type de requête.

Voir aussi setQueryType().

void QNetworkProxyQuery::setLocalPort(int port)

Définit le numéro de port que le socket souhaite utiliser localement pour accepter les paquets entrants provenant de serveurs distants vers port. Le port local est le plus souvent utilisé avec les types de requête « QNetworkProxyQuery::TcpServer » et « QNetworkProxyQuery::UdpSocket ».

Les valeurs valides vont de 0 à 65535 (0 indiquant que n'importe quel numéro de port est acceptable) ou -1, ce qui signifie que le numéro de port local est inconnu ou sans objet.

Dans certaines circonstances, pour des protocoles spécifiques, le numéro de port local peut également être utilisé avec une requête de type QNetworkProxyQuery::TcpSocket. Dans ce cas, le socket indique qu’il souhaite utiliser le numéro de port port lors de la connexion à un hôte distant.

Voir également localPort(), setPeerPort() et setPeerHostName().

void QNetworkProxyQuery::setPeerHostName(const QString &hostname)

Définit le nom d'hôte de la connexion sortante demandée sur hostname. Un nom d'hôte vide peut être utilisé pour indiquer que l'hôte distant est inconnu.

Le nom d’hôte du pair peut également être utilisé pour indiquer l’adresse source attendue d’une connexion entrante dans le cas des types de requêtes QNetworkProxyQuery::UdpSocket ou QNetworkProxyQuery::TcpServer.

Voir également peerHostName(), setPeerPort() et setLocalPort().

void QNetworkProxyQuery::setPeerPort(int port)

Définit le numéro de port demandé pour la connexion sortante vers port. Les valeurs valides vont de 1 à 65535, ou -1 pour indiquer que le numéro de port distant est inconnu.

Le numéro de port du pair peut également être utilisé pour indiquer le numéro de port attendu d’une connexion entrante dans le cas des types de requêtes QNetworkProxyQuery::UdpSocket ou QNetworkProxyQuery::TcpServer.

Voir également peerPort(), setPeerHostName() et setLocalPort().

void QNetworkProxyQuery::setProtocolTag(const QString &protocolTag)

Définit l'identifiant de protocole de cet objet ` QNetworkProxyQuery ` sur « protocolTag ».

La balise de protocole est une chaîne de caractères arbitraire qui indique quel protocole est utilisé sur le socket, par exemple « http », « xmpp », « telnet », etc. La balise de protocole est utilisée par le backend pour renvoyer une requête plus adaptée au protocole en question : par exemple, une connexion HTTP pourrait utiliser un serveur proxy HTTP avec mise en cache, tandis que toutes les autres connexions utiliseraient un serveur proxy SOCKSv5 plus performant.

Voir également protocolTag().

void QNetworkProxyQuery::setQueryType(QNetworkProxyQuery::QueryType type)

Définit le type de requête de cet objet sur « type ».

Voir également queryType().

void QNetworkProxyQuery::setUrl(const QUrl &url)

Définit le composant URL de cet objet QNetworkProxyQuery sur url. La définition de l'URL définit également la balise de protocole, le nom d'hôte distant et le numéro de port. Cela permet de faciliter la mise en œuvre du code qui détermine le serveur proxy à utiliser.

Voir également url(), peerHostName() et peerPort().

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

Remplace cette instance de requête proxy du réseau par other. Cette opération est très rapide et ne rencontre jamais d'échec.

QUrl QNetworkProxyQuery::url() const

Renvoie la partie URL de cet objet QNetworkProxyQuery en cas de requête de type QNetworkProxyQuery::UrlRequest.

Voir aussi setUrl().

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

Renvoie « true » si cet objet « QNetworkProxyQuery » ne contient pas les mêmes données que « other ».

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

Copie le contenu de other.

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

Renvoie « true » si cet objet « QNetworkProxyQuery » contient les mêmes données que « other ».