You are viewing a plain text version of this content. The canonical link for it is here.
Posted to scm@geronimo.apache.org by st...@apache.org on 2017/06/17 16:37:50 UTC

svn commit: r1799015 - in /geronimo/specs/trunk/geronimo-jcdi_2.0_spec/src/main/java/javax/enterprise/inject/spi: BeanManager.java BeforeBeanDiscovery.java configurator/AnnotatedTypeConfigurator.java configurator/BeanConfigurator.java

Author: struberg
Date: Sat Jun 17 16:37:50 2017
New Revision: 1799015

URL: http://svn.apache.org/viewvc?rev=1799015&view=rev
Log:
GERONIMO-6553 minor doc tweaks

Modified:
    geronimo/specs/trunk/geronimo-jcdi_2.0_spec/src/main/java/javax/enterprise/inject/spi/BeanManager.java
    geronimo/specs/trunk/geronimo-jcdi_2.0_spec/src/main/java/javax/enterprise/inject/spi/BeforeBeanDiscovery.java
    geronimo/specs/trunk/geronimo-jcdi_2.0_spec/src/main/java/javax/enterprise/inject/spi/configurator/AnnotatedTypeConfigurator.java
    geronimo/specs/trunk/geronimo-jcdi_2.0_spec/src/main/java/javax/enterprise/inject/spi/configurator/BeanConfigurator.java

Modified: geronimo/specs/trunk/geronimo-jcdi_2.0_spec/src/main/java/javax/enterprise/inject/spi/BeanManager.java
URL: http://svn.apache.org/viewvc/geronimo/specs/trunk/geronimo-jcdi_2.0_spec/src/main/java/javax/enterprise/inject/spi/BeanManager.java?rev=1799015&r1=1799014&r2=1799015&view=diff
==============================================================================
--- geronimo/specs/trunk/geronimo-jcdi_2.0_spec/src/main/java/javax/enterprise/inject/spi/BeanManager.java (original)
+++ geronimo/specs/trunk/geronimo-jcdi_2.0_spec/src/main/java/javax/enterprise/inject/spi/BeanManager.java Sat Jun 17 16:37:50 2017
@@ -30,6 +30,7 @@ import javax.enterprise.context.spi.Cont
 import javax.enterprise.context.spi.Contextual;
 import javax.enterprise.context.spi.CreationalContext;
 import javax.enterprise.event.Event;
+import javax.enterprise.event.NotificationOptions;
 import javax.enterprise.inject.AmbiguousResolutionException;
 import javax.enterprise.inject.InjectionException;
 import javax.enterprise.inject.Instance;
@@ -142,13 +143,19 @@ public interface BeanManager
     <T> InterceptionFactory<T> createInterceptionFactory(CreationalContext<T> creationalContext, Class<T> clazz);
 
     /**
-     * Fires an event with given even object and qualifiers.
+     * Fires a synchronous event with given even object and qualifiers.
+     *
+     * For firing asynchronous events you first have to get an {@link Event} via
+     * {@link #getEvent()} and then use the {@link Event#fireAsync(Object)}
+     * or {@link Event#fireAsync(Object, NotificationOptions)} methods.
      * 
      * @param event observer event object
      * @param qualifiers event qualifiers
      * @throws IllegalArgumentException event object contains a {@link TypeVariable}
      * @throws IllegalArgumentException given qualifier annotation is not a qualifier
      * @throws IllegalArgumentException same qualifier is given
+     *
+     * @see #getEvent()
      */
     void fireEvent(Object event, Annotation... qualifiers);
 

Modified: geronimo/specs/trunk/geronimo-jcdi_2.0_spec/src/main/java/javax/enterprise/inject/spi/BeforeBeanDiscovery.java
URL: http://svn.apache.org/viewvc/geronimo/specs/trunk/geronimo-jcdi_2.0_spec/src/main/java/javax/enterprise/inject/spi/BeforeBeanDiscovery.java?rev=1799015&r1=1799014&r2=1799015&view=diff
==============================================================================
--- geronimo/specs/trunk/geronimo-jcdi_2.0_spec/src/main/java/javax/enterprise/inject/spi/BeforeBeanDiscovery.java (original)
+++ geronimo/specs/trunk/geronimo-jcdi_2.0_spec/src/main/java/javax/enterprise/inject/spi/BeforeBeanDiscovery.java Sat Jun 17 16:37:50 2017
@@ -98,6 +98,8 @@ public interface BeforeBeanDiscovery
      * @param id of the annotated type
      * @param <T>
      * @return a new annotated type configurator based on a new bean id and bean class.
+     *
+     * @since 2.0
      */
     <T> AnnotatedTypeConfigurator<T> addAnnotatedType(Class<T> clazz, String id);
 
@@ -105,6 +107,8 @@ public interface BeforeBeanDiscovery
      * @param interceptorBindingType
      * @param <T>
      * @return a new annotated type configurator to create an InterceptorBinding
+     *
+     * @since 2.0
      */
     <T extends Annotation> AnnotatedTypeConfigurator<T> configureInterceptorBinding(Class<T> interceptorBindingType);
 
@@ -112,6 +116,8 @@ public interface BeforeBeanDiscovery
      * @param qualifier
      * @param <T>
      * @return a new annotated type configurator to create a Qualifier
+     *
+     * @since 2.0
      */
     <T extends Annotation> AnnotatedTypeConfigurator<T> configureQualifier(Class<T> qualifier);
 }

Modified: geronimo/specs/trunk/geronimo-jcdi_2.0_spec/src/main/java/javax/enterprise/inject/spi/configurator/AnnotatedTypeConfigurator.java
URL: http://svn.apache.org/viewvc/geronimo/specs/trunk/geronimo-jcdi_2.0_spec/src/main/java/javax/enterprise/inject/spi/configurator/AnnotatedTypeConfigurator.java?rev=1799015&r1=1799014&r2=1799015&view=diff
==============================================================================
--- geronimo/specs/trunk/geronimo-jcdi_2.0_spec/src/main/java/javax/enterprise/inject/spi/configurator/AnnotatedTypeConfigurator.java (original)
+++ geronimo/specs/trunk/geronimo-jcdi_2.0_spec/src/main/java/javax/enterprise/inject/spi/configurator/AnnotatedTypeConfigurator.java Sat Jun 17 16:37:50 2017
@@ -31,7 +31,6 @@ import java.util.stream.Stream;
 public interface AnnotatedTypeConfigurator<T> {
 
     /**
-     *
      * @return the original {@link AnnotatedType}
      */
     AnnotatedType<T> getAnnotated();

Modified: geronimo/specs/trunk/geronimo-jcdi_2.0_spec/src/main/java/javax/enterprise/inject/spi/configurator/BeanConfigurator.java
URL: http://svn.apache.org/viewvc/geronimo/specs/trunk/geronimo-jcdi_2.0_spec/src/main/java/javax/enterprise/inject/spi/configurator/BeanConfigurator.java?rev=1799015&r1=1799014&r2=1799015&view=diff
==============================================================================
--- geronimo/specs/trunk/geronimo-jcdi_2.0_spec/src/main/java/javax/enterprise/inject/spi/configurator/BeanConfigurator.java (original)
+++ geronimo/specs/trunk/geronimo-jcdi_2.0_spec/src/main/java/javax/enterprise/inject/spi/configurator/BeanConfigurator.java Sat Jun 17 16:37:50 2017
@@ -314,5 +314,4 @@ public interface BeanConfigurator<T> {
      * @return self
      */
     BeanConfigurator<T> alternative(boolean value);
-
 }