QtTaskTree Namespace

유형 설명서

[alias] BarrierKickerGetter

` QStoredBarrier `을 인수로 받아 ` ExecutableItem`을 반환하는 함수, 즉 ` std::function<ExecutableItem(const QStoredBarrier &)>`에 대한 타입 별칭으로, ` When ` 생성자 내에서 사용됩니다.

enum class QtTaskTree::CallDoneFlag
flags QtTaskTree::CallDone

이 열거형은 ` onGroupDone()` 요소 또는 사용자 정의 태스크의 생성자에 대한 선택적 인자입니다. 이 인자는 그룹이나 태스크의 완료 핸들러가 언제 호출되어야 하는지 태스크 트리에 지시합니다.

CallDone 유형은 QFlags<CallDoneFlag>에 대한 typedef입니다. 이 유형은 CallDoneFlag 값들의 OR 조합을 저장합니다.

enum class QtTaskTree::DoneResult

이 열거형은 그룹이나 태스크의 완료 핸들러 함수에서 선택적으로 반환됩니다. 완료 핸들러가 아무런 값도 반환하지 않을 때, 즉 반환 유형이 ` void`인 경우, 최종 반환 값은 실행 중인 태스크 트리에서 자동으로 추론되어 상위 그룹에 보고됩니다.

완료 핸들러가 `DoneResult`를 반환하는 경우, 핸들러 내부에서 최종 반환 값을 조정할 수 있습니다.

그룹의 완료 핸들러에서 DoneResult가 반환되면, 그룹의 워크플로 정책은 무시됩니다.

이 열거형은 TaskInterface::done() 시그널 내부에서도 사용되며, 태스크가 성공으로 완료되었는지 오류로 완료되었는지를 나타냅니다.

enum class QtTaskTree::DoneWith

이 열거형은 그룹 또는 작업의 완료 핸들러에 대한 선택적 인자입니다. 이는 그룹이나 작업이 성공 또는 오류로 완료되었는지, 아니면 취소되었는지를 나타냅니다.

또한 ` QTaskTree::done()` 신호 내부의 인수로 사용되어, ` QTaskTree ` 실행의 최종 결과를 나타냅니다.

[alias] QtTaskTree::GroupItems

QList 의 타입 별칭 <GroupItem>.

[alias] QBarrierTask

레시피 내에서 사용할 QCustomTask<QBarrier>에 대한 타입 별칭입니다.

[alias] QNetworkReplyWrapperTask

레시피 내에서 사용할 QCustomTask<QNetworkReplyWrapper>에 대한 타입 별칭입니다.

[alias] QProcessTask

레시피 내에서 사용할 수 있도록 QProcessTaskDeleter 를 사용하여 QCustomTask<QProcess>에 대한 타입 별칭을 정의합니다.

[alias] QStoredBarrier

레시피 내에서 사용할 QtTaskTree::Storage<QStartedBarrier>에 대한 타입 별칭입니다.

[alias] QTaskTreeTask

레시피 내에서 사용할 QCustomTask<QTaskTree>에 대한 타입 별칭입니다.

[alias] QTcpSocketWrapperTask

레시피 내에서 사용할 QCustomTask<QTcpSocketWrapper>에 대한 타입 별칭입니다.

[alias] template <typename ResultType> QThreadFunctionTask

레시피 내에서 사용하기 위한, QCustomTask<QThreadFunction<ResultType>>에 대한 타입 별칭으로, 여기서 ResultType 은 스레드 함수의 반환 타입을 지정합니다.

[alias] QTimeoutTask

레시피 내에서 사용하기 위한 ` QCustomTask` <std::chrono::milliseconds> 의 타입 별칭입니다. ` std::chrono::milliseconds `는 타임아웃 기간을 설정하는 데 사용됩니다. 기본 타임아웃은 ` std::chrono::milliseconds::zero()`이며, 즉 `QTimeoutTask`는 제어권이 실행 중인 이벤트 루프로 돌아오자마자 종료됩니다.

사용 예:

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

timeoutTask()도 참조하십시오 .

enum class QtTaskTree::SetupResult

이 열거형은 그룹이나 태스크의 설정 핸들러 함수에서 선택적으로 반환됩니다. 이는 설정 핸들러의 실행이 완료된 후 실행 중인 태스크 트리가 어떻게 진행해야 하는지를 지시합니다.

[alias] QtTaskTree::TreeDoneHandler

std::function<void(const QTaskTree &, QtTaskTree::DoneWith)>에 대한 타입 별칭입니다.

TreeDoneHandler 는 태스크 트리 실행을 스케줄링하는 태스크 트리 러너 함수의 선택적 인자입니다. 이 함수는 태스크 트리 러너의 레시피가 실행을 완료했을 때 호출됩니다. QTaskTree 및 레시피의 결과에 대한 접근은 전달된 인자를 통해 이루어집니다.

태스크 트리 실행기는 std::function<void(const QTaskTree &)>, std::function<void(QtTaskTree::DoneWith)> 또는 std::function<void(void)> 와 같은 축약된 형식의 핸들러도 허용합니다.

[alias] QtTaskTree::TreeSetupHandler

std::function<void(QTaskTree &)>에 대한 타입 별칭입니다.

TreeSetupHandler 는 태스크 트리 실행을 스케줄링하는 태스크 트리 러너 함수의 선택적 인자입니다. 이 함수는 태스크 트리 러너가 레시피를 실행하려 할 때 호출됩니다. QTaskTree 에 대한 액세스는 전달된 인자를 통해 이루어집니다.

태스크 트리 실행기는 std::function<void(void)> 의 축약형인 핸들러도 허용합니다.

enum class QtTaskTree::WorkflowPolicy

이 열거형은 어떤 그룹의 자식 작업이 실행을 완료했을 때 Group 요소가 보일 수 있는 동작을 설명합니다. 또한 실행 중인 Group이 취소될 때도 사용됩니다.

자식 태스크의 결과로 인해 그룹이 중지될 때마다, 즉 StopOnError, StopOnSuccess 또는 StopOnSuccessOrError 정책이 적용된 경우, 그룹은 실행 중인 다른 자식 태스크(있는 경우 - 예를 들어 병렬 모드에서)를 취소하고, 아직 시작하지 않은 태스크(예를 들어 순차 모드에서, 실패한 태스크 뒤에 배치된 태스크)의 실행을 건너뜁니다. ParallelLimit 를 사용할 경우 자식 작업의 취소와 건너뛰기가 모두 발생할 수 있습니다.

아래 표는 다양한 워크플로 정책 간의 차이점을 요약한 것입니다:

그룹의 자식도 그룹인 경우, 자식 그룹은 자체 워크플로 정책에 따라 작업을 실행합니다. 상위 그룹이 상위 그룹의 워크플로 정책(즉, 상위 그룹에 StopOnError, StopOnSuccess 또는 StopOnSuccessOrError 정책이 사용된 경우)에 따라 실행 중인 하위 그룹을 중지하면, 하위 그룹의 결과는 위 표의 Result 열과 하위 그룹의 워크플로 정책 행에 따라 보고됩니다.