From 5d78c5eab5ec86074c454e21090eb2176d2d4c78 Mon Sep 17 00:00:00 2001 From: Ladislav Thon Date: Wed, 19 Apr 2023 12:25:32 +0200 Subject: [PATCH] ArC: improve javadoc for InvocationContext implementations --- .../io/quarkus/arc/impl/AroundInvokeInvocationContext.java | 2 +- .../java/io/quarkus/arc/impl/InnerInvocationContext.java | 5 +++++ .../quarkus/arc/impl/LifecycleCallbackInvocationContext.java | 4 ++-- .../io/quarkus/arc/impl/SuperclassInvocationContext.java | 2 +- .../arc/impl/TargetAroundInvokeInvocationContext.java | 2 +- 5 files changed, 10 insertions(+), 5 deletions(-) diff --git a/independent-projects/arc/runtime/src/main/java/io/quarkus/arc/impl/AroundInvokeInvocationContext.java b/independent-projects/arc/runtime/src/main/java/io/quarkus/arc/impl/AroundInvokeInvocationContext.java index 73b87a7649c597..46739088b3933f 100644 --- a/independent-projects/arc/runtime/src/main/java/io/quarkus/arc/impl/AroundInvokeInvocationContext.java +++ b/independent-projects/arc/runtime/src/main/java/io/quarkus/arc/impl/AroundInvokeInvocationContext.java @@ -11,7 +11,7 @@ import io.quarkus.arc.ArcInvocationContext; /** - * An {@link javax.interceptor.InvocationContext} for {@link javax.interceptor.AroundInvoke} interceptors. + * An {@link jakarta.interceptor.InvocationContext} for {@link jakarta.interceptor.AroundInvoke} interceptors. *

* A new instance is created for the first interceptor in the chain. Furthermore, subsequent interceptors receive a new instance * of {@link NextAroundInvokeInvocationContext}. This does not comply with the spec but allows for "asynchronous continuation" diff --git a/independent-projects/arc/runtime/src/main/java/io/quarkus/arc/impl/InnerInvocationContext.java b/independent-projects/arc/runtime/src/main/java/io/quarkus/arc/impl/InnerInvocationContext.java index 26b617dcb1869e..e37c23950c9e67 100644 --- a/independent-projects/arc/runtime/src/main/java/io/quarkus/arc/impl/InnerInvocationContext.java +++ b/independent-projects/arc/runtime/src/main/java/io/quarkus/arc/impl/InnerInvocationContext.java @@ -11,6 +11,11 @@ import io.quarkus.arc.ArcInvocationContext; +/** + * Invocation context for an "inner" invocation chain, consisting of interceptor methods declared + * in one class and its superclasses. It doesn't proceed to other interceptors in the "outer" invocation + * chain (interceptor methods declared in other classes). + */ abstract class InnerInvocationContext implements ArcInvocationContext { protected final ArcInvocationContext delegate; diff --git a/independent-projects/arc/runtime/src/main/java/io/quarkus/arc/impl/LifecycleCallbackInvocationContext.java b/independent-projects/arc/runtime/src/main/java/io/quarkus/arc/impl/LifecycleCallbackInvocationContext.java index 3d70c8c910fd70..fcfd594b1b0124 100644 --- a/independent-projects/arc/runtime/src/main/java/io/quarkus/arc/impl/LifecycleCallbackInvocationContext.java +++ b/independent-projects/arc/runtime/src/main/java/io/quarkus/arc/impl/LifecycleCallbackInvocationContext.java @@ -6,8 +6,8 @@ import java.util.Set; /** - * A simple stateful {@link javax.interceptor.InvocationContext} implementation used for {@link javax.annotation.PostConstruct} - * and {@link javax.annotation.PreDestroy} callbacks. + * A simple stateful {@link jakarta.interceptor.InvocationContext} implementation used for {@link jakarta.annotation.PostConstruct} + * and {@link jakarta.annotation.PreDestroy} callbacks. *

* All lifecycle callback interceptors of a specific chain must be invoked on the same thread. */ diff --git a/independent-projects/arc/runtime/src/main/java/io/quarkus/arc/impl/SuperclassInvocationContext.java b/independent-projects/arc/runtime/src/main/java/io/quarkus/arc/impl/SuperclassInvocationContext.java index 77d1f8c1cd48a2..af27620fe31323 100644 --- a/independent-projects/arc/runtime/src/main/java/io/quarkus/arc/impl/SuperclassInvocationContext.java +++ b/independent-projects/arc/runtime/src/main/java/io/quarkus/arc/impl/SuperclassInvocationContext.java @@ -7,7 +7,7 @@ import jakarta.interceptor.InvocationContext; /** - * A special {@link javax.interceptor.InvocationContext} that is used if multiple interceptor methods are declared in a + * A special {@link jakarta.interceptor.InvocationContext} that is used if multiple interceptor methods are declared in a * hierarchy of an interceptor class. *

* The interceptor methods defined by the superclasses are invoked before the interceptor method defined by the interceptor diff --git a/independent-projects/arc/runtime/src/main/java/io/quarkus/arc/impl/TargetAroundInvokeInvocationContext.java b/independent-projects/arc/runtime/src/main/java/io/quarkus/arc/impl/TargetAroundInvokeInvocationContext.java index 782f1768b8dfe4..7647744e50a253 100644 --- a/independent-projects/arc/runtime/src/main/java/io/quarkus/arc/impl/TargetAroundInvokeInvocationContext.java +++ b/independent-projects/arc/runtime/src/main/java/io/quarkus/arc/impl/TargetAroundInvokeInvocationContext.java @@ -6,7 +6,7 @@ import jakarta.interceptor.InvocationContext; /** - * A special {@link javax.interceptor.InvocationContext} that is used for around invoke methods declared in a hierarchy of a + * A special {@link jakarta.interceptor.InvocationContext} that is used for around invoke methods declared in a hierarchy of a * target class. *

* The interceptor methods defined by the superclasses are invoked before the interceptor method defined by the interceptor