QtTaskTree Namespace

Typdokumentation

[alias] BarrierKickerGetter

Typalias für die Funktion, die ein ` QStoredBarrier ` entgegennimmt und ` ExecutableItem` zurückgibt, d. h. ` std::function<ExecutableItem(const QStoredBarrier &)>`, zur Verwendung innerhalb des Konstruktors von ` When `.

enum class QtTaskTree::CallDoneFlag
flags QtTaskTree::CallDone

Diese Enumeration ist ein optionales Argument für den Konstruktor des Elements „ onGroupDone()“ oder einer benutzerdefinierten Aufgabe. Sie gibt dem Aufgabenbaum vor, wann der „done“-Handler der Gruppe oder der Aufgabe aufgerufen werden soll.

Der Typ „CallDone“ ist ein „typedef“ für „QFlags<CallDoneFlag>“. Er speichert eine OR-Kombination von „CallDoneFlag“-Werten.

enum class QtTaskTree::DoneResult

Diese Enumeration wird optional von der „done“-Handler-Funktion der Gruppe oder der Aufgabe zurückgegeben. Wenn der „done“-Handler keinen Wert zurückgibt, d. h. sein Rückgabetyp „ void “ ist, wird sein endgültiger Rückgabewert automatisch vom laufenden Aufgabenbaum abgeleitet und an die übergeordnete Gruppe gemeldet.

Wenn der „Done“-Handler „DoneResult“ zurückgibt, können Sie den endgültigen Rückgabewert innerhalb des Handlers anpassen.

Wird „DoneResult“ von der „done“-Handler-Funktion der Gruppe zurückgegeben, wird die Workflow-Richtlinie der Gruppe ignoriert.

Diese Enumeration wird auch innerhalb des Signals `TaskInterface::done()` verwendet und gibt an, ob die Aufgabe erfolgreich oder mit einem Fehler abgeschlossen wurde.

enum class QtTaskTree::DoneWith

Diese Enumeration ist ein optionales Argument für den „done“-Handler der Gruppe oder Aufgabe. Sie gibt an, ob die Gruppe oder Aufgabe erfolgreich oder mit einem Fehler abgeschlossen wurde oder ob sie abgebrochen wurde.

Sie wird außerdem als Argument innerhalb des Signals „ QTaskTree::done()“ verwendet und gibt das Endergebnis der Ausführung von „ QTaskTree “ an.

[alias] QtTaskTree::GroupItems

Typalias für QList<GroupItem>.

[alias] QBarrierTask

Typalias für die „ QCustomTask “ <QBarrier>, zur Verwendung in Rezepten.

[alias] QNetworkReplyWrapperTask

Typalias für die „ QCustomTask “ <QNetworkReplyWrapper>, zur Verwendung in Rezepten.

[alias] QProcessTask

Typalias für den Typ „ QCustomTask “ <QProcess> unter Verwendung von QProcessTaskDeleter, zur Verwendung in Rezepten.

[alias] QStoredBarrier

Typalias für den Typ „ QtTaskTree::Storage “ <QStartedBarrier>, zur Verwendung in Rezepten.

[alias] QTaskTreeTask

Typalias für die Klasse „ QCustomTask “ <QTaskTree>, zur Verwendung in Rezepten.

[alias] QTcpSocketWrapperTask

Typalias für das „ QCustomTask “ <QTcpSocketWrapper>, zur Verwendung in Rezepten.

[alias] template <typename ResultType> QThreadFunctionTask

Typalias für „ QCustomTask<QThreadFunction<ResultType>>“, wobei „ ResultType “ den Rückgabetyp der Thread-Funktion angibt, der innerhalb von Rezepten verwendet werden soll.

[alias] QTimeoutTask

Typalias für die Klasse „ QCustomTask “ <std::chrono::milliseconds>, zur Verwendung in Rezepten. Mit dem Parameter „ std::chrono::milliseconds “ wird die Zeitüberschreitungsdauer festgelegt. Die Standardzeitüberschreitung lautet „ std::chrono::milliseconds::zero() “, d. h., die „QTimeoutTask“ wird beendet, sobald die Steuerung zur laufenden Ereignisschleife zurückkehrt.

