Clarify behavior of InvocationContext.getInterceptorBindings() in cas…

…e of inherited/transitive bindings
jakartaee · Jan 10, 2024 · e70f6de · e70f6de
1 parent 0ea3a7b
commit e70f6de
Show file tree

Hide file tree

Showing 2 changed files with 5 additions and 3 deletions.
diff --git a/api/src/main/java/jakarta/interceptor/InvocationContext.java b/api/src/main/java/jakarta/interceptor/InvocationContext.java
@@ -147,7 +147,8 @@ public interface InvocationContext {
      * invocation is being intercepted. In case there is no target method or target constructor,
      * interceptor binding annotations applied to the target class are returned.
      * <p>
-     * All interceptor binding annotations are returned, including interceptor binding annotations
+     * All interceptor binding annotations are returned, including inherited interceptor binding
+     * annotations, transitive interceptor binding annotations, interceptor binding annotations
      * that associate interceptors of a different interceptor method type, as well as interceptor
      * binding annotations that associate no interceptor.
      * <p>

diff --git a/spec/src/main/asciidoc/2_interceptor_programming_contract.adoc b/spec/src/main/asciidoc/2_interceptor_programming_contract.adoc
@@ -310,8 +310,9 @@ The `getInterceptorBindings` method returns the set of interceptor binding
 annotations for the method or constructor whose invocation is being intercepted.
 In case there is no target method or target constructor, interceptor binding
 annotations applied to the target class are returned. All interceptor binding
-annotations are returned, including interceptor binding annotations that associate
-interceptors of a different interceptor method type, as well as interceptor
+annotations are returned, including inherited interceptor binding annotations,
+transitive interceptor binding annotations, interceptor binding annotations that
+associate interceptors of a different interceptor method type, as well as interceptor
 binding annotations that associate no interceptor. The zero-parameter variant
 returns all interceptor binding annotations, while the variant with a `Class`
 parameter returns only interceptor binding annotations of given type.