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

[weld-commits at lists.jboss.org]

Author: gavin.king at jboss.com
Date: 2009-10-25 22:55:21 -0400 (Sun, 25 Oct 2009)
New Revision: 4320

Modified:
   api/trunk/cdi/src/main/java/javax/enterprise/inject/UnproxyableResolutionException.java
   api/trunk/cdi/src/main/java/javax/enterprise/inject/package-info.java
Log:
uproxyable bean types

Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/UnproxyableResolutionException.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/UnproxyableResolutionException.java	2009-10-26 01:09:28 UTC (rev 4319)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/UnproxyableResolutionException.java	2009-10-26 02:55:21 UTC (rev 4320)
@@ -20,7 +20,9 @@
 
 
 /**
- * Thrown if a bean has normal scope and cannot be proxied by the container.
+ * <p>Indicates that a contextual reference for a bean with a normal scope 
+ * and a certain bean type cannot be obtained because the bean type cannot 
+ * be proxied by the container.</p>
  * 
  * @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-26 01:09:28 UTC (rev 4319)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/package-info.java	2009-10-26 02:55:21 UTC (rev 4320)
@@ -314,6 +314,20 @@
  * of the Java EE platform and Java Servlet specifications.</li>
  * </ul>
  * 
+ * <h3>Unproxyable bean types</h3>
+ * 
+ * <p>Certain legal bean types cannot be proxied by the container:</p>
+ * 
+ * <ul>
+ * <li>classes which don't have a non-private constructor with no parameters,</li>
+ * <li>classes which are declared final or have final methods,</li>
+ * <li>primitive types,</li>
+ * <li>and array types.</li>
+ * </ul>
+ * 
+ * <p>An injection point whose declared type cannot be proxied by the 
+ * container must not resolve to a bean with a normal scope.</p>
+ * 
  * @see javax.enterprise.inject.Produces
  * @see javax.inject.Scope
  * @see javax.inject.Named