En esta página

QQmlNetworkAccessManagerFactory Class

La clase `QQmlNetworkAccessManagerFactory` crea instancias de ` QNetworkAccessManager ` para un motor QML. Más información...

Encabezado: #include <QQmlNetworkAccessManagerFactory>
CMake: find_package(Qt6 REQUIRED COMPONENTS Qml)
target_link_libraries(mytarget PRIVATE Qt6::Qml)
qmake: QT += qml

Funciones públicas

virtual ~QQmlNetworkAccessManagerFactory()
virtual QNetworkAccessManager *create(QObject *parent) = 0

Descripción detallada

Un motor QML utiliza QNetworkAccessManager para todo el acceso a la red. Al implementar una fábrica, es posible proporcionar al motor QML instancias personalizadas de QNetworkAccessManager con soporte especializado para el almacenamiento en caché, los proxies y las cookies.

Para implementar una fábrica, crea una subclase de `QQmlNetworkAccessManagerFactory` e implementa el método virtual ` create()`, y a continuación asígnala al motor QML correspondiente mediante ` QQmlEngine::setNetworkAccessManagerFactory()`. Por ejemplo, los objetos ` QNetworkAccessManager ` creados por el siguiente fragmento de código almacenarán en caché las solicitudes.

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

A continuación, la fábrica se puede pasar al motor QML para que este pueda instanciar QNetworkAccessManager con el comportamiento personalizado.

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

Tenga en cuenta que el motor QML puede crear instancias de ` QNetworkAccessManager ` desde varios hilos. Por este motivo, la implementación del método ` create()` debe ser ` reentrant`. Además, el desarrollador debe tener cuidado si las señales del objeto que se va a devolver desde ` create()` están conectadas a las ranuras de un objeto que pueda crearse en un hilo diferente:

Para obtener más información sobre señales y subprocesos, consulte «Subprocesos y QObjects » y «Señales y ranuras entre subprocesos».

Véase también QNetworkDiskCache.

Documentación de funciones miembro

[virtual noexcept] QQmlNetworkAccessManagerFactory::~QQmlNetworkAccessManagerFactory()

Destruye el objeto de fábrica. La implementación predeterminada no hace nada.

[pure virtual] QNetworkAccessManager *QQmlNetworkAccessManagerFactory::create(QObject *parent)

Crea y devuelve un gestor de acceso a la red con el ` parent` especificado. Este método debe devolver una nueva instancia de ` QNetworkAccessManager ` cada vez que se invoque.

Nota: este método puede ser invocado por varios subprocesos, por lo que debe asegurarse de que su implementación sea reentrante.

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