io.temporal.internal.replay

Interface DecisionContext

All Superinterfaces:

ReplayAware

public interface DecisionContext
extends ReplayAware

Represents the context for decider. Should only be used within the scope of workflow definition code, meaning any code which is not part of activity implementations.

Method Summary

Modifier and Type	Method and Description
void	continueAsNewOnCompletion(ContinueAsNewWorkflowExecutionParameters parameters)
java.util.function.Consumer<java.lang.Exception>	createTimer(long delaySeconds, java.util.function.Consumer<java.lang.Exception> callback) Create a Value that becomes ready after the specified delay.
long	currentTimeMillis()
java.util.List<ContextPropagator>	getContextPropagators() Returns the set of configured context propagators
ContinueAsNewWorkflowExecutionParameters	getContinueAsNewOnCompletion()
java.util.Optional<java.lang.String>	getContinuedExecutionRunId()
boolean	getEnableLoggingInReplay()
com.uber.m3.tally.Scope	getMetricsScope()
java.lang.String	getNamespace()
io.temporal.common.v1.WorkflowExecution	getParentWorkflowExecution()
java.util.Map<java.lang.String,java.lang.Object>	getPropagatedContexts() Returns all of the current contexts being propagated by a ContextPropagator.
java.lang.String	getRunId()
long	getRunStartedTimestampMillis()
io.temporal.common.v1.SearchAttributes	getSearchAttributes() Used to retrieve search attributes.
java.lang.String	getTaskList()
int	getVersion(java.lang.String changeId, DataConverter dataConverter, int minSupported, int maxSupported) GetVersion is used to safely perform backwards incompatible changes to workflow definitions.
io.temporal.common.v1.WorkflowExecution	getWorkflowExecution()
long	getWorkflowExecutionExpirationTimestampMillis()
java.time.Duration	getWorkflowExecutionTimeout()
java.lang.String	getWorkflowId()
java.time.Duration	getWorkflowRunTimeout()
java.time.Duration	getWorkflowTaskTimeout()
io.temporal.common.v1.WorkflowType	getWorkflowType()
boolean	isCancelRequested()
java.util.Optional<io.temporal.common.v1.Payloads>	mutableSideEffect(java.lang.String id, DataConverter dataConverter, Functions.Func1<java.util.Optional<io.temporal.common.v1.Payloads>,java.util.Optional<io.temporal.common.v1.Payloads>> func)
java.util.Random	newRandom()
java.util.UUID	randomUUID()
Promise<java.lang.Void>	requestCancelWorkflowExecution(io.temporal.common.v1.WorkflowExecution execution)
java.util.function.Consumer<java.lang.Exception>	scheduleActivityTask(ExecuteActivityParameters parameters, java.util.function.BiConsumer<java.util.Optional<io.temporal.common.v1.Payloads>,java.lang.Exception> callback) Used to dynamically schedule an activity for execution
java.util.function.Consumer<java.lang.Exception>	scheduleLocalActivityTask(ExecuteLocalActivityParameters parameters, java.util.function.BiConsumer<java.util.Optional<io.temporal.common.v1.Payloads>,java.lang.Exception> callback)
void	setContinueAsNewOnCompletion(ContinueAsNewWorkflowExecutionParameters continueParameters)
java.util.Optional<io.temporal.common.v1.Payloads>	sideEffect(Functions.Func<java.util.Optional<io.temporal.common.v1.Payloads>> func) Executes the provided function once, records its result into the workflow history.
java.util.function.Consumer<java.lang.Exception>	signalWorkflowExecution(SignalExternalWorkflowParameters signalParameters, java.util.function.BiConsumer<java.lang.Void,java.lang.Exception> callback)
java.util.function.Consumer<java.lang.Exception>	startChildWorkflow(StartChildWorkflowExecutionParameters parameters, java.util.function.Consumer<io.temporal.common.v1.WorkflowExecution> executionCallback, java.util.function.BiConsumer<java.util.Optional<io.temporal.common.v1.Payloads>,java.lang.Exception> callback) Start child workflow.
void	upsertSearchAttributes(io.temporal.common.v1.SearchAttributes searchAttributes)

Methods inherited from interface io.temporal.internal.replay.ReplayAware

isReplaying

Method Detail

getWorkflowExecution

io.temporal.common.v1.WorkflowExecution getWorkflowExecution()

getParentWorkflowExecution

io.temporal.common.v1.WorkflowExecution getParentWorkflowExecution()

getWorkflowType

io.temporal.common.v1.WorkflowType getWorkflowType()

isCancelRequested

boolean isCancelRequested()

getContinueAsNewOnCompletion

ContinueAsNewWorkflowExecutionParameters getContinueAsNewOnCompletion()

setContinueAsNewOnCompletion

void setContinueAsNewOnCompletion(ContinueAsNewWorkflowExecutionParameters continueParameters)

getContinuedExecutionRunId

java.util.Optional<java.lang.String> getContinuedExecutionRunId()

getTaskList

java.lang.String getTaskList()

getNamespace

java.lang.String getNamespace()

getWorkflowId

java.lang.String getWorkflowId()

getRunId

java.lang.String getRunId()

getWorkflowRunTimeout

java.time.Duration getWorkflowRunTimeout()

getWorkflowExecutionTimeout

java.time.Duration getWorkflowExecutionTimeout()

getRunStartedTimestampMillis

long getRunStartedTimestampMillis()

getWorkflowExecutionExpirationTimestampMillis

long getWorkflowExecutionExpirationTimestampMillis()

getWorkflowTaskTimeout

