En esta página

Programación de red con Qt

El módulo « Qt Network » ofrece clases que permiten escribir clientes y servidores TCP/IP. Ofrece clases de bajo nivel, como « QTcpSocket », « QTcpServer » y « QUdpSocket », que representan conceptos de red de bajo nivel, y clases de alto nivel, como « QNetworkRequest », « QNetworkReply » y « QNetworkAccessManager », para realizar operaciones de red utilizando protocolos comunes.

Qt Network También proporciona una API para la seguridad de la capa de transporte (TLS) y funciones de seguridad que utilizan un backend TLS nativo, el kit de herramientas OpenSSL o cualquier complemento TLS adecuado. Consulte las clases de Secure Sockets Layer (SSL) para obtener más información.

Clases de Qt Network para la programación de redes

La Qt Network C++ Classes página contiene una lista de las clases de C++ en « Qt Network ».

Operaciones de red de alto nivel para HTTP

La API de acceso a la red es un conjunto de clases destinadas a realizar operaciones de red habituales. La API proporciona una capa de abstracción sobre las operaciones y los protocolos específicos utilizados (por ejemplo, la obtención y el envío de datos a través de HTTP) y solo expone clases, funciones y señales para conceptos generales o de alto nivel.

Las solicitudes de red están representadas por la clase QNetworkRequest, que también actúa como contenedor general de la información asociada a una solicitud, como la información de los encabezados y el cifrado utilizado. La URL especificada al crear un objeto de solicitud determina el protocolo utilizado para dicha solicitud. Actualmente se admiten HTTP y URL de archivos locales para la carga y descarga.

La coordinación de las operaciones de red la lleva a cabo la clase ` QNetworkAccessManager `. Una vez creada una solicitud, esta clase se utiliza para enviarla y emitir señales que informen sobre su progreso. El gestor también coordina el uso de ` cookies ` para almacenar datos en el cliente, las solicitudes de autenticación y el uso de proxies.

Las respuestas a las solicitudes de red están representadas por la clase ` QNetworkReply `; estas son creadas por ` QNetworkAccessManager ` cuando se envía una solicitud. Las señales proporcionadas por QNetworkReply pueden utilizarse para supervisar cada respuesta de forma individual, o bien los desarrolladores pueden optar por utilizar las señales del gestor para este fin y descartar las referencias a las respuestas. Dado que QNetworkReply es una subclase de QIODevice, las respuestas pueden gestionarse de forma sincrónica o asincrónica; es decir, como operaciones bloqueantes o no bloqueantes.

Cada aplicación o biblioteca puede crear una o más instancias de QNetworkAccessManager para gestionar la comunicación de red.

Uso de TCP con QTcpSocket y QTcpServer

TCP (Protocolo de Control de Transmisión) es un protocolo de red de bajo nivel utilizado por la mayoría de los protocolos de Internet, incluidos HTTP y FTP, para la transferencia de datos. Se trata de un protocolo de transporte fiable, orientado a flujos y a conexiones. Resulta especialmente adecuado para la transmisión continua de datos.

Un flujo TCP

La clase ` QTcpSocket ` proporciona una interfaz para TCP. Se puede utilizar ` QTcpSocket ` para implementar protocolos de red estándar como POP3, SMTP y NNTP, así como protocolos personalizados.

Es necesario establecer una conexión TCP con un host remoto y un puerto antes de que pueda comenzar cualquier transferencia de datos. Una vez establecida la conexión, la dirección IP y el puerto del interlocutor están disponibles a través de ` QTcpSocket::peerAddress()` y ` QTcpSocket::peerPort()`. En cualquier momento, el interlocutor puede cerrar la conexión, con lo que la transferencia de datos se detendrá inmediatamente.

QTcpSocket Funciona de forma asíncrona y emite señales para notificar cambios de estado y errores, al igual que QNetworkAccessManager. Se basa en el bucle de eventos para detectar datos entrantes y enviar automáticamente los datos salientes. Se pueden escribir datos en el socket mediante QTcpSocket::write(), y leer datos mediante QTcpSocket::read(). QTcpSocket representa dos flujos de datos independientes: uno para la lectura y otro para la escritura.

