[weld-commits] Weld SVN: r4396 - in api/trunk/cdi/src/main/java/javax/enterprise/context: spi and 1 other directory.

weld-commits at lists.jboss.org weld-commits at lists.jboss.org
Thu Oct 29 02:53:23 EDT 2009


Author: gavin.king at jboss.com
Date: 2009-10-29 02:53:22 -0400 (Thu, 29 Oct 2009)
New Revision: 4396

Added:
   api/trunk/cdi/src/main/java/javax/enterprise/context/spi/package-info.java
Modified:
   api/trunk/cdi/src/main/java/javax/enterprise/context/package-info.java
Log:
package-level javadoc for context.spi

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-29 06:42:07 UTC (rev 4395)
+++ api/trunk/cdi/src/main/java/javax/enterprise/context/package-info.java	2009-10-29 06:53:22 UTC (rev 4396)
@@ -3,27 +3,17 @@
  * 
  * <p>A scope type is a Java annotation annotated 
  * {@link javax.inject.Scope &#064;Scope} or 
- * {@link javax.enterprise.context.NormalScope &#064;NormalScope}.</p>
+ * {@link javax.enterprise.context.NormalScope &#064;NormalScope}.
+ * The scope of a bean determines the lifecycle and visibility of
+ * its instances. In particular, the scope determines:</p>
  * 
- * <p>Associated with every scope type is a 
- * {@linkplain javax.enterprise.context.spi.Context context object}. 
- * The context object determines the lifecycle and visibility of
- * 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>
- * <li>When an existing instance of any bean with that scope is 
- * destroyed</li>
- * <li>Which injected references refer to any instance of a bean 
- * with that scope</li>
+ * <li>When a new instance of the bean is created</li>
+ * <li>When an existing instance of the bean is destroyed</li>
+ * <li>Which injected references refer to any instance of the
+ * bean</li>
  * </ul>
  * 
- * <p>The context implementation collaborates with the container via 
- * the {@link javax.enterprise.context.spi.Context Context} and 
- * {@link javax.enterprise.context.spi.Contextual Contextual} 
- * interfaces to create and destroy contextual instances.</p>
- * 
  * <h3>Built-in scopes</h3>
  * 
  * <p>The following built-in scopes are provided:
@@ -40,10 +30,11 @@
  * and EJB invocations. The built-in conversation context supports
  * JSF requests.</p>
  * 
- * <p>For other kinds of invocations, a portable extension may define 
- * a custom context object for any or all of the built-in scopes. For 
- * example, a third-party web application framework might provide a 
- * conversation context object for the built-in conversation scope.</p>
+ * <p>For other kinds of invocations, a portable extension may define a 
+ * custom {@linkplain javax.enterprise.context.spi.Context context object} 
+ * for any or all of the built-in scopes. For example, a third-party web 
+ * application framework might provide a conversation context object for 
+ * the built-in conversation scope.</p>
  * 
  * <p>The context associated with a built-in scope propagates across 
  * local, synchronous Java method calls, including invocation of EJB 

Added: api/trunk/cdi/src/main/java/javax/enterprise/context/spi/package-info.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/context/spi/package-info.java	                        (rev 0)
+++ api/trunk/cdi/src/main/java/javax/enterprise/context/spi/package-info.java	2009-10-29 06:53:22 UTC (rev 4396)
@@ -0,0 +1,17 @@
+/**
+ * <p>The custom context SPI.</p>
+ * 
+ * <p>Associated with every 
+ * {@linkplain javax.enterprise.context scope type} is a 
+ * {@linkplain javax.enterprise.context.spi.Context context object}.
+ * The context object implements the semantics of the scope type.</p>
+ * 
+ * <p>The context implementation collaborates with the container via 
+ * the {@link javax.enterprise.context.spi.Context Context} and 
+ * {@link javax.enterprise.context.spi.Contextual Contextual} 
+ * interfaces to create and destroy contextual instances.</p>
+ * 
+ * @see javax.enterprise.context
+ * @see javax.enterprise.inject.spi
+ */
+package javax.enterprise.context.spi;
\ No newline at end of file



More information about the weld-commits mailing list