QNetworkProxyQuery Class

Documentation des fonctions membres

QNetworkProxyQuery::QNetworkProxyQuery()

Construit un objet QNetworkProxyQuery par défaut. Par défaut, le type de requête est QNetworkProxyQuery::TcpSocket.

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

Construit un QNetworkProxyQuery avec l'URL requestUrl et définit le type de requête à queryType.

Voir aussi protocolTag(), peerHostName() et peerPort().

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

Construit un QNetworkProxyQuery de type queryType et définit la balise de protocole à protocolTag. Ce constructeur convient aux requêtes QNetworkProxyQuery::TcpSocket car il fixe le numéro de port local à bindPort.

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

Voir aussi localPort().

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

Construit un QNetworkProxyQuery de type queryType et définit la balise de protocole comme étant protocolTag. Ce constructeur convient aux requêtes QNetworkProxyQuery::TcpSocket, car il définit le nom d'hôte de l'homologue à hostname et le numéro de port de l'homologue à port.

QNetworkProxyQuery::QNetworkProxyQuery(const QNetworkProxyQuery &other)

Construit un objet QNetworkProxyQuery qui est une copie de other.

[noexcept] QNetworkProxyQuery::~QNetworkProxyQuery()

Détruit cet objet QNetworkProxyQuery.

int QNetworkProxyQuery::localPort() const

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

Voir aussi 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 le composant hôte de l'URL demandée.

Voir aussi peerPort(), localPort() et setPeerHostName().

int QNetworkProxyQuery::peerPort() const

Renvoie le numéro de port de la requête sortante ou -1 si le numéro de port 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 remplissent le numéro de port à partir de leurs valeurs par défaut.

Voir aussi peerHostName(), localPort() et setPeerPort().

QString QNetworkProxyQuery::protocolTag() const

Renvoie la balise de protocole pour cet objet QNetworkProxyQuery, ou un QString vide si la balise de protocole est inconnue.

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

Voir aussi 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 la socket souhaite utiliser localement pour accepter les paquets entrants provenant de serveurs distants à port. Le port local est le plus souvent utilisé avec les types de requêtes QNetworkProxyQuery::TcpServer et QNetworkProxyQuery::UdpSocket.

Les valeurs valides sont comprises entre 0 et 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 non applicable.

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

Voir aussi localPort(), setPeerPort(), et setPeerHostName().

void QNetworkProxyQuery::setPeerHostName(const QString &hostname)

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

Le nom de l'hôte homologue 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 requis pour la connexion sortante à port. Les valeurs valables sont comprises entre 1 et 65535, ou -1 pour indiquer que le numéro de port distant est inconnu.

Le numéro de port de l'homologue 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 la balise de protocole de cet objet QNetworkProxyQuery comme étant protocolTag.

La balise de protocole est une chaîne arbitraire qui indique le protocole utilisé sur la socket, comme "http", "xmpp", "telnet", etc. La balise de protocole est utilisée par le backend pour renvoyer une requête plus spécifique au protocole en question : par exemple, une connexion HTTP peut utiliser un serveur proxy HTTP de mise en cache, tandis que toutes les autres connexions utilisent un serveur proxy SOCKSv5 plus puissant.

Voir également protocolTag().

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

Définit le type de requête de cet objet comme étant type.

Voir aussi queryType().

void QNetworkProxyQuery::setUrl(const QUrl &url)

Définit le composant URL de cet objet QNetworkProxyQuery comme étant url. La définition de l'URL définit également la balise de protocole, le nom de l'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 aussi url(), peerHostName() et peerPort().

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

Remplace cette instance de requête de proxy réseau par other. Cette opération est très rapide et n'échoue jamais.

QUrl QNetworkProxyQuery::url() const

Renvoie le composant URL de cet objet QNetworkProxyQuery dans le cas d'une requête de type QNetworkProxyQuery::UrlRequest.

Voir aussi setUrl().

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

Renvoie true si l'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 l'objet QNetworkProxyQuery contient les mêmes données que other.