Anwendungsbeispiel:

using namespace std::chrono;
using namespace std::chrono_literals;

const auto onSetup = [](milliseconds &timeout) { timeout = 1000ms; }
const auto onDone = [] { qDebug() << "Timed out."; }

const Group root {
    QTimeoutTask(onSetup, onDone)
};

Siehe auch „ timeoutTask()“.

enum class QtTaskTree::SetupResult

Diese Enumeration wird optional von der Setup-Handler-Funktion der Gruppe oder der Aufgabe zurückgegeben. Sie gibt dem laufenden Aufgabenbaum vor, wie nach Abschluss der Ausführung des Setup-Handlers weiter verfahren werden soll.

[alias] QtTaskTree::TreeDoneHandler

Typalias für std::function<void(const QTaskTree &, QtTaskTree::DoneWith)>.

TreeDoneHandler ist ein optionales Argument der Funktionen von Task-Tree-Runner, die die Ausführung des Task-Trees planen. Die Funktion wird aufgerufen, wenn das Rezept des Task-Tree-Runners die Ausführung abgeschlossen hat. Der Zugriff auf QTaskTree und das Ergebnis des Rezepts erfolgt über die übergebenen Argumente.

Die Task-Tree-Runner akzeptieren auch Handler in einer verkürzten Form: „ std::function<void(const QTaskTree &)> “, „ std::function<void(QtTaskTree::DoneWith)> “ oder „ std::function<void(void)> “.

[alias] QtTaskTree::TreeSetupHandler

Typalias für std::function<void(QTaskTree &)>.

TreeSetupHandler ist ein optionales Argument der Funktionen von Task-Tree-Runner, die die Ausführung des Task-Trees planen. Die Funktion wird aufgerufen, wenn der Task-Tree-Runner im Begriff ist, sein Rezept auszuführen. Der Zugriff auf QTaskTree erfolgt über das übergebene Argument.

Die Task-Tree-Runner akzeptieren auch Handler in einer verkürzten Form von ` std::function<void(void)>`.

enum class QtTaskTree::WorkflowPolicy

Diese Enumeration beschreibt das mögliche Verhalten des „Group“-Elements, wenn eine untergeordnete Aufgabe einer beliebigen Gruppe ihre Ausführung beendet. Sie wird auch verwendet, wenn die laufende „Group“ abgebrochen wird.

Immer wenn das Ergebnis einer untergeordneten Aufgabe dazu führt, dass die Gruppe angehalten wird, d. h. bei den Richtlinien „StopOnError“, „StopOnSuccess“ oder „StopOnSuccessOrError“, bricht die Gruppe die anderen laufenden untergeordneten Aufgaben ab (sofern vorhanden – beispielsweise im Parallelmodus) und überspringt die Ausführung von Aufgaben, die sie noch nicht gestartet hat (beispielsweise im sequenziellen Modus – jene, die nach der fehlgeschlagenen Aufgabe platziert sind). Sowohl das Abbrechen als auch das Überspringen von untergeordneten Aufgaben kann auftreten, wenn „ ParallelLimit “ verwendet wird.

Die folgende Tabelle fasst die Unterschiede zwischen den verschiedenen Workflow-Richtlinien zusammen:

Wenn ein untergeordnetes Element einer Gruppe ebenfalls eine Gruppe ist, führt die untergeordnete Gruppe ihre Aufgaben gemäß ihrer eigenen Workflow-Richtlinie aus. Wenn eine übergeordnete Gruppe die laufende untergeordnete Gruppe aufgrund ihrer eigenen Workflow-Richtlinie stoppt – das heißt, wenn für die übergeordnete Gruppe die Richtlinie „StopOnError“, „StopOnSuccess“ oder „StopOnSuccessOrError“ verwendet wurde –, wird das Ergebnis der untergeordneten Gruppe gemäß der Spalte „Ergebnis“ und der Zeile zur Workflow-Richtlinie der untergeordneten Gruppe in der obigen Tabelle gemeldet.