io.temporal.internal.common

Class WorkflowExecutionUtils

java.lang.Object

io.temporal.internal.common.WorkflowExecutionUtils

public class WorkflowExecutionUtils
extends java.lang.Object

Convenience methods to be used by unit tests and during development.

Constructor Summary

Constructors

Constructor and Description
WorkflowExecutionUtils()

Method Summary

Modifier and Type	Method and Description
static boolean	containsEvent(java.util.List<io.temporal.history.v1.HistoryEvent> history, io.temporal.enums.v1.EventType eventType)
static io.temporal.workflow.v1.WorkflowExecutionInfo	describeWorkflowInstance(WorkflowServiceStubs service, java.lang.String namespace, io.temporal.common.v1.WorkflowExecution workflowExecution)
static io.temporal.enums.v1.WorkflowExecutionStatus	getCloseStatus(io.temporal.history.v1.HistoryEvent event)
static io.temporal.enums.v1.EventType	getEventTypeForDecision(io.temporal.enums.v1.DecisionType decisionType)
static java.lang.String	getFailureCause(io.temporal.history.v1.HistoryEvent historyEvent)
static java.util.Iterator<io.temporal.history.v1.HistoryEvent>	getHistory(WorkflowServiceStubs service, java.lang.String namespace, io.temporal.common.v1.WorkflowExecution workflowExecution)
static io.temporal.workflowservice.v1.GetWorkflowExecutionHistoryResponse	getHistoryPage(WorkflowServiceStubs service, java.lang.String namespace, io.temporal.common.v1.WorkflowExecution workflowExecution, com.google.protobuf.ByteString nextPageToken)
static java.lang.String	getId(io.temporal.history.v1.HistoryEvent historyEvent)
static io.temporal.history.v1.HistoryEvent	getInstanceCloseEvent(WorkflowServiceStubs service, java.lang.String namespace, io.temporal.common.v1.WorkflowExecution workflowExecution, long timeout, java.util.concurrent.TimeUnit unit) Returns an instance closing event, potentially waiting for workflow to complete.
static java.util.Optional<io.temporal.common.v1.Payloads>	getWorkflowExecutionResult(WorkflowServiceStubs service, java.lang.String namespace, io.temporal.common.v1.WorkflowExecution workflowExecution, java.util.Optional<java.lang.String> workflowType, long timeout, java.util.concurrent.TimeUnit unit, DataConverter converter) Returns result of a workflow instance execution or throws an exception if workflow did not complete successfully.
static java.util.concurrent.CompletableFuture<java.util.Optional<io.temporal.common.v1.Payloads>>	getWorkflowExecutionResultAsync(WorkflowServiceStubs service, java.lang.String namespace, io.temporal.common.v1.WorkflowExecution workflowExecution, java.util.Optional<java.lang.String> workflowType, long timeout, java.util.concurrent.TimeUnit unit, DataConverter converter)
static io.temporal.common.v1.WorkflowExecution	getWorkflowIdFromExternalWorkflowCompletedEvent(io.temporal.history.v1.HistoryEvent event)
static boolean	isActivityTaskClosedEvent(io.temporal.history.v1.HistoryEvent event)
static boolean	isDecisionEvent(io.temporal.history.v1.HistoryEvent event) Is this an event that was created to mirror a decision?
static boolean	isExternalWorkflowClosedEvent(io.temporal.history.v1.HistoryEvent event)
static boolean	isWorkflowExecutionCompleteDecision(io.temporal.decision.v1.Decision decision)
static boolean	isWorkflowExecutionCompletedEvent(io.temporal.history.v1.HistoryEventOrBuilder event)
static java.lang.String	prettyPrintDecisions(java.lang.Iterable<io.temporal.decision.v1.Decision> decisions)
static java.lang.String	prettyPrintHistory(io.temporal.history.v1.History history, boolean showWorkflowTasks) Returns workflow instance history in a human readable format.
static java.lang.String	prettyPrintHistory(java.util.Iterator<io.temporal.history.v1.HistoryEvent> events, boolean showWorkflowTasks)
static java.lang.String	prettyPrintHistory(WorkflowServiceStubs service, java.lang.String namespace, io.temporal.common.v1.WorkflowExecution workflowExecution) Returns workflow instance history in a human readable format.
static java.lang.String	prettyPrintHistory(WorkflowServiceStubs service, java.lang.String namespace, io.temporal.common.v1.WorkflowExecution workflowExecution, boolean showWorkflowTasks) Returns workflow instance history in a human readable format.
static java.lang.String	prettyPrintObject(com.google.protobuf.MessageOrBuilder object) Pretty prints a proto message.
static WorkflowExecutionHistory	readHistory(java.io.File historyFile)
static WorkflowExecutionHistory	readHistoryFromResource(java.lang.String resourceFileName)
static io.temporal.enums.v1.WorkflowExecutionStatus	waitForWorkflowInstanceCompletion(WorkflowServiceStubs service, java.lang.String namespace, io.temporal.common.v1.WorkflowExecution workflowExecution) Blocks until workflow instance completes.
static io.temporal.enums.v1.WorkflowExecutionStatus	waitForWorkflowInstanceCompletion(WorkflowServiceStubs service, java.lang.String namespace, io.temporal.common.v1.WorkflowExecution workflowExecution, long timeout, java.util.concurrent.TimeUnit unit) Waits up to specified timeout for workflow instance completion.
static io.temporal.enums.v1.WorkflowExecutionStatus	waitForWorkflowInstanceCompletionAcrossGenerations(WorkflowServiceStubs service, java.lang.String namespace, io.temporal.common.v1.WorkflowExecution workflowExecution) Like waitForWorkflowInstanceCompletion(WorkflowServiceStubs, String, WorkflowExecution, long, TimeUnit) , but with no timeout.*
static io.temporal.enums.v1.WorkflowExecutionStatus	waitForWorkflowInstanceCompletionAcrossGenerations(WorkflowServiceStubs service, java.lang.String namespace, io.temporal.common.v1.WorkflowExecution workflowExecution, long timeout, java.util.concurrent.TimeUnit unit) Like waitForWorkflowInstanceCompletion(WorkflowServiceStubs, String, WorkflowExecution, long, TimeUnit) , except will wait for continued generations of the original workflow execution too.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

