Specify treatment of invalid @enhancement and @registration

jakartaee · Dec 7, 2021 · 7b085ac · 7b085ac
1 parent d0020a4
commit 7b085ac
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 0 deletions.
diff --git a/api/src/main/java/jakarta/enterprise/inject/build/compatible/spi/Enhancement.java b/api/src/main/java/jakarta/enterprise/inject/build/compatible/spi/Enhancement.java
@@ -33,6 +33,9 @@
  * the method is called once for each field that is declared on each <em>discovered type</em>, as defined
  * in {@link jakarta.enterprise.lang.model.declarations.ClassInfo#fields() ClassInfo.fields}.
  * <p>
+ * If the {@code @Enhancement} method doesn't declare any parameter of one of these types,
+ * or if it declares more than one, the container treats it as a deployment problem.
+ * <p>
  * Additionally, methods annotated {@code @Enhancement} may declare parameters of these types:
  * <ul>
  * <li>{@link Messages}</li>

diff --git a/api/src/main/java/jakarta/enterprise/inject/build/compatible/spi/Registration.java b/api/src/main/java/jakarta/enterprise/inject/build/compatible/spi/Registration.java
@@ -34,6 +34,9 @@
  * Note that interceptors are beans, and {@code InterceptorInfo} is a subtype of {@code BeanInfo}, so if the method
  * has a parameter of type {@code BeanInfo}, it will be called for interceptors as well.
  * <p>
+ * If the {@code @Registration} method doesn't declare any parameter of one of these types,
+ * or if it declares more than one, the container treats it as a deployment problem.
+ * <p>
  * Additionally, methods annotated {@code @Registration} may declare parameters of these types:
  * <ul>
  * <li>{@link Messages}</li>