QtTaskTree Namespace

유형 문서

[alias] BarrierKickerGetter

QStoredBarrier 을 받아 ExecutableItem 을 반환하는 함수의 별칭, 즉 std::function<ExecutableItem(const QStoredBarrier &)> 을 When 생성자 안에서 사용할 별칭을 지정합니다.

열거형 클래스 QtTaskTree::CallDoneFlag
플래그 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

레시피 내에서 사용할 QCustomTask<QProcess>의 별칭을 QProcessTaskDeleter 을 사용하여 입력합니다.

[alias] QStoredBarrier

레시피 내에서 사용할 QtTaskTree::Storage<QStartedBarrier>의 별칭을 입력합니다.

[alias] QTaskTreeTask

레시피 내에서 사용할 QCustomTask<QTaskTree>의 별칭을 입력합니다.

[alias] QTcpSocketWrapperTask

레시피 내에서 사용할 QCustomTask<QTcpSocketWrapper>의 별칭을 입력합니다.

[alias] template <typename ResultType> QThreadFunctionTask

레시피 내에서 사용할 QCustomTask<QThreadFunction<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

이 열거형은 그룹의 하위 작업이 실행을 완료할 때 그룹 요소의 가능한 동작을 설명합니다. 실행 중인 그룹이 취소될 때에도 사용됩니다.

하위 작업의 결과로 인해 그룹이 중지되는 경우, 즉 StopOnError, StopOnSuccess 또는 StopOnSuccessOrError 정책이 있는 경우 그룹은 실행 중인 다른 하위 작업이 있는 경우(예: 병렬 모드에서) 취소하고 아직 시작하지 않은 작업(예: 순차 모드에서 실패한 작업 뒤에 배치된 작업)을 실행을 건너뜁니다. ParallelLimit 을 사용하면 하위 작업 취소와 건너뛰기가 모두 가능합니다.

아래 표에는 다양한 워크플로 정책 간의 차이점이 요약되어 있습니다:

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