ArC: improve javadoc for InvocationContext implementations

quarkusio · Apr 19, 2023 · e9a489d · e9a489d
1 parent ef52dab
commit e9a489d
Show file tree

Hide file tree

Showing 5 changed files with 10 additions and 5 deletions.
diff --git a/...projects/arc/runtime/src/main/java/io/quarkus/arc/impl/AroundInvokeInvocationContext.java b/...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.
  * <p>
  * 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/...endent-projects/arc/runtime/src/main/java/io/quarkus/arc/impl/InnerInvocationContext.java b/...endent-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/...cts/arc/runtime/src/main/java/io/quarkus/arc/impl/LifecycleCallbackInvocationContext.java b/...cts/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.
  * <p>
  * All lifecycle callback interceptors of a specific chain must be invoked on the same thread.
  */

diff --git a/...t-projects/arc/runtime/src/main/java/io/quarkus/arc/impl/SuperclassInvocationContext.java b/...t-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.
  * <p>
  * The interceptor methods defined by the superclasses are invoked before the interceptor method defined by the interceptor

diff --git a/...ts/arc/runtime/src/main/java/io/quarkus/arc/impl/TargetAroundInvokeInvocationContext.java b/...ts/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.
  * <p>
  * The interceptor methods defined by the superclasses are invoked before the interceptor method defined by the interceptor