QtTaskTree::Storage Class

Description détaillée

Le modèle de classe Storage est chargé de créer et de détruire dynamiquement des objets du type personnalisé « StorageStruct ». La création et la destruction sont gérées par l’arborescence des tâches en cours d’exécution. Si un objet Storage est placé à l’intérieur d’un élément « Group », l’arborescence des tâches en cours d’exécution crée l’objet « StorageStruct » au démarrage du groupe et avant l’appel du gestionnaire de configuration du groupe. Par la suite, chaque fois qu’un gestionnaire au sein de ce groupe est appelé, l’arborescence des tâches active l’instance précédemment créée de l’objet StorageStruct. Cela inclut tous les gestionnaires de configuration et de fin de tâche des tâches et des groupes au sein du groupe où l’objet Storage a été placé, y compris dans les groupes imbriqués. Lorsqu’une copie de l’objet `Storage` est transmise au gestionnaire via la capture lambda, ce dernier peut accéder à l’instance activée par l’arborescence de tâches en cours d’exécution via les méthodes ` Storage::operator->()`, ` Storage::operator*()` ou ` activeStorage()`. Si deux gestionnaires capturent le même objet `Storage`, l’un d’eux peut y stocker des données personnalisées, et l’autre peut les lire par la suite. Une fois le groupe terminé, l’instance de l’objet ` StorageStruct ` créée précédemment est détruite après l’appel du gestionnaire `done` du groupe.

Exemple d’échange de données entre tâches :

const Storage<QString> storage;

const auto onFirstDone = [storage](const FirstWorker &task) {
    // Assings QString, taken from the first task result, to the active QString instance
    // of the Storage object.
    *storage = task.getResultAsString();
};

const auto onSecondSetup = [storage](SecondWorker &task) {
    // Reads QString from the active QString instance of the Storage object and use it to
    // configure the second task before start.
    task.configureWithString(*storage);
};

const Group root {
    // The running task tree creates QString instance when root in entered
    storage,
    // The done handler of the first task stores the QString in the storage
    FirstWorkerTask(..., onFirstDone),
    // The setup handler of the second task reads the QString from the storage
    SecondWorkerTask(onSecondSetup, ...)
};

Comme le groupe racine exécute ses tâches de manière séquentielle, le gestionnaire ` onFirstDone ` est toujours appelé avant le gestionnaire ` onSecondSetup `. Cela signifie que les données de ` QString `, lues à partir de ` storage ` dans le corps du gestionnaire ` onSecondSetup `, ont déjà été définies par le gestionnaire ` onFirstDone `. Vous pouvez toujours vous y fier en mode d’exécution ` sequential `.

Les composants internes de Storage sont partagés entre toutes ses copies. C’est pourquoi les copies de l’objet Storage à l’intérieur des captures lambda des gestionnaires font toujours référence à la même instance de Storage. Vous pouvez placer plusieurs objets Storage à l’intérieur d’un élément Group, à condition qu’ils ne contiennent pas de copies du même objet Storage. Sinon, une assertion est déclenchée lors de l’exécution, accompagnée d’un message d’erreur. Cependant, vous pouvez placer des copies d’un même objet `Storage` dans différents éléments ` Group ` d’une même recette. Dans ce cas, l’arborescence de tâches en cours d’exécution créera plusieurs instances des objets ` StorageStruct ` (une pour chaque copie) et un masquage de stockage aura lieu. Le masquage de stockage fonctionne de manière similaire au masquage de variables en C++ à l’intérieur des blocs de code imbriqués :

Storage<QString> storage;

const Group root {
    storage,                            // Top copy, 1st instance of StorageStruct
    onGroupSetup([storage] { ... }),    // Top copy is active
    Group {
        storage,                        // Nested copy, 2nd instance of StorageStruct,
                                        // shadows Top copy
        onGroupSetup([storage] { ... }) // Nested copy is active
    },
    Group {
        onGroupSetup([storage] { ... }) // Top copy is active
    }
};

Les objets `Storage` peuvent également servir à transmettre les données initiales à l’arborescence de tâches en cours d’exécution, ainsi qu’à extraire les données finales de l’arborescence avant qu’elle ne s’achève. Pour ce faire, utilisez respectivement ` onStorageSetup()` ou ` onStorageDone()`.