[weld-commits] Weld SVN: r4264 - api/trunk/cdi/src/main/java/javax/enterprise/inject.

[weld-commits at lists.jboss.org]

Author: gavin.king at jboss.com
Date: 2009-10-24 11:46:55 -0400 (Sat, 24 Oct 2009)
New Revision: 4264

Modified:
   api/trunk/cdi/src/main/java/javax/enterprise/inject/Specializes.java
   api/trunk/cdi/src/main/java/javax/enterprise/inject/package-info.java
Log:
doc for specializes and enabled

Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/Specializes.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/Specializes.java	2009-10-24 03:23:23 UTC (rev 4263)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/Specializes.java	2009-10-24 15:46:55 UTC (rev 4264)
@@ -26,9 +26,37 @@
 import java.lang.annotation.Target;
 
 /**
- * Specifies that an implementation class directly specializes its superclass,
- * of that a producer method directly specializes the method it overrides.
+ * <p>Indicates that a bean directly specializes another bean.
+ * May be applied to a bean class or producer method.</p>
  * 
+ * <p>If a bean directly specializes a second bean, it
+ * inherits all qualifiers of the second bean, and has the
+ * same name as the second bean. If the second bean has
+ * a name, the bean may not declare a name using
+ * {@link javax.inject.Named &#064;Named}. Furthermore, 
+ * the bean must have all the bean types of the second
+ * bean.</p>
+ * 
+ * <ul>
+ * <li>If a bean class of a managed bean is annotated 
+ * <tt>&#064;Specializes</tt>, then the bean class must 
+ * directly extend the bean class of a second managed bean. 
+ * Then the first managed bean directly specializes the 
+ * second managed bean.</li>
+ * 
+ * <li>If a bean class of a session bean is annotated 
+ * <tt>&#064;Specializes</tt>, then the bean class must 
+ * directly extend the bean class of a second session bean. 
+ * Then the first session bean directly specializes the 
+ * second session bean.</li>
+ * 
+ * <li>If a producer method is annotated 
+ * <tt>&#064;Specializes</tt>, then it must be non-static 
+ * and directly override another producer method. Then the 
+ * first producer method directly specializes the second
+ * producer method.</li>
+ * </ul>
+ * 
  * @author Gavin King
  * @author Pete Muir
  */

Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/package-info.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/package-info.java	2009-10-24 03:23:23 UTC (rev 4263)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/package-info.java	2009-10-24 15:46:55 UTC (rev 4264)
@@ -252,6 +252,24 @@
  * 
  * <p>A resource may not have an EL name.</p>
  * 
+ * <h3>Enabled and disabled beans</h3>
+ * 
+ * <p>A bean is said to be enabled if:</p>
+ * 
+ * <ul>
+ * <li>it is deployed in a bean deployment archive (a module with a <tt>beans.xml</tt>
+ * file), and</li>
+ * <li>it is not a 
+ * {@linkplain javax.enterprise.inject.Produces producer method or field} 
+ * of a disabled bean, and</li>
+ * <li>it is not {@linkplain javax.enterprise.inject.Specializes specialized} 
+ * by any other enabled bean, and either</li>
+ * <li>it is not an {@linkplain javax.enterprise.inject.Alternative alternative}, 
+ * or it is a selected alternative of at least one bean deployment archive.</li>
+ * </ul>
+ * 
+ * <p>Otherwise, the bean is said to be disabled.</p>
+ * 
  * @see javax.enterprise.inject.Produces
  * @see javax.inject.Scope
  * @see javax.inject.Named