HTTPクライアント

単純な HTTP クライアントをデモします。

この例では、単純な HTTP クライアントがリモート・ホストからファイルを取得する方法を示します。

ユーザーはメイン・ウィンドウにURL、ファイル名、ダウンロード場所を入力します。QNetworkAccessManagerクラスは、この情報を使用してファイルをダウンロードします。

この例の主な作業はHttpWindowクラスで行われます。そのため、HttpWindowに焦点を当てます。

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

Qt 6.11 以降、QNetworkRequest の TCP キープアライブパラメータを明示的に指定することができるようになりました。上記のスニペットでは、QNetworkAccessManager で使用されているデフォルトをオーバーライドして、より積極的な戦略に従っています。これは、例えば、Linux上でネットワークの変更によってネットワークがハングした場合に、それを早期に検出するのに便利である。この例では、30秒間操作がないと、接続が切断される。

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

QNetworkAccessManager を使用して、url で指定されたリソースのダウンロードを開始する。や使用されている関数QNetworkAccessManager::get() に馴染みがない場合、または単にもっと詳しく調べたい場合は、この関数のドキュメントやQNetworkReply と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

上記では、リプライのシグナルのいくつかをクラスのスロットに接続しています。これらのスロットは、データの受信とダウンロードの最終処理/エラーの処理の両方を行います。

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

受信データの処理に関しては、どのような潜在的な入力の最大ダウンロード・サイズもわからないし、サンプル・プログラムを実行する可能性のあるコンピューターのメモリーを使い果たしたくないので、QNetworkReply::finished （）ではなく、QNetworkReply::readyRead （）で受信データを処理する。

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());
}

そして、到着したデータをファイルに書き込む。不便ですが、アプリケーションのピーク時のメモリー消費は少なくなります！

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

QNetworkReply::sslErrors() シグナルを使えば、安全なウェブサイト（HTTPSなど）に接続する際にTLSハンドシェイク中に発生する可能性のあるエラーも処理できる。

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();
    }
}

この例では、ユーザーにダイアログを表示して、エラーを無視するかどうかを選択できるようにしています。

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;
}

エラーが発生すると、QNetworkReply がQNetworkReply::errorOccurred() シグナルを発し、続いてQNetworkReply::finished() シグナルを発する。この例では、後者にのみ接続する。それぞれのスロットで潜在的なエラーが発生した場合は、書き込み先のファイルを削除して処理し、ステータス・ラベルでエラーを表示します。

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

HTTP認証を使用するWebサイトに接続する場合、事前に使用すべき認証情報を与えなかったと仮定すると、Webサイトが認証情報を要求したときに、足りない認証情報を処理することができる。QNetworkAccessManager では、シグナルQNetworkAccessManager::authenticationRequired() に接続されたスロットでこれを行う。この接続はコンストラクタで一度だけ行います。

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());
    }
}

この例では、ユーザがユーザ名とパスワードを入力するか、キャンセルするかのダイアログを表示します。キャンセルすると、リクエストは失敗する。

プロジェクト例 @ 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.