add SyntheticBeanBuilder.withInjectionPoint()

jakartaee · Jan 14, 2025 · 039589f · 039589f
1 parent c057683
commit 039589f
Show file tree

Hide file tree

Showing 3 changed files with 55 additions and 3 deletions.
diff --git a/api/src/main/java/jakarta/enterprise/inject/build/compatible/spi/SyntheticBeanBuilder.java b/api/src/main/java/jakarta/enterprise/inject/build/compatible/spi/SyntheticBeanBuilder.java
@@ -21,7 +21,7 @@
  * Instances are not reusable. For each synthetic bean, new instance
  * must be created by {@link SyntheticComponents#addBean(Class)}.
  *
- * @param <T> the bean class of this synthetic bean
+ * @param <T> the implementation class of this synthetic bean
  * @since 4.0
  */
 public interface SyntheticBeanBuilder<T> {
@@ -435,6 +435,58 @@ public interface SyntheticBeanBuilder<T> {
      */
     SyntheticBeanBuilder<T> withParam(String key, InvokerInfo[] value);
 
+    /**
+     * Declares that the creation or destruction function for this synthetic bean will potentially
+     * look up a bean of given {@code type} with given {@code qualifiers}.
+     * <p>
+     * The registered injection points will be validated.
+     *
+     * @param type the type of the bean that may be looked up in the creation/destruction function
+     * @param qualifiers the qualifiers of the bean that may be looked up in the creation/destruction function
+     * @return this {@code SyntheticBeanBuilder}
+     * @since 5.0
+     */
+    SyntheticBeanBuilder<T> withInjectionPoint(Class<?> type, Annotation... qualifiers);
+
+    /**
+     * Declares that the creation or destruction function for this synthetic bean will potentially
+     * look up a bean of given {@code type} with given {@code qualifiers}.
+     * <p>
+     * The registered injection points will be validated.
+     *
+     * @param type the type of the bean that may be looked up in the creation/destruction function
+     * @param qualifiers the qualifiers of the bean that may be looked up in the creation/destruction function
+     * @return this {@code SyntheticBeanBuilder}
+     * @since 5.0
+     */
+    SyntheticBeanBuilder<T> withInjectionPoint(Class<?> type, AnnotationInfo... qualifiers);
+
+    /**
+     * Declares that the creation or destruction function for this synthetic bean will potentially
+     * look up a bean of given {@code type} with given {@code qualifiers}.
+     * <p>
+     * The registered injection points will be validated.
+     *
+     * @param type the type of the bean that may be looked up in the creation/destruction function
+     * @param qualifiers the qualifiers of the bean that may be looked up in the creation/destruction function
+     * @return this {@code SyntheticBeanBuilder}
+     * @since 5.0
+     */
+    SyntheticBeanBuilder<T> withInjectionPoint(Type type, Annotation... qualifiers);
+
+    /**
+     * Declares that the creation or destruction function for this synthetic bean will potentially
+     * look up a bean of given {@code type} with given {@code qualifiers}.
+     * <p>
+     * The registered injection points will be validated.
+     *
+     * @param type the type of the bean that may be looked up in the creation/destruction function
+     * @param qualifiers the qualifiers of the bean that may be looked up in the creation/destruction function
+     * @return this {@code SyntheticBeanBuilder}
+     * @since 5.0
+     */
+    SyntheticBeanBuilder<T> withInjectionPoint(Type type, AnnotationInfo... qualifiers);
+
     /**
      * Sets the class of the synthetic bean {@linkplain SyntheticBeanCreator creation} function.
      * CDI container will create an instance of the creation function every time when it needs

diff --git a/api/src/main/java/jakarta/enterprise/inject/build/compatible/spi/SyntheticBeanCreator.java b/api/src/main/java/jakarta/enterprise/inject/build/compatible/spi/SyntheticBeanCreator.java
@@ -18,7 +18,7 @@
  * to obtain an instance of the synthetic bean. Implementations must be {@code public}
  * classes with a {@code public} zero-parameter constructor; they must not be beans.
  *
- * @param <T> the bean class of the synthetic bean
+ * @param <T> the implementation class of the synthetic bean
  * @since 4.0
  */
 public interface SyntheticBeanCreator<T> {

diff --git a/api/src/main/java/jakarta/enterprise/inject/build/compatible/spi/SyntheticBeanDisposer.java b/api/src/main/java/jakarta/enterprise/inject/build/compatible/spi/SyntheticBeanDisposer.java
@@ -18,7 +18,7 @@
  * to destroy an instance of the synthetic bean. Implementations must be {@code public}
  * classes with a {@code public} zero-parameter constructor; they must not be beans.
  *
- * @param <T> the bean class of the synthetic bean
+ * @param <T> the implementation class of the synthetic bean
  * @since 4.0
  */
 public interface SyntheticBeanDisposer<T> {