Package io.temporal.client

Class WorkflowOptions.Builder

  • Enclosing class:
    WorkflowOptions
    public static final class WorkflowOptions.Builder
extends java.lang.Object

    • Method Detail

      • setWorkflowId

        public WorkflowOptions.Builder setWorkflowId​(java.lang.String workflowId)
        Workflow id to use when starting. If not specified a UUID is generated. Note that it is dangerous as in case of client side retries no deduplication will happen based on the generated id. So prefer assigning business meaningful ids if possible.

      • setWorkflowIdReusePolicy

        public WorkflowOptions.Builder setWorkflowIdReusePolicy​(io.temporal.api.enums.v1.WorkflowIdReusePolicy workflowIdReusePolicy)
        Specifies server behavior if a completed workflow with the same id exists. Note that under no conditions Temporal allows two workflows with the same namespace and workflow id run simultaneously.

        Default value if not set: AllowDuplicate

        • AllowDuplicate allows a new run regardless of the previous run's final status. The previous run still must be closed or the new run will be rejected.
        • AllowDuplicateFailedOnly allows a new run if the previous run failed, was canceled, or terminated.
        • RejectDuplicate never allows a new run, regardless of the previous run's final status.
        • TerminateIfRunning is the same as AllowDuplicate, but if there exists a not-closed run in progress, it will be terminated.

      • setWorkflowRunTimeout

        public WorkflowOptions.Builder setWorkflowRunTimeout​(java.time.Duration workflowRunTimeout)
        The time after which a workflow run is automatically terminated by Temporal service with WORKFLOW_EXECUTION_TIMED_OUT status.

        When a workflow reaches Workflow Run Timeout, it can't make any progress after that. Do not rely on this timeout in workflow implementation or business logic. This timeout is not designed to be handled in workflow code to perform any logic in case of timeout. Consider using workflow timers instead.

        If you catch yourself setting this timeout to very small values, you're likely using it wrong.

        Example: If Workflow Run Timeout is 30 seconds and the network was unavailable for 1 minute, workflows that were scheduled before the network blip will never have a chance to make progress or react, and will be terminated.
        A timer that is scheduled in the workflow code using Workflow.newTimer(Duration) will handle this situation gracefully. A workflow with such a timer will start after the network blip. If it started before the network blip and the timer fires during the network blip, it will get delivered after connectivity is restored and the workflow will be able to resume.

      • setWorkflowExecutionTimeout

        public WorkflowOptions.Builder setWorkflowExecutionTimeout​(java.time.Duration workflowExecutionTimeout)
        The time after which workflow execution (which includes run retries and continue as new) is automatically terminated by Temporal service with WORKFLOW_EXECUTION_TIMED_OUT status.

        When a workflow reaches Workflow Execution Timeout, it can't make any progress after that. Do not rely on this timeout in workflow implementation or business logic. This timeout is not designed to be handled in workflow code to perform any logic in case of timeout. Consider using workflow timers instead.

        If you catch yourself setting this timeout to very small values, you're likely using it wrong.

        Example: If Workflow Execution Timeout is 30 seconds and the network was unavailable for 1 minute, workflows that were scheduled before the network blip will never have a chance to make progress or react, and will be terminated.
        A timer that is scheduled in the workflow code using Workflow.newTimer(Duration) will handle this situation gracefully. A workflow with such a timer will start after the network blip. If it started before the network blip and the timer fires during the network blip, it will get delivered after connectivity is restored and the workflow will be able to resume.

      • setWorkflowTaskTimeout

        public WorkflowOptions.Builder setWorkflowTaskTimeout​(java.time.Duration workflowTaskTimeout)
        Maximum execution time of a single Workflow Task. In the majority of cases there is no need to change this timeout. Note that this timeout is not related to the overall Workflow duration in any way. It defines for how long the Workflow can get blocked in the case of a Workflow Worker crash.

        Default is 10 seconds. Maximum value allowed by the Temporal Server is 1 minute.

      • setTaskQueue

        public WorkflowOptions.Builder setTaskQueue​(java.lang.String taskQueue)
        Task queue to use for workflow tasks. It should match a task queue specified when creating a Worker that hosts the workflow code.

      • setMemo

        public WorkflowOptions.Builder setMemo​(java.util.Map<java.lang.String,​java.lang.Object> memo)
        Specifies additional non-indexed information in result of list workflow. The type of value can be any object that are serializable by DataConverter

      • setSearchAttributes

        @Deprecated
public WorkflowOptions.Builder setSearchAttributes​(java.util.Map<java.lang.String,​?> searchAttributes)
        Deprecated.
        use setTypedSearchAttributes(io.temporal.common.SearchAttributes) instead.
        Specifies Search Attributes map searchAttributes that will be attached to the Workflow. Search Attributes are additional indexed information attributed to workflow and used for search and visibility.

        The search attributes can be used in query of List/Scan/Count workflow APIs. The key and its value type must be registered on Temporal server side.

        Supported Java types of the value:

        • String
        • Long, Integer, Short, Byte
        • Boolean
        • Double
        • OffsetDateTime
        • Collection of the types above

      • setTypedSearchAttributes

        public WorkflowOptions.Builder setTypedSearchAttributes​(SearchAttributes typedSearchAttributes)
        Specifies Search Attributes that will be attached to the Workflow. Search Attributes are additional indexed information attributed to workflow and used for search and visibility.

        The search attributes can be used in query of List/Scan/Count workflow APIs. The key and its value type must be registered on Temporal server side.

      • setDisableEagerExecution

        public WorkflowOptions.Builder setDisableEagerExecution​(boolean disableEagerExecution)
        If WorkflowClient is used to create a WorkerFactory that is
        • started
        • has a non-paused worker on the right task queue
        • has available workflow task executor slots
        and such a WorkflowClient is used to start a workflow, then the first workflow task could be dispatched on this local worker with the response to the start call if Server supports it. This option can be used to disable this mechanism.

        Default is true

        WARNING: Eager start does not respect worker versioning. An eagerly started workflow may run on any available local worker even if that worker is not in the default build ID set.

        Parameters:
        disableEagerExecution - if true, an eager local execution of the workflow task will never be requested even if it is possible.

      • setStartDelay

        public WorkflowOptions.Builder setStartDelay​(java.time.Duration startDelay)
        Time to wait before dispatching the first workflow task. If the workflow gets a signal before the delay, a workflow task will be dispatched and the rest of the delay will be ignored. A signal from signal with start will not trigger a workflow task. Cannot be set the same time as a CronSchedule.

      • validateBuildWithDefaults

        public WorkflowOptions validateBuildWithDefaults()
        Validates that all required properties are set and fills all other with default parameters.