Annotation Interface EventSubscription

@Documented @Retention(RUNTIME) @Target(METHOD) public @interface EventSubscription
Declares an activation-owned durable event handler registered by a trusted host adapter. Delivery is at least once: the source cursor is acknowledged only after actual handler completion. The handler accepts one managed event delivery and returns void or CompletionStage<Void>. A snapshot is explicitly distinguished from a subsequent event. Endpoint refresh preserves the stable subscription identity; history expiry follows the installed host profile, never a silent reset.

  • Required Element Summary

    Required Elements
    Modifier and Type
    Required Element
    Description
    String
    value
    Returns the stable subscription identity within the host's source namespace.

  • Optional Element Summary

    Optional Elements
    Modifier and Type
    Optional Element
    Description
    String
    filter
    Selects an exact source operation; empty includes all operations.
    String
    policy
    Selects an installed host source/metadata/expiry policy.
    int
    version
    Declares the durable handler contract version; incompatible definitions require a new identity.

  • Element Details

    • value

      String value
      Returns the stable subscription identity within the host's source namespace.
      Returns:
      nonempty ASCII identity, at most128 characters

    • policy

      String policy
      Selects an installed host source/metadata/expiry policy.
      Returns:
      fixed profile name
      Default:
      "default"

    • filter

      String filter
      Selects an exact source operation; empty includes all operations.
      Returns:
      operation filter
      Default:
      ""

    • version

      int version
      Declares the durable handler contract version; incompatible definitions require a new identity.
      Returns:
      positive version
      Default:
      1