[weld-commits] Weld SVN: r4404 - api/trunk/cdi/src/main/java/javax/enterprise/inject/spi.
Author: gavin.king(a)jboss.com
Date: 2009-10-29 12:27:25 -0400 (Thu, 29 Oct 2009)
New Revision: 4404
Modified:
api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Extension.java
api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/package-info.java
Log:
more on extensions
Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Extension.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Extension.java 2009-10-29
16:11:40 UTC (rev 4403)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Extension.java 2009-10-29
16:27:25 UTC (rev 4404)
@@ -18,24 +18,25 @@
package javax.enterprise.inject.spi;
/**
- * <p>Service interface implemented by service providers that
- * observe container lifecycle events. Service providers must
- * be declared in <tt>META-INF/services</tt></p>
+ * <p>Service interface implemented by extensions. An extension
+ * is a service provider declared in <tt>META-INF/services</tt>.</p>
*
- * <p>The container instantiates a single instance of each
- * service provider at the beginning of the application
- * initialization process and maintains a reference to it until
- * the application shuts down.</p>
- *
- * <p>Service providers may have observer methods, which may
- * observe any event, including any container lifecycle event,
+ * <p>Service providers may have
+ * {@linkplain javax.enterprise.event.Observes observer methods},
+ * which may observe any event, including any
+ * {@linkplain javax.enterprise.inject.spi container lifecycle event},
* and obtain an injected
* {@link javax.enterprise.inject.spi.BeanManager}.<p>
*
+ * <p>The container instantiates a single instance of each
+ * extension at the beginning of the application initialization
+ * process and maintains a reference to it until the application
+ * shuts down. The container delivers event notifications to this
+ * instance by calling its observer methods.</p>
+ *
* <p>Service providers are made available for injection as beans
* with the qualifier {@link javax.context.Default @Default}.</p>
*
- *
* @author Gavin King
* @author Pete Muir
*
Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/package-info.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/package-info.java 2009-10-29
16:11:40 UTC (rev 4403)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/package-info.java 2009-10-29
16:27:25 UTC (rev 4404)
@@ -55,11 +55,11 @@
* <h3>Container lifecycle events</h3>
*
* <p>During the application initialization process, the container fires
- * a series of events, allowing portable extensions to integrate with the
- * container initialization process. Observers of these events must be
- * service providers of the service
- * {@link javax.enterprise.inject.spi.Extension} declared in
- * <tt>META-INF/services</tt>.</p>
+ * a series of {@linkplain javax.enterprise.event events}, allowing
+ * portable extensions to integrate with the container initialization
+ * process. Observer methods of these events must belong to
+ * {@linkplain javax.enterprise.inject.spi.Extension extensions} declared
+ * in <tt>META-INF/services</tt>.</p>
*
* @see javax.enterprise.inject
* @see javax.enterprise.context.spi