QtTaskTree Namespace

Documentación de la clase

[alias] BarrierKickerGetter

Tipo de alias para la función que toma un QStoredBarrier y devuelve ExecutableItem, es decir std::function<ExecutableItem(const QStoredBarrier &)>, para ser usado dentro del constructor When.

enum class QtTaskTree::CallDoneFlag
flags QtTaskTree::CallDone

Esta enum es un argumento opcional para el elemento onGroupDone() o el constructor de la tarea personalizada. Indica al árbol de tareas cuándo debe invocarse el manejador de grupo o tarea.

El tipo CallDone es un typedef para QFlags<CallDoneFlag>. Almacena una combinación OR de valores CallDoneFlag.

enum class QtTaskTree::DoneResult

Este enum se devuelve opcionalmente desde la función del gestor de tareas o grupos. Cuando el gestor realizado no devuelve ningún valor, es decir, su tipo de retorno es void, su valor de retorno final es deducido automáticamente por el árbol de tareas en ejecución e informado a su grupo padre.

Cuando el gestor final devuelve el DoneResult, puede modificar el valor de retorno final dentro del gestor.

Cuando el DoneResult es devuelto por el manejador hecho del grupo, la política de flujo de trabajo del grupo es ignorada.

Este enum también se utiliza dentro de la señal TaskInterface::done() e indica si la tarea finalizó con éxito o con un error.

enum class QtTaskTree::DoneWith

Este enum es un argumento opcional para el manejador de grupo o tarea terminada. Indica si el grupo o tarea ha finalizado con éxito o con un error, o si se ha cancelado.

También se utiliza como argumento dentro de la señal QTaskTree::done(), indicando el resultado final de la ejecución de QTaskTree.

[alias] QtTaskTree::GroupItems

Escriba el alias para QList<GroupItem>.

[alias] QBarrierTask

Tipo de alias para el QCustomTask<QBarrier>, que se utilizará dentro de las recetas.

[alias] QNetworkReplyWrapperTask

Tipo de alias para el QCustomTask<QNetworkReplyWrapper>, que se utilizará dentro de las recetas.

[alias] QProcessTask

Escriba un alias para el QCustomTask<QProcess>, utilizando QProcessTaskDeleter, que se utilizará dentro de las recetas.

[alias] QStoredBarrier

Tipo de alias para el QtTaskTree::Storage<QStartedBarrier>, que se utilizará dentro de las recetas.

[alias] QTaskTreeTask

Tipo de alias para el QCustomTask<QTaskTree>, que se utilizará dentro de las recetas.

[alias] QTcpSocketWrapperTask

Tipo de alias para el QCustomTask<QTcpSocketWrapper>, que se utilizará dentro de las recetas.

[alias] template <typename ResultType> QThreadFunctionTask

Alias de tipo para el QCustomTask<QThreadFunction<ResultType>>, para ser utilizado dentro de recetas.

[alias] QTimeoutTask

Tipo de alias para el QCustomTask<std::chrono::milliseconds>, que se utilizará dentro de las recetas. El std::chrono::milliseconds se utiliza para establecer la duración del tiempo de espera. El tiempo de espera por defecto es std::chrono::milliseconds::zero(), es decir, la QTimeoutTask termina tan pronto como el control vuelve al bucle de eventos en ejecución.

Ejemplo de uso:

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

Ver también timeoutTask().

enum class QtTaskTree::SetupResult

Este enum se devuelve opcionalmente desde la función del manejador de configuración del grupo o tarea. Indica al árbol de tareas en ejecución cómo proceder una vez finalizada la ejecución del gestor de configuración.

[alias] QtTaskTree::TreeDoneHandler

Alias de tipo para std::function<void(const QTaskTree &, QtTaskTree::DoneWith)>.

TreeDoneHandler es un argumento opcional de las funciones de los ejecutores del árbol de tareas que programan la ejecución del árbol de tareas. La función se llama cuando la receta del ejecutor del árbol de tareas finaliza la ejecución. El acceso a QTaskTree y al resultado de la receta se realiza a través de los argumentos pasados.

Los ejecutores del árbol de tareas también aceptan manejadores en una forma abreviada de std::function<void(const QTaskTree &)>, std::function<void(QtTaskTree::DoneWith)>, o std::function<void(void)>.

[alias] QtTaskTree::TreeSetupHandler

Alias de tipo para std::function<void(QTaskTree &)>.

TreeSetupHandler es un argumento opcional de las funciones de los ejecutores del árbol de tareas que programan la ejecución del árbol de tareas. Se llama a la función cuando el ejecutor del árbol de tareas está a punto de ejecutar su receta. El acceso a QTaskTree se realiza a través del argumento pasado.

Los ejecutores del árbol de tareas también aceptan manejadores en una forma abreviada de std::function<void(void)>.

enum class QtTaskTree::WorkflowPolicy

Este enum describe el posible comportamiento del elemento Grupo cuando la tarea hija de cualquier grupo finaliza su ejecución. También se utiliza cuando se cancela el Grupo en ejecución.

Cuando el resultado de una tarea secundaria hace que el grupo se detenga, es decir, en el caso de las políticas StopOnError, StopOnSuccess o StopOnSuccessOrError, el grupo cancela las demás tareas secundarias en ejecución (si las hay, por ejemplo, en el modo paralelo) y omite la ejecución de las tareas que aún no ha iniciado (por ejemplo, en el modo secuencial, las que se colocan después de la tarea que ha fallado). Tanto la cancelación como la omisión de tareas secundarias pueden ocurrir cuando se utiliza ParallelLimit.

La siguiente tabla resume las diferencias entre varias políticas de flujo de trabajo:

Si un grupo hijo de un grupo es también un grupo, el grupo hijo ejecuta sus tareas según su propia política de flujo de trabajo. Cuando un grupo padre detiene la ejecución del grupo hijo debido a la política de flujo de trabajo del grupo padre, es decir, cuando se utilizó la política StopOnError, StopOnSuccess o StopOnSuccessOrError para el padre, el resultado del grupo hijo se informa según la columna Resultado y la fila de política de flujo de trabajo del grupo hijo en la tabla anterior.