QQmlNetworkAccessManagerFactory Class

詳細な説明

QMLエンジンは、すべてのネットワークアクセスにQNetworkAccessManager を使用します。ファクトリを実装することで、特殊なキャッシュ、プロキシ、およびクッキーのサポートを備えたカスタムQNetworkAccessManager インスタンスをQMLエンジンに提供することが可能です。

• QNetworkDiskCache は、QNetworkDiskCache との組み合わせでリクエストキャッシュとして使用できます。
• QNetworkProxy を使用することで、QNetworkAccessManager から送信されるトラフィックをプロキシ経由でトンネル化することができます。
• QNetworkCookieJar を追加することで、将来のリクエストのために Cookie を保存することができます。

ファクトリを実装するには、QQmlNetworkAccessManagerFactory をサブクラス化し、仮想メソッドcreate() を実装してから、QQmlEngine::setNetworkAccessManagerFactory() を使用して、関連する QML エンジンに割り当てます。たとえば、次のスニペットで作成されたQNetworkAccessManager オブジェクトは、リクエストをキャッシュします。

class CachingNetworkAccessManagerFactory : public QQmlNetworkAccessManagerFactory
{
public:

    inline QNetworkAccessManager *create(QObject *parent) override
    {
        QNetworkAccessManager *networkAccessManager = new QNetworkAccessManager(parent);
        QNetworkDiskCache *diskCache = new QNetworkDiskCache(parent);
        diskCache->setCacheDirectory("requestCache");
        networkAccessManager->setCache(diskCache);

        return networkAccessManager;
    }
};

その後、このファクトリを QML エンジンに渡すことで、カスタム動作を持つ `QNetworkAccessManager ` をインスタンス化できるようになります。

CachingNetworkAccessManagerFactory networkManagerFactory;
engine->setNetworkAccessManagerFactory(&networkManagerFactory);

QMLエンジンは、複数のスレッドからQNetworkAccessManager のインスタンスを作成する可能性があることに注意してください。このため、create()メソッドの実装はreentrant でなければなりません。さらに、create()から返されるオブジェクトのシグナルが、別のスレッドで作成される可能性のあるオブジェクトのスロットに接続されている場合は、開発者は注意が必要です：

• QMLエンジンは内部ですべてのリクエストを処理し、自身が生成したQNetworkReply オブジェクトをすべてクリーンアップします。別のスレッドでQNetworkAccessManager::finished()シグナルを受信した場合、そのオブジェクトがすでに削除されていると、受信者に有効な返信オブジェクトが提供されない可能性があります。
• QNetworkAccessManager::authenticationRequired() に渡される認証情報は即座に提供される必要があるため、このシグナルをQt::QueuedConnection として（あるいは別のスレッドからのデフォルトのQt::AutoConnection として）接続することはできません。

シグナルとスレッドに関する詳細については、「スレッドとQObject」および「スレッド間のシグナルとスロット」を参照してください。