QNetworkProxyFactory Class
La clase QNetworkProxyFactory permite seleccionar el proxy con gran precisión. Más información...
| Encabezado: | #include <QNetworkProxyFactory> |
| 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
- QNetworkProxyFactory forma parte de la API de programación de redes.
Funciones públicas
| QNetworkProxyFactory() | |
| virtual | ~QNetworkProxyFactory() |
| virtual QList<QNetworkProxy> | queryProxy(const QNetworkProxyQuery &query = QNetworkProxyQuery()) = 0 |
Miembros públicos estáticos
| QList<QNetworkProxy> | proxyForQuery(const QNetworkProxyQuery &query) |
| void | setApplicationProxyFactory(QNetworkProxyFactory *factory) |
| void | setUseSystemConfiguration(bool enable) |
| QList<QNetworkProxy> | systemProxyForQuery(const QNetworkProxyQuery &query = QNetworkProxyQuery()) |
| bool | usesSystemConfiguration() |
Descripción detallada
QNetworkProxyFactory es una extensión de QNetworkProxy que permite a las aplicaciones ejercer un control más preciso sobre qué servidores proxy se utilizan, en función del socket que solicite el proxy. Esto permite a una aplicación aplicar diferentes configuraciones, por ejemplo, según el protocolo o el nombre de host de destino.
QNetworkProxyFactory se puede configurar de forma global para una aplicación, en cuyo caso anulará cualquier proxy global establecido con QNetworkProxy::setApplicationProxy(). Si se configura de forma global, cualquier socket creado con Qt consultará la fábrica para determinar el proxy que se debe utilizar.
También se puede configurar una fábrica en determinados marcos que admiten conexiones múltiples, como QNetworkAccessManager. Cuando se configura en dicho objeto, solo se consultará a la fábrica para los sockets creados por ese marco.
Proxies del sistema
Puedes configurar una fábrica para que utilice los ajustes del proxy del sistema. Llama a la función ` setUseSystemConfiguration()` con `true` para habilitar este comportamiento, o con `false` para deshabilitarlo.
Del mismo modo, puedes utilizar una fábrica para realizar consultas directamente al proxy del sistema llamando a su función ` systemProxyForQuery()`.
Advertencia: Dependiendo de la configuración del sistema del usuario, el uso de las funciones del proxy del sistema en determinadas plataformas puede estar sujeto a limitaciones. La documentación de systemProxyForQuery() contiene una lista de estas limitaciones para las plataformas afectadas.
Documentación de la función miembro
QNetworkProxyFactory::QNetworkProxyFactory()
Crea un objeto QNetworkProxyFactory.
Dado que QNetworkProxyFactory es una clase abstracta, no se pueden crear objetos de tipo QNetworkProxyFactory directamente.
[virtual noexcept] QNetworkProxyFactory::~QNetworkProxyFactory()
Elimina el objeto « QNetworkProxyFactory ».
[static] QList<QNetworkProxy> QNetworkProxyFactory::proxyForQuery(const QNetworkProxyQuery &query)
Esta función toma la solicitud de consulta, query, examina los detalles del tipo de socket o solicitud y devuelve una lista de objetos QNetworkProxy que indican los servidores proxy que se deben utilizar, por orden de preferencia.
[pure virtual] QList<QNetworkProxy> QNetworkProxyFactory::queryProxy(const QNetworkProxyQuery &query = QNetworkProxyQuery())
Esta función toma la solicitud de consulta, query, examina los detalles del tipo de socket o solicitud y devuelve una lista de objetos QNetworkProxy que indican los servidores proxy que se deben utilizar, por orden de preferencia.
Al reimplementar esta clase, asegúrate de devolver al menos un elemento.
Si no se puede determinar una alternativa de proxy mejor, utilice QNetworkProxy::DefaultProxy, que indica al código que solicita un proxy que utilice una alternativa de mayor nivel. Por ejemplo, si esta fábrica se configura con un objeto QNetworkAccessManager, DefaultProxy le indicará que consulte la configuración de proxy a nivel de aplicación.
Si esta fábrica se establece como la fábrica de proxies de la aplicación, DefaultProxy y NoProxy tendrán el mismo significado.
[static] void QNetworkProxyFactory::setApplicationProxyFactory(QNetworkProxyFactory *factory)
Establece el generador de proxies para toda la aplicación en factory. Esta función asumirá la propiedad de ese objeto y lo eliminará cuando sea necesario.
El proxy para toda la aplicación se utiliza como último recurso cuando todas las demás solicitudes de selección de proxy han devuelto QNetworkProxy::DefaultProxy. Por ejemplo, a los objetos QTcpSocket se les puede asignar un proxy mediante QTcpSocket::setProxy, pero si no se ha establecido ninguno, se consultará la clase de fábrica de proxies establecida con esta función.
Si se establece una fábrica de proxies con esta función, se anularán todos los proxies a nivel de aplicación establecidos con ` QNetworkProxy::setApplicationProxy `, y ` usesSystemConfiguration()` devolverá ` false`.
Véanse también QNetworkProxy::setApplicationProxy(), QAbstractSocket::proxy() y QAbstractSocket::setProxy().
[static] void QNetworkProxyFactory::setUseSystemConfiguration(bool enable)
Habilita el uso de la configuración de proxy específica de la plataforma, y únicamente esa. Consulta systemProxyForQuery() para obtener más información.
Al llamar a esta función con enable establecido en true, se restablecen cualquier configuración de proxy o QNetworkProxyFactory que ya esté establecida.
Nota: Consulte la documentación de systemProxyForQuery() para obtener una lista de las limitaciones relacionadas con el uso de proxies del sistema.
[static] QList<QNetworkProxy> QNetworkProxyFactory::systemProxyForQuery(const QNetworkProxyQuery &query = QNetworkProxyQuery())
Esta función toma la solicitud de consulta, query, examina los detalles del tipo de socket o solicitud y devuelve una lista de objetos QNetworkProxy que indican los servidores proxy que se deben utilizar, por orden de preferencia.
Esta función se puede utilizar para determinar la configuración de proxy específica de cada plataforma. Esta función utilizará las bibliotecas proporcionadas por el sistema operativo para determinar el proxy para una conexión determinada, si dichas bibliotecas existen. Si no es así, esta función simplemente devolverá un objeto ` QNetworkProxy ` de tipo ` QNetworkProxy::NoProxy`.
En Windows, esta función utilizará las funciones de la DLL WinHTTP. A pesar de su nombre, Microsoft recomienda utilizarla para todas las aplicaciones que requieran conexiones de red, no solo HTTP. De este modo, se respetarán los ajustes de proxy configurados en el registro mediante la herramienta proxycfg.exe. Si no se encuentran dichos ajustes, esta función intentará obtener los ajustes de Internet Explorer y los utilizará.
En macOS, esta función obtendrá la configuración del proxy utilizando el marco CFNetwork de Apple. Aplicará las configuraciones de proxy FTP, HTTP y HTTPS a las consultas que contengan la etiqueta de protocolo «ftp», «http» y «https», respectivamente. Si el proxy SOCKS está habilitado en dicha configuración, esta función utilizará el servidor SOCKS para todas las consultas. Si SOCKS no está habilitado, utilizará el proxy HTTPS para todas las consultas de TcpSocket y UrlRequest.
En sistemas configurados con soporte para libproxy, esta función recurrirá a libproxy para obtener la configuración del proxy. Dependiendo de la configuración de libproxy, esta puede a su vez delegar en la configuración del escritorio, las variables de entorno, etc.
En otros sistemas, esta función obtendrá la configuración del proxy de la variable de entorno «http_proxy». Esta variable debe ser una URL que utilice uno de los siguientes esquemas: «http», «socks5» o «socks5h».
Limitaciones
Estas son las limitaciones de la versión actual de esta función. Es posible que en futuras versiones de Qt se eliminen algunas de las limitaciones aquí enumeradas.
- En plataformas Windows, esta función puede tardar varios segundos en ejecutarse, dependiendo de la configuración del sistema del usuario.
[static] bool QNetworkProxyFactory::usesSystemConfiguration()
Devuelve si está habilitado el uso de ajustes de proxy específicos de la plataforma.
© 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.