QQmlNetworkAccessManagerFactory Class

Description détaillée

Un moteur QML utilise QNetworkAccessManager pour tous ses accès réseau. En implémentant une fabrique, il est possible de fournir au moteur QML des instances personnalisées d’ QNetworkAccessManager avec une prise en charge spécialisée de la mise en cache, des proxys et des cookies.

• L'QNetworkDiskCache peut être utilisé comme cache de requêtes avec QNetworkDiskCache.
• Grâce à QNetworkProxy, le trafic envoyé par l’ QNetworkAccessManager peut être acheminé via un proxy.
• Les cookies peuvent être enregistrés pour de futures requêtes en ajoutant un ` QNetworkCookieJar`.

Pour implémenter une fabrique, sous-classez QQmlNetworkAccessManagerFactory et implémentez la méthode virtuelle create(), puis attribuez-la au moteur QML concerné à l’aide de QQmlEngine::setNetworkAccessManagerFactory(). Par exemple, les objets QNetworkAccessManager créés par l’extrait de code suivant mettront les requêtes en cache.

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

La fabrique peut ensuite être transmise au moteur QML afin qu’il puisse instancier l’ QNetworkAccessManager avec le comportement personnalisé.

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

Notez que le moteur QML peut créer des instances d’ QNetworkAccessManager à partir de plusieurs threads. De ce fait, l’implémentation de la méthode create() doit être reentrant. De plus, le développeur doit faire preuve de prudence si les signaux de l’objet renvoyé par create() sont connectés aux slots d’un objet susceptible d’être créé dans un autre thread :

• Le moteur QML gère en interne toutes les requêtes et nettoie tous les objets ` QNetworkReply ` qu’il crée. La réception du signal ` QNetworkAccessManager::finished()` dans un autre thread peut ne pas fournir au destinataire un objet de réponse valide si celui-ci a déjà été supprimé.
• Les informations d’authentification fournies à ` QNetworkAccessManager::authenticationRequired()` doivent être transmises immédiatement ; ce signal ne peut donc pas être connecté en tant que ` Qt::QueuedConnection ` (ni en tant que ` Qt::AutoConnection ` par défaut depuis un autre thread).

Pour plus d’informations sur les signaux et les threads, consultez les sections « Threads et QObjects » et « Signaux et slots entre threads ».