* While ApplicationScoped must be associated with the built-in application context required by the specification,
- * third-party extensions are
- * allowed to also associate it with their own context. Behavior described below is only related to the built-in application
- * context.
+ * third-party extensions are allowed to also associate it with their own context. Behavior described below is only related to
+ * the built-in application context.
*
@@ -45,8 +44,7 @@ * *
service() method of any servlet in the web application, during the doFilter() method
- * of any
- * servlet filter and when the container calls any ServletContextListener, HttpSessionListener,
+ * of any servlet filter and when the container calls any ServletContextListener, HttpSessionListener,
* AsyncListener or ServletRequestListener,
* An event with qualifier @Initialized(ApplicationScoped.class) is fired when the application context is
- * initialized
- * and an event with qualifier @Destroyed(ApplicationScoped.class) when the application context is destroyed.
- * The event payload is:
+ * initialized and an event with qualifier @Destroyed(ApplicationScoped.class) when the application context is
+ * destroyed. The event payload is:
*
* While ConversationScoped must be associated with the built-in conversation context required by the
- * specification,
- * third-party extensions are
- * allowed to also associate it with their own context. Behavior described below is only related to the built-in conversation
- * context.
+ * specification, third-party extensions are allowed to also associate it with their own context. Behavior described below is
+ * only related to the built-in conversation context.
*
* The conversation scope is active: @@ -47,9 +45,8 @@ *
* An event with qualifier @Initialized(ConversationScoped.class) is fired when the conversation context is
- * initialized
- * and an event with qualifier @Destroyed(ConversationScoped.class) is fired when the conversation is destroyed.
- * The event payload is:
+ * initialized and an event with qualifier @Destroyed(ConversationScoped.class) is fired when the conversation is
+ * destroyed. The event payload is:
*
web.xml,
* allowing the user alter when the conversation is associated with the servlet request. If this filter is not mapped in any
* web.xml in the application, the conversation associated with a Servlet request is determined at the beginning of
- * the
- * request before calling any service() method of any servlet in the web application, calling the
- * doFilter()
- * method of any servlet filter in the web application and before the container calls any ServletRequestListener or
- * AsyncListener in the web application.service() method of any servlet in the web application, calling the
+ * doFilter() method of any servlet filter in the web application and before the container calls any
+ * ServletRequestListener or AsyncListener in the web application.NavigationHandler) is automatically propagated to the resulting non-faces request, and
- * to any other
- * subsequent request to the same URL. This is accomplished via use of a request parameter named cid containing the
- * unique identifier of the conversation.cid
+ * containing the unique identifier of the conversation.
*
*
*
* When no conversation is propagated to a Servlet request, or if a request parameter named conversationPropagation
- * has
- * the value none the request is associated with a new transient conversation.
+ * has the value none the request is associated with a new transient conversation.
* All long-running conversations are scoped to a particular HTTP servlet session and may not cross session boundaries.
* In the following cases, a propagated long-running conversation cannot be restored and re-associated with the request:
*
- * Every invocation of the {@link Context#get(Contextual, CreationalContext)} operation of the
- * context object for the @Dependent scope returns a new instance of the given bean.
+ * Every invocation of the {@link Context#get(Contextual, CreationalContext)} operation of the context object for the
+ * @Dependent scope returns a new instance of the given bean.
*
- * Every invocation of the {@link Context#get(Contextual)} operation of the context object for the
- * @Dependent scope returns a null value.
+ * Every invocation of the {@link Context#get(Contextual)} operation of the context object for the @Dependent scope
+ * returns a null value.
*
@@ -73,19 +73,17 @@ * *
* Many instances of beans with scope @Dependent belong to some other bean or Java EE component class instance and
- * are
- * called dependent objects.
+ * are called dependent objects.
*
@Dependent injected into a field, bean constructor or initializer method is
- * a
- * dependent object of the bean or Java EE component class instance into which it was injected.@Dependent injected into a producer method is a dependent object of the
* producer method bean instance that is being produced.@Dependent obtained by direct invocation of an
- * {@link Instance} is a dependent object of the instance of {@link Instance}.@Dependent obtained by direct invocation of an {@link Instance} is a
+ * dependent object of the instance of {@link Instance}.diff --git a/api/src/main/java/jakarta/enterprise/context/RequestScoped.java b/api/src/main/java/jakarta/enterprise/context/RequestScoped.java index 0b3aac64..da2b0369 100644 --- a/api/src/main/java/jakarta/enterprise/context/RequestScoped.java +++ b/api/src/main/java/jakarta/enterprise/context/RequestScoped.java @@ -34,9 +34,8 @@ *
*
* While RequestScoped must be associated with the built-in request context required by the specification,
- * third-party extensions are
- * allowed to also associate it with their own context. Behavior described below is only related to the built-in request
- * context.
+ * third-party extensions are allowed to also associate it with their own context. Behavior described below is only related to
+ * the built-in request context.
*
@@ -45,8 +44,8 @@ * *
service() method of any servlet in the web application, during the doFilter() method
- * of any
- * servlet filter and when the container calls any ServletRequestListener or AsyncListener,ServletRequestListener or
+ * AsyncListener,
* service() method, all doFilter() methods, and all
* requestDestroyed() and onComplete() notifications return,@PostConstruct callback completes, if it did not already exist when the
- * @PostConstruct
- * callback occurred.@PostConstruct callback occurred.
*
* An event with qualifier @Initialized(RequestScoped.class) is fired when the request context is initialized and
- * an
- * event
- * with qualifier @Destroyed(RequestScoped.class) when the request context is destroyed. The event payload is:
+ * an event with qualifier @Destroyed(RequestScoped.class) when the request context is destroyed. The event payload
+ * is:
*
* While SessionScoped must be associated with the built-in session context required by the specification,
- * third-party extensions are
- * allowed to also associate it with their own context. Behavior described below is only related to the built-in session
- * context.
+ * third-party extensions are allowed to also associate it with their own context. Behavior described below is only related to
+ * the built-in session context.
*
* The session scope is active: @@ -58,18 +57,14 @@ * *
HttpSessionListeners have been called, orinvalidate() was called, after all filters and ServletRequestListeners have
- * been
- * called.invalidate() was called, after all filters and
+ * ServletRequestListeners have been called.
* An event with qualifier @Initialized(SessionScoped.class) is fired when the session context is initialized and
- * an
- * event
- * with qualifier @Destroyed(SessionScoped.class) when the session context is destroyed. The event payload is
- * the HttpSession
+ * an event with qualifier @Destroyed(SessionScoped.class) when the session context is destroyed. The event payload
+ * is the HttpSession
*
*
* CDI Lite implementations are not required to provide support for the session scope. diff --git a/api/src/main/java/jakarta/enterprise/event/TransactionPhase.java b/api/src/main/java/jakarta/enterprise/event/TransactionPhase.java index da993ee5..d68f09b4 100644 --- a/api/src/main/java/jakarta/enterprise/event/TransactionPhase.java +++ b/api/src/main/java/jakarta/enterprise/event/TransactionPhase.java @@ -77,9 +77,9 @@ public enum TransactionPhase { *
** Transactional observer will be notified will also get invoked if there is no transaction in progress, or the transaction - * is in progress, - * but {@code jakarta.transaction.Synchronization} callback cannot be registered due to the transaction being already - * marked for rollback or in state where {@code jakarta.transaction.Synchronization} callbacks cannot be registered. + * is in progress, but {@code jakarta.transaction.Synchronization} callback cannot be registered due to the transaction + * being already marked for rollback or in state where {@code jakarta.transaction.Synchronization} callbacks cannot be + * registered. *
*/ AFTER_FAILURE, diff --git a/api/src/main/java/jakarta/enterprise/inject/Alternative.java b/api/src/main/java/jakarta/enterprise/inject/Alternative.java index 394d80aa..ac86e9b1 100644 --- a/api/src/main/java/jakarta/enterprise/inject/Alternative.java +++ b/api/src/main/java/jakarta/enterprise/inject/Alternative.java @@ -47,8 +47,8 @@ *
* By default, a bean archive has no selected alternatives. An alternative must be explicitly declared using the
* <alternatives> element of the beans.xml file of the bean archive. The
- * <alternatives>
- * element contains a list of bean classes and stereotypes. An alternative is selected for the bean archive if either:
+ * <alternatives> element contains a list of bean classes and stereotypes. An alternative is selected for the
+ * bean archive if either:
*
- * Or, the {@link Any @Any} qualifier may be used, allowing the application to specify qualifiers - * dynamically: + * Or, the {@link Any @Any} qualifier may be used, allowing the application to specify qualifiers dynamically: *
* *@@ -82,10 +81,8 @@ * ** The inherited {@link jakarta.inject.Provider#get()} method returns a contextual references for the unique bean that matches - * the - * required type and required qualifiers and is eligible for injection into the class into which the parent - *
* @@ -126,8 +123,7 @@ public interface InstanceInstance- * was injected, or throws an {@link UnsatisfiedResolutionException} or + * the required type and required qualifiers and is eligible for injection into the class into which the parent + *Instancewas injected, or throws an {@link UnsatisfiedResolutionException} or * {@link AmbiguousResolutionException}. *extends Iterable , Provider { * @param qualifiers the additional required qualifiers * @return the child Instance* @throws IllegalArgumentException if passed two instances of the same non repeating qualifier type, or an instance of an - * annotation that - * is not a qualifier type + * annotation that is not a qualifier type * @throws IllegalStateException if the container is already shutdown */ Instanceselect(Annotation... qualifiers); @@ -142,8 +138,7 @@ public interface Instance extends Iterable , Provider { * @param qualifiers the additional required qualifiers * @return the child Instance* @throws IllegalArgumentException if passed two instances of the same non repeating qualifier type, or an instance of an - * annotation that - * is not a qualifier type + * annotation that is not a qualifier type * @throws IllegalStateException if the container is already shutdown */ Instance select(Class subtype, Annotation... qualifiers); @@ -158,8 +153,7 @@ public interface Instanceextends Iterable , Provider { * @param qualifiers the additional required qualifiers * @return the child Instance* @throws IllegalArgumentException if passed two instances of the same non repeating qualifier type, or an instance of an - * annotation that - * is not a qualifier type + * annotation that is not a qualifier type * @throws IllegalStateException if the container is already shutdown */ Instance select(TypeLiteral subtype, Annotation... qualifiers); @@ -195,16 +189,15 @@ default Streamstream() { * * * @return trueif there is more than one bean that matches the required type and qualifiers and is eligible - * for - * injection into the class into which the parentInstancewas injected, orfalse+ * for injection into the class into which the parentInstancewas injected, orfalse* otherwise. */ boolean isAmbiguous(); /** *- * Determines if there is exactly one bean that matches the required type and qualifiers and is eligible for injection - * into the class into which the parent
* * @since 2.0 @@ -236,8 +229,8 @@ default boolean isResolvable() { void destroy(T instance); /** - * Obtains an initialized contextual reference handle for a bean that has the required type and qualifiers and is - * eligible for injection. Throws exceptions if there is no such bean or more than one. + * Obtains an initialized contextual reference handle for a bean that has the required type and qualifiers and is eligible + * for injection. Throws exceptions if there is no such bean or more than one. * *Instancewas injected. + * Determines if there is exactly one bean that matches the required type and qualifiers and is eligible for injection into + * the class into which the parentInstancewas injected. ** The contextual reference is obtained lazily, i.e. when first needed. @@ -251,8 +244,7 @@ default boolean isResolvable() { /** * Allows iterating over contextual reference handles for all beans that have the required type and required qualifiers and - * are eligible - * for injection. + * are eligible for injection. * *
* Note that the returned {@link Iterable} is stateless. Therefore, each {@link Iterable#iterator()} produces a new set of @@ -275,8 +267,8 @@ default Stream> handlesStream() { /** * This interface represents a contextual reference handle. *
- * Allows to inspect the metadata of the relevant bean before resolving its contextual reference and also to destroy - * the underlying contextual instance. + * Allows to inspect the metadata of the relevant bean before resolving its contextual reference and also to destroy the + * underlying contextual instance. *
* * @author Matej Novotny @@ -290,8 +282,8 @@ interface Handleextends AutoCloseable { * @return the contextual reference * @see Instance#get() * @throws IllegalStateException If the producing {@link Instance} does not exist - * @throws IllegalStateException If invoked on {@link Handle} that previously successfully destroyed its - * underlying contextual reference + * @throws IllegalStateException If invoked on {@link Handle} that previously successfully destroyed its underlying + * contextual reference */ T get(); diff --git a/api/src/main/java/jakarta/enterprise/inject/Specializes.java b/api/src/main/java/jakarta/enterprise/inject/Specializes.java index 60230e89..08784d89 100644 --- a/api/src/main/java/jakarta/enterprise/inject/Specializes.java +++ b/api/src/main/java/jakarta/enterprise/inject/Specializes.java @@ -43,22 +43,18 @@ * * * If the second bean has a name, the bean may not declare a name using {@link jakarta.inject.Named @Named}. Furthermore, - * the - * bean must have all the bean types of the second bean. + * the bean must have all the bean types of the second bean. *
* **
* *- If a bean class of a managed bean is annotated
+ * the bean class of a second managed bean. Then the first managed bean directly specializes the second managed bean. * *@Specializes, then the bean class must directly extend - * the - * bean class of a second managed bean. Then the first managed bean directly specializes the second managed bean.- If a bean class of a session bean is annotated
+ * the bean class of a second session bean. Then the first session bean directly specializes the second session bean. * *@Specializes, then the bean class must directly extend - * the - * bean class of a second session bean. Then the first session bean directly specializes the second session bean.- If a producer method is annotated
+ * another producer method. Then the first producer method directly specializes the second producer method. *@Specializes, then it must be non-static and directly override - * another - * producer method. Then the first producer method directly specializes the second producer method.diff --git a/api/src/main/java/jakarta/enterprise/inject/Stereotype.java b/api/src/main/java/jakarta/enterprise/inject/Stereotype.java index 4c57f6c3..b38b77c0 100644 --- a/api/src/main/java/jakarta/enterprise/inject/Stereotype.java +++ b/api/src/main/java/jakarta/enterprise/inject/Stereotype.java @@ -90,8 +90,7 @@ * *
* A stereotype may declare an empty {@link jakarta.inject.Named @Named} annotation, which specifies that every bean with - * the - * stereotype has a defaulted name when a name is not explicitly specified by the bean. + * the stereotype has a defaulted name when a name is not explicitly specified by the bean. *
* *@@ -107,8 +106,8 @@ ** *- * A stereotype may declare an {@link Alternative @Alternative} annotation, which specifies that - * every bean with the stereotype is an alternative. + * A stereotype may declare an {@link Alternative @Alternative} annotation, which specifies that every bean with the + * stereotype is an alternative. *
* *@@ -121,8 +120,8 @@ ** *- * A stereotype may declare a {@link jakarta.annotation.Priority @Priority} annotation, which specifies that - * every bean with the stereotype is enabled and has given priority. + * A stereotype may declare a {@link jakarta.annotation.Priority @Priority} annotation, which specifies that every bean + * with the stereotype is enabled and has given priority. *
* *diff --git a/api/src/main/java/jakarta/enterprise/inject/spi/AfterTypeDiscovery.java b/api/src/main/java/jakarta/enterprise/inject/spi/AfterTypeDiscovery.java index a74cae6c..580d69cd 100644 --- a/api/src/main/java/jakarta/enterprise/inject/spi/AfterTypeDiscovery.java +++ b/api/src/main/java/jakarta/enterprise/inject/spi/AfterTypeDiscovery.java @@ -65,15 +65,13 @@ public interface AfterTypeDiscovery { /** *- * Adds a given {@link AnnotatedType} to the set of types which will be scanned during bean - * discovery. + * Adds a given {@link AnnotatedType} to the set of types which will be scanned during bean discovery. *
* ** Thanks to the id parameter, this method allows multiple annotated types, based on the same underlying type, to be - * defined. {@link AnnotatedType}s - * discovered by the container use the fully qualified class name of {@link AnnotatedType#getJavaClass()} to identify the - * type. + * defined. {@link AnnotatedType}s discovered by the container use the fully qualified class name of + * {@link AnnotatedType#getJavaClass()} to identify the type. *
* *@@ -89,16 +87,15 @@ public interface AfterTypeDiscovery { /** *
- * Obtains a new {@link AnnotatedTypeConfigurator} to configure a new {@link AnnotatedType} and - * add it to the set of types which will be scanned during bean discovery at the end of the observer invocation. - * Calling this method multiple times will return a new AnnotatedTypeConfigurator. + * Obtains a new {@link AnnotatedTypeConfigurator} to configure a new {@link AnnotatedType} and add it to the set of types + * which will be scanned during bean discovery at the end of the observer invocation. Calling this method multiple times + * will return a new AnnotatedTypeConfigurator. *
* ** Thanks to the id parameter, this method allows multiple annotated types, based on the same underlying type, to be - * defined. {@link AnnotatedType}s - * discovered by the container use the fully qualified class name of {@link AnnotatedType#getJavaClass()} to identify the - * type. + * defined. {@link AnnotatedType}s discovered by the container use the fully qualified class name of + * {@link AnnotatedType#getJavaClass()} to identify the type. *
* *diff --git a/api/src/main/java/jakarta/enterprise/inject/spi/BeanContainer.java b/api/src/main/java/jakarta/enterprise/inject/spi/BeanContainer.java index 7ce21f84..d3457279 100644 --- a/api/src/main/java/jakarta/enterprise/inject/spi/BeanContainer.java +++ b/api/src/main/java/jakarta/enterprise/inject/spi/BeanContainer.java @@ -238,8 +238,7 @@ public interface BeanContainer { * Obtains an {@link Instance} object to access to beans instances. *
* The returned
Instanceobject can only access instances of beans that are available for injection in the - * module - * or library containing the class into which theBeanManager/BeanContainerwas injected + * module or library containing the class into which theBeanManager/BeanContainerwas injected * or, in the Jakarta EE environment, the Jakarta EE component from whose JNDI environment namespace the *BeanContainerwas obtained, according to the rules of typesafe resolution. *diff --git a/api/src/main/java/jakarta/enterprise/inject/spi/BeanManager.java b/api/src/main/java/jakarta/enterprise/inject/spi/BeanManager.java index c4e2aff5..23876399 100644 --- a/api/src/main/java/jakarta/enterprise/inject/spi/BeanManager.java +++ b/api/src/main/java/jakarta/enterprise/inject/spi/BeanManager.java @@ -38,8 +38,8 @@ *
* *- * In CDI Lite environment, applications may obtain a {@code BeanManager}, but invoking methods that are not inherited - * from {@link BeanContainer} results in non-portable behavior. + * In CDI Lite environment, applications may obtain a {@code BeanManager}, but invoking methods that are not inherited from + * {@link BeanContainer} results in non-portable behavior. *
* *@@ -53,8 +53,7 @@ * *
* Java EE components may obtain an instance of
* *BeanManagerfrom {@linkplain javax.naming JNDI} by looking up the - * name - * {@code java:comp/BeanManager}. + * name {@code java:comp/BeanManager}. *@@ -236,10 +235,8 @@ public interface BeanManager extends BeanContainer { /** * Returns a wrapper {@link jakarta.el.ExpressionFactory} that delegates {@link jakarta.el.MethodExpression} and * {@link jakarta.el.ValueExpression} creation to the given {@link jakarta.el.ExpressionFactory}. When a Unified EL - * expression - * is evaluated using a {@link jakarta.el.MethodExpression} or {@link jakarta.el.ValueExpression} returned by the wrapper - * {@link jakarta.el.ExpressionFactory}, the container handles destruction of objects with scope - * {@link Dependent}. + * expression is evaluated using a {@link jakarta.el.MethodExpression} or {@link jakarta.el.ValueExpression} returned by the + * wrapper {@link jakarta.el.ExpressionFactory}, the container handles destruction of objects with scope {@link Dependent}. * * @deprecated use {@code ELAwareBeanManager}, this method will be removed in CDI 5.0 * @param expressionFactory the {@link jakarta.el.ExpressionFactory} to wrap @@ -343,8 +340,7 @@ public interface BeanManager extends BeanContainer { * The {@link InjectionTarget} creates and destroys instances of the bean, performs dependency injection and lifecycle * callbacks, and determines the return value of {@link Bean#getInjectionPoints()}. The {@link InjectionTarget} is obtained * from the {@link InjectionTargetFactory}. {@link #getInjectionTargetFactory(AnnotatedType)} allows use of a container - * created - * {@link InjectionTarget}. + * created {@link InjectionTarget}. *
* * @paramthe type diff --git a/api/src/main/java/jakarta/enterprise/inject/spi/BeforeBeanDiscovery.java b/api/src/main/java/jakarta/enterprise/inject/spi/BeforeBeanDiscovery.java index 13b134a5..127f936c 100644 --- a/api/src/main/java/jakarta/enterprise/inject/spi/BeforeBeanDiscovery.java +++ b/api/src/main/java/jakarta/enterprise/inject/spi/BeforeBeanDiscovery.java @@ -142,15 +142,13 @@ public interface BeforeBeanDiscovery { /** * - * Adds a given {@link AnnotatedType} to the set of types which will be scanned during bean - * discovery. + * Adds a given {@link AnnotatedType} to the set of types which will be scanned during bean discovery. *
* ** Thanks to the id parameter, this method allows multiple annotated types, based on the same underlying type, to be - * defined. {@link AnnotatedType}s - * discovered by the container use the fully qualified class name of {@link AnnotatedType#getJavaClass()} to identify the - * type. + * defined. {@link AnnotatedType}s discovered by the container use the fully qualified class name of + * {@link AnnotatedType#getJavaClass()} to identify the type. *
* *diff --git a/api/src/main/java/jakarta/enterprise/inject/spi/InjectionPoint.java b/api/src/main/java/jakarta/enterprise/inject/spi/InjectionPoint.java index 3c27246d..8df7e78e 100644 --- a/api/src/main/java/jakarta/enterprise/inject/spi/InjectionPoint.java +++ b/api/src/main/java/jakarta/enterprise/inject/spi/InjectionPoint.java @@ -31,8 +31,7 @@ *
* Provides access to metadata about an injection point. May represent an {@linkplain jakarta.inject.Inject injected field} or a * parameter of a {@linkplain jakarta.inject.Inject bean constructor}, {@linkplain jakarta.inject.Inject initializer method}, - * {@linkplain Produces producer method}, {@linkplain Disposes disposer method} - * or {@linkplain Observes observer method}. + * {@linkplain Produces producer method}, {@linkplain Disposes disposer method} or {@linkplain Observes observer method}. *
* *@@ -42,15 +41,13 @@ *
* *- * Occasionally, a bean with scope {@link Dependent @Dependent} needs to access metadata relating - * to the object to which it belongs. The bean may inject an {@code InjectionPoint} representing the injection point into which - * the bean was injected. + * Occasionally, a bean with scope {@link Dependent @Dependent} needs to access metadata relating to the object to which it + * belongs. The bean may inject an {@code InjectionPoint} representing the injection point into which the bean was injected. *
* ** For example, the following producer method creates injectable
* *Loggers. The log category of a - *Logger- * depends upon the class of the object into which it is injected. + *Loggerdepends upon the class of the object into which it is injected. *@@ -61,8 +58,7 @@ ** *- * Only {@linkplain Dependent dependent} objects, may obtain information about the injection point to - * which they belong. + * Only {@linkplain Dependent dependent} objects, may obtain information about the injection point to which they belong. *
* * @author Gavin King diff --git a/api/src/main/java/jakarta/enterprise/inject/spi/InjectionTarget.java b/api/src/main/java/jakarta/enterprise/inject/spi/InjectionTarget.java index a371c9f9..6e14e148 100644 --- a/api/src/main/java/jakarta/enterprise/inject/spi/InjectionTarget.java +++ b/api/src/main/java/jakarta/enterprise/inject/spi/InjectionTarget.java @@ -50,8 +50,7 @@ public interface InjectionTargetextends Producer { /** * * Calls the {@link jakarta.annotation.PostConstruct} callback, if it exists, according to the semantics required by the - * Java - * EE platform specification. + * Java EE platform specification. *
* * @param instance The instance on which to invoke the {@link jakarta.annotation.PostConstruct} method @@ -61,8 +60,7 @@ public interface InjectionTargetextends Producer { /** * * Calls the {@link jakarta.annotation.PreDestroy} callback, if it exists, according to the semantics required by the Java - * EE - * platform specification. + * EE platform specification. *
* * @param instance The instance on which to invoke the {@link jakarta.annotation.PreDestroy} method diff --git a/api/src/main/java/jakarta/enterprise/inject/spi/InjectionTargetFactory.java b/api/src/main/java/jakarta/enterprise/inject/spi/InjectionTargetFactory.java index ffb3dd77..2dafb8dd 100644 --- a/api/src/main/java/jakarta/enterprise/inject/spi/InjectionTargetFactory.java +++ b/api/src/main/java/jakarta/enterprise/inject/spi/InjectionTargetFactory.java @@ -25,8 +25,8 @@ * ** The {@link InjectionTargetFactory} obtained from {@link BeanManager#getInjectionTargetFactory(AnnotatedType)} is capable of - * providing - * container created injection targets. This factory can be wrapped to add behavior to container created injection targets. + * providing container created injection targets. This factory can be wrapped to add behavior to container created injection + * targets. *
* *diff --git a/api/src/main/java/jakarta/enterprise/inject/spi/ObserverMethod.java b/api/src/main/java/jakarta/enterprise/inject/spi/ObserverMethod.java index d69e1861..b1b3dcf4 100644 --- a/api/src/main/java/jakarta/enterprise/inject/spi/ObserverMethod.java +++ b/api/src/main/java/jakarta/enterprise/inject/spi/ObserverMethod.java @@ -148,8 +148,7 @@ public default void notify(EventContext
* * @return returnseventContext) { * trueif the method is an asynchronous observer method (i.e. defined with - * {@link ObservesAsync}), - * otherwise returnsfalse+ * {@link ObservesAsync}), otherwise returnsfalse* */ public default boolean isAsync() { diff --git a/api/src/main/java/jakarta/enterprise/inject/spi/ProcessInjectionPoint.java b/api/src/main/java/jakarta/enterprise/inject/spi/ProcessInjectionPoint.java index 1da627ad..7ef954a4 100644 --- a/api/src/main/java/jakarta/enterprise/inject/spi/ProcessInjectionPoint.java +++ b/api/src/main/java/jakarta/enterprise/inject/spi/ProcessInjectionPoint.java @@ -30,8 +30,7 @@ * {@link #setInjectionPoint(InjectionPoint)} or {@link #configureInjectionPoint()}. * If both methods are called within an observer notification an {@link IllegalStateException} is thrown. * The container must use the final value of this property, after all observers have been called, he container must use the - * final - * value of this property, after all observers have been called, whenever it performs injection upon the injection point. + * final value of this property, after all observers have been called, whenever it performs injection upon the injection point. * ** If any observer method of a {@code ProcessInjectionPoint} event throws an exception, the exception is treated as a definition diff --git a/api/src/main/java/jakarta/enterprise/inject/spi/ProcessObserverMethod.java b/api/src/main/java/jakarta/enterprise/inject/spi/ProcessObserverMethod.java index bc49c710..eee45863 100644 --- a/api/src/main/java/jakarta/enterprise/inject/spi/ProcessObserverMethod.java +++ b/api/src/main/java/jakarta/enterprise/inject/spi/ProcessObserverMethod.java @@ -33,8 +33,7 @@ * {@link #setObserverMethod(ObserverMethod)} or {@link #configureObserverMethod()}. * If both methods are called within an observer notification an {@link IllegalStateException} is thrown. * The container must use the final value of this property, after all observers have been called, he container must use the - * final - * value of this property, after all observers have been called, whenever it performs observer resolution. + * final value of this property, after all observers have been called, whenever it performs observer resolution. *
** If any observer method of a {@code ProcessObserverMethod} event throws an exception, the exception is treated as a definition diff --git a/api/src/main/java/jakarta/enterprise/inject/spi/ProcessSyntheticObserverMethod.java b/api/src/main/java/jakarta/enterprise/inject/spi/ProcessSyntheticObserverMethod.java index 0fd4bb6b..d64f48ac 100644 --- a/api/src/main/java/jakarta/enterprise/inject/spi/ProcessSyntheticObserverMethod.java +++ b/api/src/main/java/jakarta/enterprise/inject/spi/ProcessSyntheticObserverMethod.java @@ -24,8 +24,7 @@ *
** If any observer method of a {@code ProcessSyntheticObserverMethod} event throws an exception, the exception is treated as a - * definition - * error by the container. + * definition error by the container. *
* *diff --git a/api/src/main/java/jakarta/enterprise/inject/spi/Producer.java b/api/src/main/java/jakarta/enterprise/inject/spi/Producer.java index 0b2a3b73..63751556 100644 --- a/api/src/main/java/jakarta/enterprise/inject/spi/Producer.java +++ b/api/src/main/java/jakarta/enterprise/inject/spi/Producer.java @@ -39,10 +39,8 @@ public interface Producer
*{ * * If the {@code Producer} represents a class, this will invoke the constructor annotated {@link jakarta.inject.Inject} if - * it - * exists, or the constructor with no parameters otherwise. If the class has interceptors,
*produce()is - * responsible - * for building the interceptors and decorators of the instance. + * it exists, or the constructor with no parameters otherwise. If the class has interceptors,produce()is + * responsible for building the interceptors and decorators of the instance. ** If the {@code Producer} represents a producer field or method, this will invoke the producer method on, or access the diff --git a/api/src/main/java/jakarta/enterprise/inject/spi/WithAnnotations.java b/api/src/main/java/jakarta/enterprise/inject/spi/WithAnnotations.java index b6b7460d..f07754e5 100644 --- a/api/src/main/java/jakarta/enterprise/inject/spi/WithAnnotations.java +++ b/api/src/main/java/jakarta/enterprise/inject/spi/WithAnnotations.java @@ -33,10 +33,8 @@ * If the {@link WithAnnotations} annotation is applied to a portable extension observer method, then only * {@link ProcessAnnotatedType} events for types which have at least one of the annotations specified are observed. The * annotation can appear on the annotated type, or on any member, or any parameter of any member of the annotated type, as - * defined - * in section 11.4 Alternative metadata - * sources. - * The annotation may be applied as a meta-annotation on any annotation considered. + * defined in section 11.4 Alternative + * metadata sources. The annotation may be applied as a meta-annotation on any annotation considered. * *
* CDI Lite implementations are not required to provide support for Portable Extensions. diff --git a/api/src/main/java/jakarta/enterprise/util/Nonbinding.java b/api/src/main/java/jakarta/enterprise/util/Nonbinding.java index 56cb5445..f75d70f4 100644 --- a/api/src/main/java/jakarta/enterprise/util/Nonbinding.java +++ b/api/src/main/java/jakarta/enterprise/util/Nonbinding.java @@ -26,8 +26,7 @@ *
* Excludes a member of an annotation type (such as a {@linkplain jakarta.inject.Qualifier qualifier type} or * {@linkplain jakarta.interceptor.InterceptorBinding interceptor binding type}) from consideration when the container compares - * two annotation - * instances. + * two annotation instances. *
* *diff --git a/el/src/main/java/jakarta/enterprise/inject/spi/el/ELAwareBeanManager.java b/el/src/main/java/jakarta/enterprise/inject/spi/el/ELAwareBeanManager.java index e7ba393b..4754c8d6 100644 --- a/el/src/main/java/jakarta/enterprise/inject/spi/el/ELAwareBeanManager.java +++ b/el/src/main/java/jakarta/enterprise/inject/spi/el/ELAwareBeanManager.java @@ -22,10 +22,8 @@ public interface ELAwareBeanManager extends BeanManager { /** * Returns a wrapper {@link jakarta.el.ExpressionFactory} that delegates {@link jakarta.el.MethodExpression} and * {@link jakarta.el.ValueExpression} creation to the given {@link jakarta.el.ExpressionFactory}. When a Unified EL - * expression - * is evaluated using a {@link jakarta.el.MethodExpression} or {@link jakarta.el.ValueExpression} returned by the wrapper - * {@link jakarta.el.ExpressionFactory}, the container handles destruction of objects with scope - * {@link Dependent}. + * expression is evaluated using a {@link jakarta.el.MethodExpression} or {@link jakarta.el.ValueExpression} returned by the + * wrapper {@link jakarta.el.ExpressionFactory}, the container handles destruction of objects with scope {@link Dependent}. * * @param expressionFactory the {@link jakarta.el.ExpressionFactory} to wrap * @return the wrapped {@link jakarta.el.ExpressionFactory}