Annotation Interface DeadLetterHandler

@Documented @Retention(RUNTIME) @Target(METHOD) public @interface DeadLetterHandler
Declares a method as a dead-letter handling hook.

An explicitly installed generated host adapter decodes the retained business payload inside an owned invocation. Success neither acknowledges/removes the original poison record nor authorizes redrive; administrative redrive is a separate fenced operation. Annotation presence alone does not create an observer.

  • Optional Element Summary

    Optional Elements
    Modifier and Type
    Optional Element
    Description
    String
    policy
    Selects a finite trusted host policy, never an administrative self-grant.
    String
    queue
    Returns the queue whose retained poison records are observed.
    String
    value
    Returns stable logical observer identity; empty uses generated declaring-type/method identity.
    int
    version
    Returns the positive logical observer contract version.

  • Element Details

    • queue

      String queue
      Returns the queue whose retained poison records are observed.
      Returns:
      host-authorized queue name
      Default:
      ""

    • value

      String value
      Returns stable logical observer identity; empty uses generated declaring-type/method identity.
      Returns:
      observer identity or empty
      Default:
      ""

    • policy

      String policy
      Selects a finite trusted host policy, never an administrative self-grant.
      Returns:
      profile name
      Default:
      "default"

    • version

      int version
      Returns the positive logical observer contract version.
      Returns:
      contract version
      Default:
      1