Optional durable failure finalization for a TaskHandler.
The worker awaits this after persisting a terminal failed TaskStatus and before acknowledging or dead-lettering the delivery. It is not called for retryable attempts or failures that reject a task before execution. The status contains the persisted error; Envelope is the original failed attempt, not a possibly modified redelivery. It can run again on terminal redelivery, so implementations must be idempotent. Throwing leaves the delivery unacknowledged. Authenticated redelivery retries finalization without executing the handler again, even after expiration or revocation.
Task status persistence and this callback are not one transaction. The worker retains finalization metadata in the status, so successful callbacks can also be repeated on subsequent redelivery.
Properties
- hashCode → int
-
The hash code for this object.
no setterinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
Methods
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
onTerminalFailure(
Envelope envelope, TaskStatus status) → Future< void> -
Finalizes the persisted failure for
envelope. -
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited