QtTaskTree::Storage Class

Detaillierte Beschreibung

Die Vorlage der Klasse Storage ist für die dynamische Erstellung und Zerstörung von Objekten des benutzerdefinierten Typs StorageStruct verantwortlich. Die Erstellung und Zerstörung wird durch den laufenden Taskbaum verwaltet. Wenn ein Storage-Objekt innerhalb eines Group -Elements platziert wird, erstellt der laufende Aufgabenbaum das StorageStruct -Objekt, wenn die Gruppe gestartet wird und bevor der Setup-Handler der Gruppe aufgerufen wird. Später, wenn ein Handler innerhalb dieser Gruppe aufgerufen wird, aktiviert der Aufgabenbaum die zuvor erstellte Instanz des StorageStruct Objekts. Dies schließt alle Handler für das Einrichten und Erledigen von Aufgaben und Gruppen innerhalb der Gruppe ein, in der das Speicherobjekt platziert wurde, auch innerhalb der verschachtelten Gruppen. Wenn eine Kopie des Storage-Objekts über das Lambda-Capture an den Handler übergeben wird, kann der Handler über die Methoden Storage::operator->(), Storage::operator*() oder activeStorage() auf die Instanz zugreifen, die durch den laufenden Aufgabenbaum aktiviert wurde. Wenn zwei Handler dasselbe Storage-Objekt erfassen, kann einer von ihnen dort benutzerdefinierte Daten speichern, und der andere kann sie anschließend lesen. Wenn die Gruppe beendet ist, wird die zuvor erstellte Instanz des StorageStruct Objekts zerstört, nachdem der done Handler der Gruppe aufgerufen wurde.

Ein Beispiel für den Datenaustausch zwischen Aufgaben:

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, ...)
};

Da die Wurzelgruppe ihre Aufgaben sequentiell ausführt, wird der onFirstDone -Handler immer vor dem onSecondSetup -Handler aufgerufen. Das bedeutet, dass die Daten von QString, die vom storage innerhalb des Body des onSecondSetup Handlers gelesen wurden, bereits vom onFirstDone Handler gesetzt wurden. Sie können sich im sequential Ausführungsmodus immer darauf verlassen.

Die Interna von Storage werden von allen seinen Kopien gemeinsam genutzt. Deshalb beziehen sich die Kopien des Storage-Objekts innerhalb der Lambda-Captures der Handler immer noch auf dieselbe Storage-Instanz. Sie können mehrere Storage-Objekte in einem Group Element platzieren, vorausgesetzt, sie enthalten keine Kopien desselben Storage-Objekts. Andernfalls wird zur Laufzeit ein Assert ausgelöst, das eine Fehlermeldung enthält. Sie können jedoch Kopien desselben Speicherobjekts in verschiedenen Group Elementen desselben Rezepts platzieren. In diesem Fall erzeugt der laufende Aufgabenbaum mehrere Instanzen der StorageStruct Objekte (eine für jede Kopie) und es findet eine Speicherschattierung statt. Das Storage Shadowing funktioniert ähnlich wie das C++-Variablen-Shadowing innerhalb der verschachtelten Codeblöcke:

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

Die Storage-Objekte können auch für die Übergabe der Anfangsdaten an den ausgeführten Task-Baum und für das Auslesen der endgültigen Daten aus dem Task-Baum vor dessen Beendigung verwendet werden. Verwenden Sie dazu onStorageSetup() bzw. onStorageDone().