WorkflowExecutionUtils

public WorkflowExecutionUtils()

Method Detail

getWorkflowExecutionResult

public static java.util.Optional<io.temporal.common.v1.Payloads> getWorkflowExecutionResult(WorkflowServiceStubs service,
                                                                                            java.lang.String namespace,
                                                                                            io.temporal.common.v1.WorkflowExecution workflowExecution,
                                                                                            java.util.Optional<java.lang.String> workflowType,
                                                                                            long timeout,
                                                                                            java.util.concurrent.TimeUnit unit,
                                                                                            DataConverter converter)
                                                                                     throws java.util.concurrent.TimeoutException

Returns result of a workflow instance execution or throws an exception if workflow did not complete successfully.

Parameters:

workflowType - is optional.

Throws:

java.util.concurrent.TimeoutException - if workflow didn't complete within specified timeout

CanceledFailure - if workflow was cancelled

WorkflowExecutionFailedException - if workflow execution failed

getWorkflowExecutionResultAsync

public static java.util.concurrent.CompletableFuture<java.util.Optional<io.temporal.common.v1.Payloads>> getWorkflowExecutionResultAsync(WorkflowServiceStubs service,
                                                                                                                                         java.lang.String namespace,
                                                                                                                                         io.temporal.common.v1.WorkflowExecution workflowExecution,
                                                                                                                                         java.util.Optional<java.lang.String> workflowType,
                                                                                                                                         long timeout,
                                                                                                                                         java.util.concurrent.TimeUnit unit,
                                                                                                                                         DataConverter converter)

