[weld-commits] Weld SVN: r4310 - api/trunk/cdi/src/main/java/javax/enterprise/context.
Author: gavin.king(a)jboss.com
Date: 2009-10-25 14:01:36 -0400 (Sun, 25 Oct 2009)
New Revision: 4310
Modified:
api/trunk/cdi/src/main/java/javax/enterprise/context/package-info.java
Log:
fix injected ref validity
Modified: api/trunk/cdi/src/main/java/javax/enterprise/context/package-info.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/context/package-info.java 2009-10-25
18:01:10 UTC (rev 4309)
+++ api/trunk/cdi/src/main/java/javax/enterprise/context/package-info.java 2009-10-25
18:01:36 UTC (rev 4310)
@@ -1,10 +1,13 @@
/**
* <p>Annotations and interfaces relating to scopes and contexts.</p>
*
+ * <p>A scope type is a Java annotation annotated
+ * {@link javax.inject.Scope @Scope}.</p>
+ *
* <p>Associated with every scope type is a context object. The
* context object determines the lifecycle and visibility of
- * instances of all beans with that scope. In particular, the
- * context object defines:</p>
+ * instances of all {@linkplain javax.enterprise.inject beans} with
+ * that scope. In particular, the context object defines:</p>
*
* <ul>
* <li>When a new instance of any bean with that scope is created</li>
@@ -88,14 +91,14 @@
* {@link javax.enterprise.context.Dependent @Dependent} and
* {@link javax.inject.Singleton @Singleton} pseudo-scopes.</p>
*
- * <h3>Contextual reference validity</h3>
+ * <h3>Contextual and injected reference validity</h3>
*
- * <p>A reference to a bean obtained from the container via injection
- * or programmatic lookup is called a contextual reference. A contextual
- * reference for a bean with a normal scope refers to the current instance
- * of the bean. Contextual reference of a bean are valid only for a
- * certain period of time. The application should not invoke a method of
- * an invalid reference.</p>
+ * <p>A reference to a bean obtained from the container via {@linkplain
+ * javax.enterprise.inject.Instance programmatic lookup} is called a
+ * contextual reference. A contextual reference for a bean with a normal
+ * scope refers to the current instance of the bean. A contextual
+ * reference for a bean are valid only for a certain period of time. The
+ * application should not invoke a method of an invalid reference.</p>
*
* <p>The validity of a contextual reference depends upon whether the
* scope of the injected bean is a normal scope or a pseudo-scope:</p>
@@ -114,5 +117,21 @@
* that has already been destroyed, the behavior is undefined.</li>
* </ul>
*
+ * <p>A reference to a bean obtained from the container via {@linkplain
+ * javax.inject.Inject dependency injection} is a special kind of
+ * contextual reference, called an injected reference. Additional
+ * restrictions apply to the validity of an injected reference:</p>
+ *
+ * <ul>
+ * <li>A reference to a bean injected into a field, bean constructor or
+ * initializer method is only valid until the object into which it was
+ * injected is destroyed.</li>
+ * <li>A reference to a bean injected into a producer method is only
+ * valid until the producer method bean instance that is being produced
+ * is destroyed.<li>
+ * <li>A reference to a bean injected into a disposer method or observer
+ * method is only valid until the invocation of the method completes.</li>
+ * </ul>
+ *
*/
package javax.enterprise.context;
\ No newline at end of file