Ejemplo de servidor WebSocket
Descripción
El ejemplo «echoserver» implementa un servidor WebSocket que devuelve todo lo que se le envía.
Código
Empezamos creando un servidor WebSocket ( QWebSocketServer, `new QWebSocketServer()`). Tras la creación, escuchamos en todas las interfaces de red locales (`QHostAddress::Any`) en el puerto especificado port.
EchoServer::EchoServer(quint16 puerto, bool depuración, QObject*parent) :
QObject(parent),
m_pWebSocketServer(new QWebSocketServer(QStringLiteral("Echo Server"),
QWebSocketServer::NonSecureMode, this)),
m_debug(debug)
{
if (m_pWebSocketServer->listen(QHostAddress::Any, port)) {
if (m_debug)
qDebug() << "Echoserver listening on port" << port;
connect(m_pWebSocketServer, &QWebSocketServer::newConnection,
this, &EchoServer::onNewConnection);
connect(m_pWebSocketServer, &QWebSocketServer::closed, this, &EchoServer::closed);
}
}Si la escucha se realiza con éxito, conectamos la señal `newConnection()` a la ranura `onNewConnection()`. La señal `newConnection()` se emitirá cada vez que un nuevo cliente WebSocket se conecte a nuestro servidor.
void EchoServer::onNewConnection()
{
QWebSocket *pSocket = m_pWebSocketServer->nextPendingConnection();
connect(pSocket, &QWebSocket::textMessageReceived, this, &EchoServer::processTextMessage);
connect(pSocket, &QWebSocket::binaryMessageReceived, this, &EchoServer::processBinaryMessage);
connect(pSocket, &QWebSocket::disconnected, this, &EchoServer::socketDisconnected);
m_clients << pSocket;
}Cuando se recibe una nueva conexión, se recupera el cliente QWebSocket (`nextPendingConnection()`) y las señales que nos interesan se conectan a nuestras ranuras (`textMessageReceived()`, `binaryMessageReceived()` y `disconnected()`). El socket del cliente se guarda en una lista, por si queremos utilizarlo más adelante (en este ejemplo, no se hace nada con él).
void EchoServer::processTextMessage(QString message)
{
QWebSocket*pClient = qobject_cast<QWebSocket*>(sender());
if (m_debug)
qDebug() << "Message received:" << message;
if (pClient) {
pClient->sendTextMessage(message);
}
}Cada vez que se activa `processTextMessage()`, recuperamos el remitente y, si es válido, reenviamos el mensaje original (`sendTextMessage()`). Se hace lo mismo con los mensajes binarios.
void EchoServer::processBinaryMessage(QByteArray mensaje)
{
QWebSocket*pClient = qobject_cast<QWebSocket*>(sender());
if (m_debug)
qDebug() << "Binary Message received:" << message;
if (pClient) {
pClient->sendBinaryMessage(message);
}
}La única diferencia es que ahora el mensaje es un ` QByteArray ` en lugar de un ` QString`.
void EchoServer::socketDisconnected()
{
QWebSocket*pClient = qobject_cast<QWebSocket*>(sender());
if (m_debug)
qDebug() << "socketDisconnected:" << pClient;
if (pClient) {
m_clients.removeAll(pClient);
pClient->deleteLater();
}
}Cada vez que se desconecta un socket, lo eliminamos de la lista de clientes y lo borramos. Nota: es recomendable utilizar `deleteLater()` para borrar el socket.
© 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.