Package software.amazon.lambda.durable.plugin

Record Class InvocationInfo

java.lang.Object

java.lang.Record

software.amazon.lambda.durable.plugin.InvocationInfo

Record Components:

requestId - the Lambda request ID for this invocation

durableExecutionArn - the durable execution ARN

isFirstInvocation - true if this is the first invocation of the execution (not a replay invocation)

executionStartTime - the start timestamp of the durable execution, taken from the initial EXECUTION operation in the first event delivered by the backend. Never null and stable across all invocations of the same execution.

executionInput - the deserialized execution input passed to the user handler, or null when unavailable

operations - checkpointed operations delivered at invocation start, keyed by operation ID

updatedOperations - operations changed externally since the previous invocation, keyed by operation ID

xRayTraceId - immutable invocation-local X-Ray header; null means unavailable and permits legacy carrier fallback, while an empty string means an available runtime supplied no header

public record InvocationInfo(String requestId, String durableExecutionArn, boolean isFirstInvocation, Instant executionStartTime, Object executionInput, Map<String,OperationChangeItemInfo> operations, Map<String,OperationChangeItemInfo> updatedOperations, String xRayTraceId)
extends Record

Invocation-level information available to plugin hooks.

The nullable runtime header is the eighth record component. Legacy constructors remain available, but source record patterns must include the new component; reflection and record value semantics observe the new field.

Constructor Summary

Constructors

Constructor	Description
InvocationInfo(String requestId, String durableExecutionArn, boolean isFirstInvocation, Instant executionStartTime)	Creates invocation information without payload or operation snapshots.
InvocationInfo(String requestId, String durableExecutionArn, boolean isFirstInvocation, Instant executionStartTime, Object executionInput)	Creates invocation information without operation snapshots.
InvocationInfo(String requestId, String durableExecutionArn, boolean isFirstInvocation, Instant executionStartTime, Object executionInput, Map<String,OperationChangeItemInfo> operations, Map<String,OperationChangeItemInfo> updatedOperations)	Retains the original seven-argument constructor for callers without a runtime header snapshot.
InvocationInfo(String requestId, String durableExecutionArn, boolean isFirstInvocation, Instant executionStartTime, Object executionInput, Map<String,OperationChangeItemInfo> operations, Map<String,OperationChangeItemInfo> updatedOperations, String xRayTraceId)	Creates an instance of a InvocationInfo record class.
InvocationInfo(String requestId, String durableExecutionArn, boolean isFirstInvocation, Instant executionStartTime, Map<String,OperationChangeItemInfo> operations, Map<String,OperationChangeItemInfo> updatedOperations)	Creates invocation information without an execution input.

Method Summary

Modifier and Type	Method	Description
String	durableExecutionArn()	Returns the value of the durableExecutionArn record component.
final boolean	equals(Object o)	Indicates whether some other object is "equal to" this one.
Object	executionInput()	Returns the value of the executionInput record component.
Instant	executionStartTime()	Returns the value of the executionStartTime record component.
final int	hashCode()	Returns a hash code value for this object.
boolean	isFirstInvocation()	Returns the value of the isFirstInvocation record component.
Map<String,OperationChangeItemInfo>	operations()	Returns the value of the operations record component.
String	requestId()	Returns the value of the requestId record component.
String	toString()	Returns a representation that omits execution payloads, operation snapshots, and the runtime header.
Map<String,OperationChangeItemInfo>	updatedOperations()	Returns the value of the updatedOperations record component.
String	xRayTraceId()	Returns the value of the xRayTraceId record component.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

InvocationInfo

public InvocationInfo(String requestId,
 String durableExecutionArn,
 boolean isFirstInvocation,
 Instant executionStartTime,
 Object executionInput,
 Map<String,OperationChangeItemInfo> operations,
 Map<String,OperationChangeItemInfo> updatedOperations,
 String xRayTraceId)

Creates an instance of a InvocationInfo record class.

Parameters:

requestId - the value for the requestId record component

durableExecutionArn - the value for the durableExecutionArn record component

isFirstInvocation - the value for the isFirstInvocation record component

executionStartTime - the value for the executionStartTime record component

executionInput - the value for the executionInput record component

operations - the value for the operations record component

updatedOperations - the value for the updatedOperations record component

xRayTraceId - the value for the xRayTraceId record component

InvocationInfo

public InvocationInfo(String requestId,
 String durableExecutionArn,
 boolean isFirstInvocation,
 Instant executionStartTime,
 Object executionInput,
 Map<String,OperationChangeItemInfo> operations,
 Map<String,OperationChangeItemInfo> updatedOperations)

Retains the original seven-argument constructor for callers without a runtime header snapshot.

InvocationInfo

public InvocationInfo(String requestId,
 String durableExecutionArn,
 boolean isFirstInvocation,
 Instant executionStartTime)

Creates invocation information without payload or operation snapshots.

InvocationInfo

public InvocationInfo(String requestId,
 String durableExecutionArn,
 boolean isFirstInvocation,
 Instant executionStartTime,
 Object executionInput)

Creates invocation information without operation snapshots.

InvocationInfo

public InvocationInfo(String requestId,
 String durableExecutionArn,
 boolean isFirstInvocation,
 Instant executionStartTime,
 Map<String,OperationChangeItemInfo> operations,
 Map<String,OperationChangeItemInfo> updatedOperations)

Creates invocation information without an execution input.

Method Details

toString

public String toString()

Returns a representation that omits execution payloads, operation snapshots, and the runtime header.

Specified by:

toString in class Record

hashCode

public final int hashCode()

Returns a hash code value for this object. The value is derived from the hash code of each of the record components.

Specified by:

hashCode in class Record

Returns:

a hash code value for this object

equals

public final boolean equals(Object o)

Indicates whether some other object is "equal to" this one. The objects are equal if the other object is of the same class and if all the record components are equal. Reference components are compared with Objects::equals(Object,Object); primitive components are compared with '=='.

Specified by:

equals in class Record

Parameters:

o - the object with which to compare

Returns:

true if this object is the same as the o argument; false otherwise.

requestId

public String requestId()

Returns the value of the requestId record component.

Returns:

the value of the requestId record component

durableExecutionArn

public String durableExecutionArn()

Returns the value of the durableExecutionArn record component.

Returns:

the value of the durableExecutionArn record component

isFirstInvocation

public boolean isFirstInvocation()

Returns the value of the isFirstInvocation record component.

Returns:

the value of the isFirstInvocation record component

executionStartTime

public Instant executionStartTime()

Returns the value of the executionStartTime record component.

Returns:

the value of the executionStartTime record component

executionInput

public Object executionInput()

Returns the value of the executionInput record component.

Returns:

the value of the executionInput record component

operations

public Map<String,OperationChangeItemInfo> operations()

Returns the value of the operations record component.

Returns:

the value of the operations record component

updatedOperations

public Map<String,OperationChangeItemInfo> updatedOperations()

Returns the value of the updatedOperations record component.

Returns:

the value of the updatedOperations record component

xRayTraceId

public String xRayTraceId()

Returns the value of the xRayTraceId record component.

Returns:

the value of the xRayTraceId record component