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 no plugins are registered or the input could not be deserialized; this component is experimental
public record InvocationInfo(String requestId, String durableExecutionArn, boolean isFirstInvocation, Instant executionStartTime, @Experimental Object executionInput) extends Record
Invocation-level information available to plugin hooks.

  • Constructor Details

    • InvocationInfo

      public InvocationInfo(String requestId, String durableExecutionArn, boolean isFirstInvocation, Instant executionStartTime, @Experimental Object executionInput)
      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

    • InvocationInfo

      public InvocationInfo(String requestId, String durableExecutionArn, boolean isFirstInvocation, Instant executionStartTime)
      Creates invocation information without an execution input.

      Retained so callers written before executionInput was added keep compiling; executionInput resolves to null.

      Parameters:
      requestId - the Lambda request ID for this invocation
      durableExecutionArn - the durable execution ARN
      isFirstInvocation - true if this is the first invocation of the execution
      executionStartTime - the start timestamp of the durable execution
      Throws:
      NullPointerException - if executionStartTime is null

  • Method Details

    • toString

      public String toString()
      Returns a representation that omits executionInput.

      The generated representation would render the execution input, so plugins that log this object whole would start emitting customer payloads, potentially including secrets or personal data. Read the component explicitly to record it.

      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

      @Experimental public Object executionInput()
      Returns the value of the executionInput record component.
      Returns:
      the value of the executionInput record component