getInstanceCloseEvent

public static io.temporal.history.v1.HistoryEvent getInstanceCloseEvent(WorkflowServiceStubs service,
                                                                        java.lang.String namespace,
                                                                        io.temporal.common.v1.WorkflowExecution workflowExecution,
                                                                        long timeout,
                                                                        java.util.concurrent.TimeUnit unit)
                                                                 throws java.util.concurrent.TimeoutException

Returns an instance closing event, potentially waiting for workflow to complete.

Throws:

java.util.concurrent.TimeoutException

isWorkflowExecutionCompletedEvent

public static boolean isWorkflowExecutionCompletedEvent(io.temporal.history.v1.HistoryEventOrBuilder event)

isWorkflowExecutionCompleteDecision

public static boolean isWorkflowExecutionCompleteDecision(io.temporal.decision.v1.Decision decision)

isActivityTaskClosedEvent

public static boolean isActivityTaskClosedEvent(io.temporal.history.v1.HistoryEvent event)

isExternalWorkflowClosedEvent

public static boolean isExternalWorkflowClosedEvent(io.temporal.history.v1.HistoryEvent event)

getWorkflowIdFromExternalWorkflowCompletedEvent

public static io.temporal.common.v1.WorkflowExecution getWorkflowIdFromExternalWorkflowCompletedEvent(io.temporal.history.v1.HistoryEvent event)

getId

public static java.lang.String getId(io.temporal.history.v1.HistoryEvent historyEvent)

getFailureCause

public static java.lang.String getFailureCause(io.temporal.history.v1.HistoryEvent historyEvent)

waitForWorkflowInstanceCompletion

public static io.temporal.enums.v1.WorkflowExecutionStatus waitForWorkflowInstanceCompletion(WorkflowServiceStubs service,
                                                                                             java.lang.String namespace,
                                                                                             io.temporal.common.v1.WorkflowExecution workflowExecution)

Blocks until workflow instance completes. Never use in production setting as polling for worklow instance status is an expensive operation.

Parameters:

workflowExecution - workflowId and optional runId

Returns:

instance close status

waitForWorkflowInstanceCompletion

public static io.temporal.enums.v1.WorkflowExecutionStatus waitForWorkflowInstanceCompletion(WorkflowServiceStubs service,
                                                                                             java.lang.String namespace,
                                                                                             io.temporal.common.v1.WorkflowExecution workflowExecution,
                                                                                             long timeout,
                                                                                             java.util.concurrent.TimeUnit unit)
                                                                                      throws java.util.concurrent.TimeoutException

Waits up to specified timeout for workflow instance completion. Never use in production setting as polling for worklow instance status is an expensive operation.

Parameters:

workflowExecution - workflowId and optional runId

timeout - maximum time to wait for completion. 0 means wait forever.

Returns:

instance close status

Throws:

java.util.concurrent.TimeoutException

getCloseStatus

public static io.temporal.enums.v1.WorkflowExecutionStatus getCloseStatus(io.temporal.history.v1.HistoryEvent event)

waitForWorkflowInstanceCompletionAcrossGenerations

public static io.temporal.enums.v1.WorkflowExecutionStatus waitForWorkflowInstanceCompletionAcrossGenerations(WorkflowServiceStubs service,
                                                                                                              java.lang.String namespace,
                                                                                                              io.temporal.common.v1.WorkflowExecution workflowExecution,
                                                                                                              long timeout,
                                                                                                              java.util.concurrent.TimeUnit unit)
                                                                                                       throws java.util.concurrent.TimeoutException

Like waitForWorkflowInstanceCompletion(WorkflowServiceStubs, String, WorkflowExecution, long, TimeUnit) , except will wait for continued generations of the original workflow execution too.

Throws:

java.util.concurrent.TimeoutException

See Also:

