Author: gavin.king(a)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