Dado que ` QTcpSocket ` hereda de ` QIODevice`, puede utilizarse con ` QTextStream ` y ` QDataStream`. Al leer desde un ` QTcpSocket`, debe asegurarse de que haya datos suficientes disponibles llamando previamente a ` QTcpSocket::bytesAvailable()`.

Si necesitas gestionar conexiones TCP entrantes (por ejemplo, en una aplicación de servidor), utiliza la clase QTcpServer. Llama a QTcpServer::listen() para configurar el servidor y conéctate a la señal QTcpServer::newConnection(), que se emite una vez por cada cliente que se conecta. En tu slot, llama a QTcpServer::nextPendingConnection() para aceptar la conexión y utiliza el QTcpSocket devuelto para comunicarte con el cliente.

Aunque la mayoría de sus funciones funcionan de forma asíncrona, es posible utilizar QTcpSocket de forma síncrona (es decir, bloqueante). Para obtener un comportamiento bloqueante, llama a las funciones waitFor...() de QTcpSocket; estas suspenden el hilo de llamada hasta que se haya emitido una señal. Por ejemplo, tras llamar a la función no bloqueante QTcpSocket::connectToHost(), llama a QTcpSocket::waitForConnected() para bloquear el hilo hasta que se haya emitido la señal connected().

Los sockets síncronos suelen dar lugar a un código con un flujo de control más sencillo. La principal desventaja del enfoque `waitFor...()` es que los eventos no se procesarán mientras una función `waitFor...()` esté bloqueada. Si se utiliza en el hilo de la interfaz gráfica de usuario (GUI), esto podría bloquear la interfaz de usuario de la aplicación. Por este motivo, recomendamos utilizar sockets síncronos únicamente en hilos que no sean de la GUI. Cuando se utiliza de forma síncrona, QTcpSocket no requiere un bucle de eventos.

Los ejemplos «Fortune Client» y «Fortune Server» muestran cómo utilizar ` QTcpSocket ` y ` QTcpServer ` para escribir aplicaciones cliente-servidor TCP. Véase también «Blocking Fortune Client» para ver un ejemplo de cómo utilizar un ` QTcpSocket ` síncrono en un hilo independiente (sin utilizar un bucle de eventos), y «Threaded Fortune Server» para ver un ejemplo de un servidor TCP multihilo con un hilo por cada cliente activo.

Uso de UDP con QUdpSocket

UDP (Protocolo de datagramas de usuario) es un protocolo ligero, no fiable, orientado a datagramas y sin conexión. Se puede utilizar cuando la fiabilidad no es importante. Por ejemplo, un servidor que informa de la hora del día podría optar por UDP. Si se pierde un datagrama con la hora del día, el cliente simplemente puede realizar otra solicitud.

Paquetes UDP

La clase « QUdpSocket » permite enviar y recibir datagramas UDP. Hereda de « QAbstractSocket » y, por lo tanto, comparte la mayor parte de la interfaz de « QTcpSocket ». La principal diferencia es que « QUdpSocket » transfiere datos en forma de datagramas en lugar de como un flujo continuo de datos. En resumen, un datagrama es un paquete de datos de tamaño limitado (normalmente inferior a 512 bytes) que contiene la dirección IP y el puerto del remitente y del destinatario del datagrama, además de los datos que se transfieren.

QUdpSocket admite la difusión (broadcasting) IPv4. La difusión se utiliza a menudo para implementar protocolos de detección de red, como por ejemplo, para averiguar qué host de la red dispone de más espacio libre en el disco duro. Un host difunde un datagrama a la red que reciben todos los demás hosts. A continuación, cada host que recibe una solicitud envía una respuesta al remitente indicando su cantidad actual de espacio libre en disco. El remitente espera hasta haber recibido respuestas de todos los hosts y, a continuación, puede elegir el servidor con más espacio libre para almacenar los datos. Para difundir un datagrama, basta con enviarlo a la dirección especial QHostAddress::Broadcast (255.255.255.255) o a la dirección de difusión de tu red local.