waitForWorkflowInstanceCompletion(WorkflowServiceStubs, String, WorkflowExecution, long, TimeUnit)

waitForWorkflowInstanceCompletionAcrossGenerations

public static io.temporal.enums.v1.WorkflowExecutionStatus waitForWorkflowInstanceCompletionAcrossGenerations(WorkflowServiceStubs service,
                                                                                                              java.lang.String namespace,
                                                                                                              io.temporal.common.v1.WorkflowExecution workflowExecution)
                                                                                                       throws java.lang.InterruptedException

Like waitForWorkflowInstanceCompletion(WorkflowServiceStubs, String, WorkflowExecution, long, TimeUnit) , but with no timeout.*

Throws:

java.lang.InterruptedException

describeWorkflowInstance

public static io.temporal.workflow.v1.WorkflowExecutionInfo describeWorkflowInstance(WorkflowServiceStubs service,
                                                                                     java.lang.String namespace,
                                                                                     io.temporal.common.v1.WorkflowExecution workflowExecution)

getHistoryPage

public static io.temporal.workflowservice.v1.GetWorkflowExecutionHistoryResponse getHistoryPage(WorkflowServiceStubs service,
                                                                                                java.lang.String namespace,
                                                                                                io.temporal.common.v1.WorkflowExecution workflowExecution,
                                                                                                com.google.protobuf.ByteString nextPageToken)

prettyPrintHistory

public static java.lang.String prettyPrintHistory(WorkflowServiceStubs service,
                                                  java.lang.String namespace,
                                                  io.temporal.common.v1.WorkflowExecution workflowExecution)

Returns workflow instance history in a human readable format.

prettyPrintHistory

public static java.lang.String prettyPrintHistory(WorkflowServiceStubs service,
                                                  java.lang.String namespace,
                                                  io.temporal.common.v1.WorkflowExecution workflowExecution,
                                                  boolean showWorkflowTasks)

Returns workflow instance history in a human readable format.

Parameters:

showWorkflowTasks - when set to false workflow task events (decider events) are not included

getHistory

public static java.util.Iterator<io.temporal.history.v1.HistoryEvent> getHistory(WorkflowServiceStubs service,
                                                                                 java.lang.String namespace,
                                                                                 io.temporal.common.v1.WorkflowExecution workflowExecution)

prettyPrintHistory

public static java.lang.String prettyPrintHistory(io.temporal.history.v1.History history,
                                                  boolean showWorkflowTasks)

Returns workflow instance history in a human readable format.

Parameters:

showWorkflowTasks - when set to false workflow task events (decider events) are not included

history - Workflow instance history

prettyPrintHistory

public static java.lang.String prettyPrintHistory(java.util.Iterator<io.temporal.history.v1.HistoryEvent> events,
                                                  boolean showWorkflowTasks)

prettyPrintDecisions

public static java.lang.String prettyPrintDecisions(java.lang.Iterable<io.temporal.decision.v1.Decision> decisions)

prettyPrintObject

public static java.lang.String prettyPrintObject(com.google.protobuf.MessageOrBuilder object)

Pretty prints a proto message.

containsEvent

public static boolean containsEvent(java.util.List<io.temporal.history.v1.HistoryEvent> history,
                                    io.temporal.enums.v1.EventType eventType)

isDecisionEvent

public static boolean isDecisionEvent(io.temporal.history.v1.HistoryEvent event)

Is this an event that was created to mirror a decision?

getEventTypeForDecision

public static io.temporal.enums.v1.EventType getEventTypeForDecision(io.temporal.enums.v1.DecisionType decisionType)

readHistoryFromResource

public static WorkflowExecutionHistory readHistoryFromResource(java.lang.String resourceFileName)
                                                        throws java.io.IOException

Throws:

java.io.IOException

readHistory

public static WorkflowExecutionHistory readHistory(java.io.File historyFile)
                                            throws java.io.IOException

Throws:

java.io.IOException