Package software.amazon.lambda.durable.operation

Class CallbackOperation<T>

java.lang.Object

software.amazon.lambda.durable.operation.BaseDurableOperation<T>

software.amazon.lambda.durable.operation.CallbackOperation<T>

All Implemented Interfaces:

DurableCallbackFuture<T>, DurableFuture<T>

public class CallbackOperation<T>
extends BaseDurableOperation<T>
implements DurableCallbackFuture<T>

Durable operation for creating and waiting on external callbacks.

Field Summary

Fields inherited from class software.amazon.lambda.durable.operation.BaseDurableOperation

completionFuture

Constructor Summary

Constructors

Constructor	Description
CallbackOperation(String operationId, String name, TypeToken<T> resultTypeToken, CallbackConfig config, ExecutionManager executionManager)	Convenience constructor for root-context operations where parentId is null.
CallbackOperation(String operationId, String name, TypeToken<T> resultTypeToken, CallbackConfig config, ExecutionManager executionManager, String parentId)

Method Summary

Modifier and Type	Method	Description
String	callbackId()	Returns the unique identifier for this callback.
void	execute()	Starts the operation.
T	get()	Blocks until the operation completes and returns the result.

Methods inherited from class software.amazon.lambda.durable.operation.BaseDurableOperation

deregisterActiveThread, deserializeException, deserializeResult, getCurrentThreadContext, getName, getOperation, getOperationId, getParentId, getType, isOperationCompleted, markAlreadyCompleted, onCheckpointComplete, pollForOperationUpdates, pollForOperationUpdates, registerActiveThread, sendOperationUpdate, sendOperationUpdateAsync, serializeException, serializeResult, setCurrentThreadContext, terminateExecution, terminateExecutionWithIllegalDurableOperationException, validateReplay, waitForOperationCompletion

Methods inherited from class java.lang.Object

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

Constructor Details

CallbackOperation

public CallbackOperation(String operationId,
 String name,
 TypeToken<T> resultTypeToken,
 CallbackConfig config,
 ExecutionManager executionManager,
 String parentId)

CallbackOperation

public CallbackOperation(String operationId,
 String name,
 TypeToken<T> resultTypeToken,
 CallbackConfig config,
 ExecutionManager executionManager)

Convenience constructor for root-context operations where parentId is null.

Method Details

callbackId

public String callbackId()

Description copied from interface: DurableCallbackFuture

Returns the unique identifier for this callback.

External systems use this ID to send callback results back to the durable execution.

Specified by:

callbackId in interface DurableCallbackFuture<T>

Returns:

the callback ID

execute

public void execute()

Description copied from class: BaseDurableOperation

Starts the operation. Returns immediately after starting background work or checkpointing. Does not block.

Specified by:

execute in class BaseDurableOperation<T>

get

public T get()

Description copied from interface: DurableFuture

Blocks until the operation completes and returns the result.

This delegates to operation.get() which handles: - Thread deregistration (allows suspension) - Thread reactivation (resumes execution) - Result retrieval

Specified by:

get in interface DurableFuture<T>

Returns:

the operation result