Servidor Fortune

Muestra cómo crear un servidor para un servicio de red.

Este ejemplo está pensado para ejecutarse junto con el ejemplo «Cliente Fortune » o el ejemplo «Cliente Fortune con bloqueo ».

Captura de pantalla del ejemplo del servidor Fortune

Utiliza un « QTcpServer » para aceptar conexiones TCP entrantes y un sencillo protocolo de transferencia de datos basado en « QDataStream » para enviar una «fortune» al cliente que se conecta (del ejemplo «Fortune Client» ), antes de cerrar la conexión.

class Server : public QDialog
{
    Q_OBJECT

public:
    explicit Server(QWidget *parent = nullptr);

private slots:
    void sendFortune();

private:
    void initServer();

    QLabel *statusLabel = nullptr;
    QTcpServer *tcpServer = nullptr;
    QList<QString> fortunes;
};

El servidor se implementa mediante una clase sencilla con un único slot, para gestionar las conexiones entrantes.

    tcpServer = new QTcpServer(this);
    if (!tcpServer->listen()) {
        QMessageBox::critical(this, tr("Fortune Server"),
                              tr("Unable to start the server: %1.")
                              .arg(tcpServer->errorString()));
        close();
        return;
    }
    QString ipAddress;
    const QList<QHostAddress> ipAddressesList = QNetworkInterface::allAddresses();
    // use the first non-localhost IPv4 address
    for (const QHostAddress &entry : ipAddressesList) {
        if (entry != QHostAddress::LocalHost && entry.toIPv4Address()) {
            ipAddress = entry.toString();
            break;
        }
    }
    // if we did not find one, use IPv4 localhost
    if (ipAddress.isEmpty())
        ipAddress = QHostAddress(QHostAddress::LocalHost).toString();
    statusLabel->setText(tr("The server is running on\n\nIP: %1\nport: %2\n\n"
                            "Run the Fortune Client example now.")
                         .arg(ipAddress).arg(tcpServer->serverPort()));

En su constructor, nuestro objeto Server llama a QTcpServer::listen() para configurar un QTcpServer que escuche en todas las direcciones, en un puerto arbitrario. A continuación, muestra el puerto QTcpServer elegido en una etiqueta, para que el usuario sepa a qué puerto debe conectarse el cliente «fortune».

fortunes << tr("You've been leading a dog's life. Stay off the furniture.")
         << tr("You've got to think about tomorrow.")
         << tr("You will be surprised by a loud noise.")
         << tr("You will feel hungry again in another hour.")
         << tr("You might have mail.")
         << tr("You cannot kill time without injuring eternity.")
         << tr("Computers are not intelligent. They only think they are.");

Nuestro servidor genera una lista de frases aleatorias que puede enviar a los clientes que se conecten.

connect(tcpServer, &QTcpServer::newConnection, this, &Server::sendFortune);

Cuando un cliente se conecta a nuestro servidor, QTcpServer emitirá QTcpServer::newConnection(). A su vez, esto invocará nuestra ranura sendFortune():

void Server::sendFortune()
{
    QByteArray block;
    QDataStream out(&block, QIODevice::WriteOnly);
    out.setVersion(QDataStream::Qt_6_5);

    out << fortunes[QRandomGenerator::global()->bounded(fortunes.size())];

El objetivo de este slot es seleccionar una línea aleatoria de nuestra lista de frases, codificarla en un ` QByteArray ` utilizando ` QDataStream` y, a continuación, escribirla en el socket de conexión. Esta es una forma habitual de transferir datos binarios utilizando ` QTcpSocket`. Primero creamos un objeto ` QByteArray ` y un objeto ` QDataStream `, pasando la matriz de bytes al constructor de ` QDataStream`. A continuación, establecemos explícitamente la versión del protocolo de QDataStream en QDataStream::Qt_5_10 para garantizar que podamos comunicarnos con clientes de futuras versiones de Qt (véase QDataStream::setVersion()). Continuamos transmitiendo un mensaje aleatorio de «fortune».

    QTcpSocket *clientConnection = tcpServer->nextPendingConnection();
    connect(clientConnection, &QAbstractSocket::disconnected,
            clientConnection, &QObject::deleteLater);

A continuación, llamamos a ` QTcpServer::nextPendingConnection()`, que devuelve el ` QTcpSocket ` que representa el lado del servidor de la conexión. Al conectar ` QTcpSocket::disconnected()` a ` QObject::deleteLater()`, nos aseguramos de que el socket se elimine tras la desconexión.

    clientConnection->write(block);
    clientConnection->disconnectFromHost();
}

La frase de la fortuna codificada se escribe mediante QTcpSocket::write(), y finalmente llamamos a QTcpSocket::disconnectFromHost(), que cerrará la conexión una vez que QTcpSocket haya terminado de escribir la frase de la fortuna en la red. Dado que QTcpSocket funciona de forma asíncrona, los datos se escribirán después de que esta función devuelva un valor, y el control volverá al bucle de eventos de Qt. A continuación, el socket se cerrará, lo que a su vez hará que QObject::deleteLater() lo elimine.

Proyecto de ejemplo en code.qt.io

Véase también Cliente de Fortune y Servidor de Fortune multihilo.

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