QtTaskTree::Storage Class

Ausführliche Beschreibung

Die Klassenvorlage „Storage“ ist für die dynamische Erstellung und Löschung von Objekten des benutzerdefinierten Typs „ StorageStruct “ zuständig. Die Erstellung und Löschung werden vom laufenden Aufgabenbaum verwaltet. Befindet sich ein „Storage“-Objekt in einem „ Group “-Element, erstellt der laufende Aufgabenbaum das „ StorageStruct “-Objekt beim Start der Gruppe und bevor der Einrichtungshandler der Gruppe aufgerufen wird. Später, wann immer ein Handler innerhalb dieser Gruppe aufgerufen wird, aktiviert der Aufgabenbaum die zuvor erstellte Instanz des Objekts „ StorageStruct “. Dies umfasst alle Setup- und Done-Handler von Aufgaben und Gruppen innerhalb der Gruppe, in der das „Storage“-Objekt platziert wurde, auch innerhalb der verschachtelten Gruppen. Wenn eine Kopie des „Storage“-Objekts über die Lambda-Erfassung an den Handler übergeben wird, kann der Handler über die Methoden „ Storage::operator->()“, „ Storage::operator*()“ oder „ activeStorage()“ auf die vom laufenden Aufgabenbaum aktivierte Instanz zugreifen. Wenn zwei Handler dasselbe „Storage“-Objekt erfassen, kann einer von ihnen dort benutzerdefinierte Daten speichern und der andere diese 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 Stammgruppe ihre Aufgaben nacheinander ausführt, wird der ` onFirstDone `-Handler immer vor dem ` onSecondSetup `-Handler aufgerufen. Das bedeutet, dass die Daten in ` QString `, die im Körper des ` onSecondSetup `-Handlers aus ` storage ` gelesen werden, bereits durch den ` onFirstDone `-Handler gesetzt wurden. Darauf können Sie sich im Ausführungsmodus „ sequential “ stets verlassen.

Die internen Daten des „Storage“-Objekts werden von allen seinen Kopien gemeinsam genutzt. Aus diesem Grund verweisen die Kopien des „Storage“-Objekts innerhalb der Lambda-Captures der Handler weiterhin auf dieselbe „Storage“-Instanz. Sie können mehrere „Storage“-Objekte in ein „ Group “-Element einfügen, sofern diese keine Kopien desselben „Storage“-Objekts enthalten. Andernfalls wird zur Laufzeit ein Assert ausgelöst, das eine Fehlermeldung enthält. Sie können jedoch Kopien desselben „Storage“-Objekts in verschiedenen „ Group “-Elementen desselben Rezepts platzieren. In diesem Fall erstellt der ausgeführte Aufgabenbaum mehrere Instanzen der „ StorageStruct “-Objekte (eine für jede Kopie), und es findet ein Speicher-Shadowing statt. Das Speicher-Shadowing funktioniert ähnlich wie das Variablen-Shadowing in C++ innerhalb verschachtelter 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 dazu verwendet werden, die Ausgangsdaten an den ausgeführten Aufgabenbaum zu übergeben und die Enddaten aus dem Aufgabenbaum auszulesen, bevor dieser beendet ist. Verwenden Sie dazu jeweils „ onStorageSetup()“ oder „ onStorageDone()“.