Cliente HTTP

Muestra un cliente HTTP sencillo.

Este ejemplo muestra cómo un cliente HTTP sencillo puede recuperar archivos de hosts remotos.

El usuario introduce la URL, el nombre del archivo y la ubicación de descarga en la ventana principal. La clase QNetworkAccessManager utiliza esta información para descargar el archivo

La parte principal de este ejemplo se lleva a cabo en la clase `HttpWindow`. Por lo tanto, nos centraremos en ella.

QNetworkRequest networkRequest(url);
networkRequest.setTcpKeepAliveIdleTimeBeforeProbes(20s);
networkRequest.setTcpKeepAliveIntervalBetweenProbes(2s);
networkRequest.setTcpKeepAliveProbeCount(5);

Desde Qt 6.11, es posible especificar explícitamente los parámetros de keepalive de TCP para una conexión QNetworkRequest. En el fragmento de código anterior, estamos sobrescribiendo los valores predeterminados utilizados por QNetworkAccessManager para seguir una estrategia más agresiva. Esto puede resultar útil, por ejemplo, para la detección temprana de bloqueos de red causados por cambios en la red en Linux. En este ejemplo concreto, la conexión se cerrará tras treinta segundos de inactividad.

reply.reset(qnam.get(networkRequest));

Mediante QNetworkAccessManager, iniciamos la descarga de un recurso al que apunta url. Si no estás familiarizado con él o con la función utilizada, QNetworkAccessManager::get(), o simplemente quieres profundizar en el tema, echa un vistazo a su documentación y a la de QNetworkReply y QNetworkRequest.

    connect(reply.get(), &QNetworkReply::finished, this, &HttpWindow::httpFinished);
    connect(reply.get(), &QIODevice::readyRead, this, &HttpWindow::httpReadyRead);
#if QT_CONFIG(ssl)
    connect(reply.get(), &QNetworkReply::sslErrors, this, &HttpWindow::sslErrors);
#endif

Arriba, conectamos algunas de las señales de la respuesta a las ranuras de la clase. Estas ranuras se encargarán tanto de los datos entrantes como de finalizar la descarga y gestionar los errores.

connect(reply.get(), &QIODevice::readyRead, this, &HttpWindow::httpReadyRead);

En cuanto al manejo de los datos entrantes, dado que no conocemos el tamaño máximo de descarga de ninguna entrada potencial y no queremos agotar la memoria de ningún ordenador en el que se pueda ejecutar el programa de ejemplo, gestionamos los datos entrantes en QNetworkReply::readyRead() en lugar de en QNetworkReply::finished().

void HttpWindow::httpReadyRead()
{
    // This slot gets called every time the QNetworkReply has new data.
    // We read all of its new data and write it into the file.
    // That way we use less RAM than when reading it at the finished()
    // signal of the QNetworkReply
    if (file)
        file->write(reply->readAll());
}

A continuación, escribimos los datos en un archivo a medida que llegan. Es menos cómodo, ¡pero la aplicación consumirá menos memoria en sus momentos de mayor actividad!

connect(reply.get(), &QNetworkReply::sslErrors, this, &HttpWindow::sslErrors);

Con la señal QNetworkReply::sslErrors() también podemos gestionar los errores que puedan producirse durante el protocolo de enlace TLS al conectarnos a sitios web seguros (es decir, HTTPS).

void HttpWindow::sslErrors(const QList<QSslError> &errors)
{
    QString errorString;
    for (const QSslError &error : errors) {
        if (!errorString.isEmpty())
            errorString += '\n';
        errorString += error.errorString();
    }

    if (QMessageBox::warning(this, tr("TLS Errors"),
                             tr("One or more TLS errors has occurred:\n%1").arg(errorString),
                             QMessageBox::Ignore | QMessageBox::Abort)
        == QMessageBox::Ignore) {
        reply->ignoreSslErrors();
    }
}

En este ejemplo, mostramos un cuadro de diálogo al usuario para que pueda elegir si desea ignorar los errores o no.

QNetworkReply::NetworkError error = reply->error();
const QString &errorString = reply->errorString();
if (error != QNetworkReply::NoError) {
    QFile::remove(fi.absoluteFilePath());
    // For "request aborted" we handle the label and button in cancelDownload()
    if (!httpRequestAborted) {
        statusLabel->setText(tr("Download failed:\n%1.").arg(errorString));
        downloadButton->setEnabled(true);
    }
    return;
}

Si se produce un error, QNetworkReply emitirá la señal « QNetworkReply::errorOccurred()», seguida de la señal « QNetworkReply::finished()». En este ejemplo, solo nos conectamos a esta última. Gestionamos cualquier posible error en el slot correspondiente eliminando el archivo en el que estábamos escribiendo y mostramos el error con nuestra etiqueta de estado.

connect(&qnam, &QNetworkAccessManager::authenticationRequired,
        this, &HttpWindow::slotAuthenticationRequired);

Si te conectas a un sitio web que utiliza autenticación HTTP, suponiendo que no hayas facilitado las credenciales que deben utilizarse con antelación, puedes gestionar la falta de credenciales cuando el sitio web las solicite. Con QNetworkAccessManager, lo hacemos en un slot conectado a la señal QNetworkAccessManager::authenticationRequired(). Realizamos esta conexión una sola vez, en el constructor.

void HttpWindow::slotAuthenticationRequired(QNetworkReply *, QAuthenticator *authenticator)
{
    QDialog authenticationDialog;
    Ui::Dialog ui;
    ui.setupUi(&authenticationDialog);
    authenticationDialog.adjustSize();
    ui.siteDescription->setText(tr("%1 at %2").arg(authenticator->realm(), url.host()));

    // Did the URL have information? Fill the UI.
    // This is only relevant if the URL-supplied credentials were wrong
    ui.userEdit->setText(url.userName());
    ui.passwordEdit->setText(url.password());

    if (authenticationDialog.exec() == QDialog::Accepted) {
        authenticator->setUser(ui.userEdit->text());
        authenticator->setPassword(ui.passwordEdit->text());
    }
}

En este ejemplo, mostramos un cuadro de diálogo en el que el usuario puede introducir un nombre de usuario y una contraseña, o bien cancelar la operación. Si se cancela, la solicitud falla.

Proyecto de ejemplo en @code.qt.io

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