java.time.Duration getWorkflowTaskTimeout()

getSearchAttributes

io.temporal.common.v1.SearchAttributes getSearchAttributes()

Used to retrieve search attributes.

Returns:

SearchAttribute object which can be used by WorkflowUtils.getValueFromSearchAttributes to retrieve concrete value.

getPropagatedContexts

java.util.Map<java.lang.String,java.lang.Object> getPropagatedContexts()

Returns all of the current contexts being propagated by a ContextPropagator. The key is the ContextPropagator.getName() and the value is the object returned by ContextPropagator.getCurrentContext()

getContextPropagators

java.util.List<ContextPropagator> getContextPropagators()

Returns the set of configured context propagators

scheduleActivityTask

java.util.function.Consumer<java.lang.Exception> scheduleActivityTask(ExecuteActivityParameters parameters,
                                                                      java.util.function.BiConsumer<java.util.Optional<io.temporal.common.v1.Payloads>,java.lang.Exception> callback)

Used to dynamically schedule an activity for execution

Parameters:

parameters - An object which encapsulates all the information required to schedule an activity for execution

callback - Callback that is called upon activity completion or failure.

Returns:

cancellation handle. Invoke Consumer.accept(Object) to cancel activity task.

scheduleLocalActivityTask

java.util.function.Consumer<java.lang.Exception> scheduleLocalActivityTask(ExecuteLocalActivityParameters parameters,
                                                                           java.util.function.BiConsumer<java.util.Optional<io.temporal.common.v1.Payloads>,java.lang.Exception> callback)

startChildWorkflow

java.util.function.Consumer<java.lang.Exception> startChildWorkflow(StartChildWorkflowExecutionParameters parameters,
                                                                    java.util.function.Consumer<io.temporal.common.v1.WorkflowExecution> executionCallback,
                                                                    java.util.function.BiConsumer<java.util.Optional<io.temporal.common.v1.Payloads>,java.lang.Exception> callback)

Start child workflow.

Parameters:

parameters - An object which encapsulates all the information required to schedule a child workflow for execution

callback - Callback that is called upon child workflow completion or failure.

Returns:

cancellation handle. Invoke Consumer.accept(Object) to cancel activity task.

signalWorkflowExecution

java.util.function.Consumer<java.lang.Exception> signalWorkflowExecution(SignalExternalWorkflowParameters signalParameters,
                                                                         java.util.function.BiConsumer<java.lang.Void,java.lang.Exception> callback)

requestCancelWorkflowExecution

Promise<java.lang.Void> requestCancelWorkflowExecution(io.temporal.common.v1.WorkflowExecution execution)

continueAsNewOnCompletion

void continueAsNewOnCompletion(ContinueAsNewWorkflowExecutionParameters parameters)

mutableSideEffect

java.util.Optional<io.temporal.common.v1.Payloads> mutableSideEffect(java.lang.String id,
                                                                     DataConverter dataConverter,
                                                                     Functions.Func1<java.util.Optional<io.temporal.common.v1.Payloads>,java.util.Optional<io.temporal.common.v1.Payloads>> func)

currentTimeMillis

long currentTimeMillis()

Returns:

time of the PollForDecisionTaskResponse start event of the decision being processed or replayed.

createTimer

java.util.function.Consumer<java.lang.Exception> createTimer(long delaySeconds,
                                                             java.util.function.Consumer<java.lang.Exception> callback)

Create a Value that becomes ready after the specified delay.

Parameters:

delaySeconds - time-interval after which the Value becomes ready in seconds.

callback - Callback that is called with null parameter after the specified delay. CanceledException is passed as a parameter in case of a cancellation.

Returns:

cancellation handle. Invoke Consumer.accept(Object) to cancel timer.

sideEffect

java.util.Optional<io.temporal.common.v1.Payloads> sideEffect(Functions.Func<java.util.Optional<io.temporal.common.v1.Payloads>> func)

Executes the provided function once, records its result into the workflow history. The recorded result on history will be returned without executing the provided function during replay. This guarantees the deterministic requirement for workflow as the exact same result will be returned in replay. Common use case is to run some short non-deterministic code in workflow, like getting random number or new UUID. The only way to fail SideEffect is to throw Error which causes decision task failure. The decision task after timeout is rescheduled and re-executed giving SideEffect another chance to succeed.

Parameters:

func - function that is called once to return a value.

Returns:

value of the side effect.

getVersion

int getVersion(java.lang.String changeId,
               DataConverter dataConverter,
               int minSupported,
               int maxSupported)

GetVersion is used to safely perform backwards incompatible changes to workflow definitions. It is not allowed to update workflow code while there are workflows running as it is going to break determinism. The solution is to have both old code that is used to replay existing workflows as well as the new one that is used when it is executed for the first time. GetVersion returns maxSupported version when executed for the first time. This version is recorded into the workflow history as a marker event. Even if maxSupported version is changed the version that was recorded is returned on replay. DefaultVersion constant contains version of code that wasn't versioned before.

Parameters:

changeId - identifier of a particular change

minSupported - min version supported for the change

maxSupported - max version supported for the change

Returns:

version

newRandom

java.util.Random newRandom()

getMetricsScope

com.uber.m3.tally.Scope getMetricsScope()

Returns:

scope to be used for metrics reporting.

getEnableLoggingInReplay

boolean getEnableLoggingInReplay()

Returns:

whether we do logging during decision replay.

randomUUID

java.util.UUID randomUUID()

Returns:

replay safe UUID

upsertSearchAttributes

void upsertSearchAttributes(io.temporal.common.v1.SearchAttributes searchAttributes)