QUdpSocket::bind() prepara el socket para aceptar datagramas entrantes, de forma muy similar a QTcpServer::listen() para servidores TCP. Cada vez que llegan uno o más datagramas, QUdpSocket emite la señal readyRead(). Llama a QUdpSocket::readDatagram() para leer el datagrama.

Los ejemplos Broadcast Sender y Broadcast Receiver muestran cómo escribir un emisor y un receptor UDP utilizando Qt.

QUdpSocket También admite multidifusión. Los ejemplos «Multicast Sender » y «Multicast Receiver» muestran cómo escribir clientes UDP de multidifusión.

Resolución de nombres de host mediante QHostInfo

Antes de establecer una conexión de red, QTcpSocket y QUdpSocket realizan una búsqueda de nombres, traduciendo el nombre de host al que te estás conectando a una dirección IP. Esta operación se suele realizar mediante el protocolo DNS (Servicio de Nombres de Dominio).

QHostInfo proporciona una función estática que te permite realizar tú mismo dicha búsqueda. Al llamar a ` QHostInfo::lookupHost()` con un nombre de host, un puntero ` QObject ` y una firma de ranura, ` QHostInfo ` realizará la búsqueda de nombres e invocará la ranura indicada cuando los resultados estén listos. La búsqueda propiamente dicha se lleva a cabo en un hilo independiente, utilizando los propios métodos del sistema operativo para realizar búsquedas de nombres.

QHostInfo También proporciona una función estática llamada QHostInfo::fromName() que toma el nombre de host como argumento y devuelve los resultados. En este caso, la búsqueda del nombre se realiza en el mismo hilo que el de la llamada. Esta sobrecarga resulta útil para aplicaciones que no son de interfaz gráfica de usuario (GUI) o para realizar búsquedas de nombres en un hilo independiente que no sea de GUI. (Llamar a esta función en un hilo de GUI puede provocar que la interfaz de usuario se cuelgue mientras la función se bloquea al realizar la búsqueda).

Compatibilidad con proxies de red

La comunicación de red con Qt Network puede realizarse a través de proxies, que dirigen o filtran el tráfico de red entre conexiones locales y remotas.

Los proxies individuales están representados por la clase ` QNetworkProxy `, que se utiliza para describir y configurar la conexión a un proxy. Se admiten tipos de proxy que operan en diferentes niveles de comunicación de red: la compatibilidad con SOCKS 5 permite el uso de proxies para el tráfico de red a bajo nivel, mientras que los proxies HTTP y FTP funcionan a nivel de protocolo. Consulte QNetworkProxy::ProxyType para obtener más información.

El uso de un proxy se puede habilitar por cada socket o para toda la comunicación de red de una aplicación. Se puede hacer que un socket recién abierto utilice un proxy llamando a su función QAbstractSocket::setProxy() antes de que se conecte. El uso de un proxy para toda la aplicación se puede habilitar para todas las conexiones de socket posteriores mediante el uso de la función QNetworkProxy::setApplicationProxy().

Las fábricas de proxies se utilizan para crear políticas de uso de proxies. QNetworkProxyFactory proporciona proxies en función de consultas sobre tipos de proxy específicos. Las propias consultas se codifican en objetos QNetworkProxyQuery, lo que permite seleccionar proxies en función de criterios clave, como la finalidad del proxy (TCP, UDP, servidor TCP, solicitud de URL), el puerto local, el host y el puerto remotos, y el protocolo utilizado (HTTP, FTP, etc.).

QNetworkProxyFactory::proxyForQuery() se utiliza para consultar directamente la fábrica. Se puede implementar una política de proxy para toda la aplicación pasando una fábrica a QNetworkProxyFactory::setApplicationProxyFactory() y se puede crear una política de proxy personalizada creando una subclase de QNetworkProxyFactory; consulta la documentación de la clase para obtener más detalles.

© 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.