QNetworkProxyQuery Class
La clase `QNetworkProxyQuery` se utiliza para consultar la configuración del proxy de un socket. Más información...
| Cabecera: | #include <QNetworkProxyQuery> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Network) target_link_libraries(mytarget PRIVATE Qt6::Network) |
| qmake: | QT += network |
- Lista de todos los miembros, incluidos los heredados
- QNetworkProxyQuery forma parte de las clases compartidas implícitamente.
Tipos públicos
| enum | QueryType { TcpSocket, UdpSocket, SctpSocket, TcpServer, UrlRequest, SctpServer } |
Funciones públicas
| QNetworkProxyQuery() | |
| QNetworkProxyQuery(const QUrl &requestUrl, QNetworkProxyQuery::QueryType queryType = UrlRequest) | |
| QNetworkProxyQuery(quint16 bindPort, const QString &protocolTag = QString(), QNetworkProxyQuery::QueryType queryType = TcpServer) | |
| QNetworkProxyQuery(const QString &hostname, int port, const QString &protocolTag = QString(), QNetworkProxyQuery::QueryType queryType = TcpSocket) | |
| QNetworkProxyQuery(const QNetworkProxyQuery &other) | |
| ~QNetworkProxyQuery() | |
| int | localPort() const |
| QString | peerHostName() const |
| int | peerPort() const |
| QString | protocolTag() const |
| QNetworkProxyQuery::QueryType | queryType() const |
| void | setLocalPort(int port) |
| void | setPeerHostName(const QString &hostname) |
| void | setPeerPort(int port) |
| void | setProtocolTag(const QString &protocolTag) |
| void | setQueryType(QNetworkProxyQuery::QueryType type) |
| void | setUrl(const QUrl &url) |
| void | swap(QNetworkProxyQuery &other) |
| QUrl | url() const |
| bool | operator!=(const QNetworkProxyQuery &other) const |
| QNetworkProxyQuery & | operator=(const QNetworkProxyQuery &other) |
| bool | operator==(const QNetworkProxyQuery &other) const |
Descripción detallada
QNetworkProxyQuery contiene los detalles de un socket que se está creando o de una solicitud que se está realizando. Lo utilizan QNetworkProxy y QNetworkProxyFactory para permitir a las aplicaciones un control más preciso sobre qué servidores proxy se utilizan, en función de los detalles de la consulta. Esto permite a una aplicación aplicar diferentes configuraciones, por ejemplo, según el protocolo o el nombre de host de destino.
QNetworkProxyQuery admite los siguientes criterios para seleccionar el proxy:
- el tipo de consulta
- el número de puerto local que se va a utilizar
- el nombre de host de destino
- el número de puerto de destino
- el nombre del protocolo, como «http» o «ftp»
- la URL solicitada
El nombre del host de destino es el host de la conexión en el caso de los sockets de conexión salientes. Se trata del parámetro hostName pasado a QTcpSocket::connectToHost() o del componente «host» de una URL solicitada con QNetworkRequest.
El número de puerto de destino es el puerto solicitado al que conectarse en el caso de los sockets de salida, mientras que el número de puerto local es el puerto que el socket desea utilizar localmente antes de intentar la conexión externa. En la mayoría de los casos, el número de puerto local solo lo utilizan los sockets de escucha (QTcpSocket) o los sockets de datagramas (QUdpSocket).
El nombre del protocolo es una cadena arbitraria que indica el tipo de conexión que se está intentando establecer. Por ejemplo, puede coincidir con el esquema de una URL, como «http», «https» y «ftp». En la mayoría de los casos, la selección del proxy no variará en función del protocolo, pero esta información se proporciona por si se puede tomar una decisión más adecuada, como elegir un proxy HTTP con caché para las conexiones basadas en HTTP, pero un proxy SOCKSv5 más potente para todas las demás.
Es posible que algunos de los criterios no tengan sentido en todos los tipos de consulta. La siguiente tabla enumera los criterios que se utilizan con mayor frecuencia, según el tipo de consulta.
| Tipo de consulta | Descripción |
|---|---|
| TcpSocket | Sockets normales que solicitan una conexión a un servidor remoto, como QTcpSocket. El nombre de host del par y el puerto del par coinciden con los valores pasados a QTcpSocket::connectToHost(). El puerto local suele ser -1, lo que indica que el socket no tiene preferencia en cuanto al puerto que debe utilizarse. No se utiliza el componente URL. |
| UdpSocket | Sockets basados en datagramas, que pueden tanto enviar como recibir. Los campos de puerto local, host remoto o puerto remoto pueden utilizarse o dejarse sin usar, dependiendo de las características del socket. No se utiliza el componente de la URL. |
| SctpSocket | Sockets orientados a mensajes que solicitan una conexión con un servidor remoto. El nombre de host del par y el puerto del par coinciden con los valores pasados a QSctpSocket::connectToHost(). El puerto local suele ser -1, lo que indica que el socket no tiene preferencia por ningún puerto en concreto. No se utiliza el componente URL. |
| TcpServer | Sockets de servidor pasivo que escuchan en un puerto y esperan conexiones entrantes desde la red. Normalmente, solo se utiliza el puerto local, pero la dirección remota podría utilizarse en circunstancias específicas, por ejemplo, para indicar de qué host remoto se espera una conexión. El componente URL no se utiliza. |
| UrlRequest | Una solicitud de nivel más alto, como las procedentes de QNetworkAccessManager. Estas solicitudes utilizarán inevitablemente un socket TCP de salida, pero este tipo de consulta se proporciona para indicar que hay información más detallada en el componente de la URL. Para facilitar la implementación, el host y el puerto de la URL se establecen como dirección de destino. |
| SctpServer | Sockets de servidor pasivos que escuchan en un puerto SCTP y esperan conexiones entrantes desde la red. Normalmente, solo se utiliza el puerto local, pero la dirección remota podría utilizarse en circunstancias específicas, por ejemplo, para indicar de qué host remoto se espera una conexión. No se utiliza el componente URL. |
Cabe señalar que cualquiera de los criterios puede faltar o ser desconocido (un QString vacío para el nombre de host o el nombre del protocolo, -1 para los números de puerto). Si eso ocurre, las funciones que ejecutan la consulta deben hacer su mejor estimación o aplicar algunos valores por defecto definidos por la implementación.
Véase también QNetworkProxy, QNetworkProxyFactory, QNetworkAccessManager y QAbstractSocket::setProxy().
Documentación sobre los tipos de miembro
enum QNetworkProxyQuery::QueryType
Describe el tipo de una consulta « QNetworkProxyQuery ».
| Constante | Valor | Descripción |
|---|---|---|
QNetworkProxyQuery::TcpSocket | 0 | un socket TCP saliente normal |
QNetworkProxyQuery::UdpSocket | 1 | un socket UDP basado en datagramas, que podría enviar a múltiples destinos |
QNetworkProxyQuery::SctpSocket | 2 | un socket SCTP de salida orientado a mensajes |
QNetworkProxyQuery::TcpServer | 100 | un servidor TCP que escucha conexiones entrantes desde la red |
QNetworkProxyQuery::UrlRequest | 101 | una solicitud más compleja que implica la carga de una URL |
QNetworkProxyQuery::SctpServer | 102 | un servidor SCTP que escucha conexiones entrantes desde la red |
Véase también queryType() y setQueryType().
Documentación de funciones miembro
QNetworkProxyQuery::QNetworkProxyQuery()
Crea un objeto QNetworkProxyQuery predeterminado. Por defecto, el tipo de consulta será « QNetworkProxyQuery::TcpSocket ».
[explicit] QNetworkProxyQuery::QNetworkProxyQuery(const QUrl &requestUrl, QNetworkProxyQuery::QueryType queryType = UrlRequest)
Crea un objeto `QNetworkProxyQuery` con la URL requestUrl y establece el tipo de consulta en ` queryType`.
Véase también protocolTag(), peerHostName() y peerPort().
[explicit] QNetworkProxyQuery::QNetworkProxyQuery(quint16 bindPort, const QString &protocolTag = QString(), QNetworkProxyQuery::QueryType queryType = TcpServer)
Crea un objeto `QNetworkProxyQuery` de tipo ` queryType ` y establece la etiqueta de protocolo en ` protocolTag`. Este constructor es adecuado para consultas de tipo ` QNetworkProxyQuery::TcpSocket `, ya que establece el número de puerto local en ` bindPort`.
Tenga en cuenta que bindPort es de tipo quint16 para indicar el número de puerto exacto que se solicita. El valor -1 (desconocido) no está permitido en este contexto.
Véase también localPort().
QNetworkProxyQuery::QNetworkProxyQuery(const QString &hostname, int port, const QString &protocolTag = QString(), QNetworkProxyQuery::QueryType queryType = TcpSocket)
Crea un objeto `QNetworkProxyQuery` de tipo ` queryType ` y establece la etiqueta de protocolo en ` protocolTag`. Este constructor es adecuado para consultas de tipo ` QNetworkProxyQuery::TcpSocket `, ya que establece el nombre de host del par en ` hostname ` y el número de puerto del par en ` port`.
QNetworkProxyQuery::QNetworkProxyQuery(const QNetworkProxyQuery &other)
Crea un objeto `QNetworkProxyQuery` que es una copia de ` other`.
[noexcept] QNetworkProxyQuery::~QNetworkProxyQuery()
Elimina este objeto ` QNetworkProxyQuery `.
int QNetworkProxyQuery::localPort() const
Devuelve el número de puerto del socket que aceptará paquetes entrantes de servidores remotos o -1 si se desconoce el puerto.
Véase también peerPort(), peerHostName() y setLocalPort().
QString QNetworkProxyQuery::peerHostName() const
Devuelve el nombre de host o la dirección IP de la conexión saliente solicitada, o una cadena vacía si se desconoce el nombre de host remoto.
Si el tipo de consulta es ` QNetworkProxyQuery::UrlRequest`, esta función devuelve el componente de host de la URL solicitada.
Véase también peerPort(), localPort() y setPeerHostName().
int QNetworkProxyQuery::peerPort() const
Devuelve el número de puerto de la solicitud saliente o -1 si se desconoce dicho número.
Si el tipo de consulta es QNetworkProxyQuery::UrlRequest, esta función devuelve el número de puerto de la URL solicitada. En general, los marcos de trabajo completarán el número de puerto con sus valores predeterminados.
Véase también peerHostName(), localPort() y setPeerPort().
QString QNetworkProxyQuery::protocolTag() const
Devuelve la etiqueta de protocolo de este objeto QNetworkProxyQuery, o un objeto QString vacío en caso de que se desconozca la etiqueta de protocolo.
En el caso de consultas de tipo QNetworkProxyQuery::UrlRequest, esta función devuelve el valor del componente «scheme» de la URL.
Véase también setProtocolTag() y url().
QNetworkProxyQuery::QueryType QNetworkProxyQuery::queryType() const
Devuelve el tipo de consulta.
Véase también setQueryType().
void QNetworkProxyQuery::setLocalPort(int port)
Establece el número de puerto que el socket desea utilizar localmente para aceptar paquetes entrantes procedentes de servidores remotos en port. El puerto local se utiliza con mayor frecuencia con los tipos de consulta QNetworkProxyQuery::TcpServer y QNetworkProxyQuery::UdpSocket.
Los valores válidos son del 0 al 65535 (siendo 0 el valor que indica que se aceptará cualquier número de puerto) o -1, lo que significa que el número de puerto local se desconoce o no es aplicable.
En algunas circunstancias, para protocolos especiales, el número de puerto local también puede utilizarse con una consulta de tipo QNetworkProxyQuery::TcpSocket. Cuando esto ocurre, el socket indica que desea utilizar el número de puerto port al conectarse a un host remoto.
Véase también localPort(), setPeerPort() y setPeerHostName().
void QNetworkProxyQuery::setPeerHostName(const QString &hostname)
Establece el nombre de host de la conexión saliente solicitada en hostname. Se puede utilizar un nombre de host vacío para indicar que se desconoce el host remoto.
El nombre de host del par también se puede utilizar para indicar la dirección de origen esperada de una conexión entrante en el caso de los tipos de consulta QNetworkProxyQuery::UdpSocket o QNetworkProxyQuery::TcpServer.
Véase también peerHostName(), setPeerPort() y setLocalPort().
void QNetworkProxyQuery::setPeerPort(int port)
Establece el número de puerto solicitado para la conexión saliente en port. Los valores válidos son del 1 al 65535, o -1 para indicar que se desconoce el número de puerto remoto.
El número de puerto del par también se puede utilizar para indicar el número de puerto esperado de una conexión entrante en el caso de los tipos de consulta QNetworkProxyQuery::UdpSocket o QNetworkProxyQuery::TcpServer.
Véanse también peerPort(), setPeerHostName() y setLocalPort().
void QNetworkProxyQuery::setProtocolTag(const QString &protocolTag)
Establece la etiqueta de protocolo de este objeto ` QNetworkProxyQuery ` en ` protocolTag`.
La etiqueta de protocolo es una cadena arbitraria que indica qué protocolo se está utilizando a través del socket, como «http», «xmpp», «telnet», etc. El backend utiliza la etiqueta de protocolo para devolver una solicitud más específica para el protocolo en cuestión: por ejemplo, una conexión HTTP podría utilizar un servidor proxy HTTP con caché, mientras que el resto de conexiones utilizarían un servidor proxy SOCKSv5 más potente.
Véase también protocolTag().
void QNetworkProxyQuery::setQueryType(QNetworkProxyQuery::QueryType type)
Establece el tipo de consulta de este objeto como « type ».
Véase también ` queryType()`.
void QNetworkProxyQuery::setUrl(const QUrl &url)
Establece el componente URL de este objeto ` QNetworkProxyQuery ` en ` url`. Al establecer la URL, también se configurarán la etiqueta de protocolo, el nombre del host remoto y el número de puerto. Esto se hace con el fin de facilitar la implementación del código que determina el servidor proxy que se va a utilizar.
Véase también url(), peerHostName() y peerPort().
[noexcept] void QNetworkProxyQuery::swap(QNetworkProxyQuery &other)
Sustituye esta instancia de consulta del proxy de red por other. Esta operación es muy rápida y nunca falla.
QUrl QNetworkProxyQuery::url() const
Devuelve el componente URL de este objeto QNetworkProxyQuery en caso de una consulta del tipo QNetworkProxyQuery::UrlRequest.
Véase también setUrl().
bool QNetworkProxyQuery::operator!=(const QNetworkProxyQuery &other) const
Devuelve « true » si este objeto « QNetworkProxyQuery » no contiene los mismos datos que « other ».
QNetworkProxyQuery &QNetworkProxyQuery::operator=(const QNetworkProxyQuery &other)
Copia el contenido de other.
bool QNetworkProxyQuery::operator==(const QNetworkProxyQuery &other) const
Devuelve « true » si este objeto « QNetworkProxyQuery » contiene los mismos datos que « other ».
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.