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

[weld-commits at lists.jboss.org]

Author: gavin.king at jboss.com
Date: 2009-10-29 01:23:29 -0400 (Thu, 29 Oct 2009)
New Revision: 4383

Modified:
   api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/InjectionPoint.java
Log:
more about InjectionPoint

Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/InjectionPoint.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/InjectionPoint.java	2009-10-29 05:15:11 UTC (rev 4382)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/InjectionPoint.java	2009-10-29 05:23:29 UTC (rev 4383)
@@ -28,6 +28,26 @@
  * injected field or a parameter of a bean constructor, initializer method, 
  * producer method, disposer method or observer method.</p>
  * 
+ * <p>Occasionally, a bean with scope 
+ * {@link javax.enterprise.context.Dependent &#064;Dependent} needs to access 
+ * metadata relating to the object to which it belongs. The bean may inject an 
+ * {@code InjectionPoint} representing the injection point into which the bean 
+ * was injected.</p>
+ * 
+ * <p>For example, the following producer method creates injectable <tt>Logger</tt>s. 
+ * The log category of a <tt>Logger</tt> depends upon the class of the object into 
+ * which it is injected.</p>
+ * 
+ * <pre>
+ * &#064;Produces 
+ * Logger createLogger(InjectionPoint injectionPoint) { 
+ *    return Logger.getLogger( injectionPoint.getMember().getDeclaringClass().getName() );
+ * }
+ * </pre>
+ * 
+ * <p>Only {@linkplain javax.enterprise.context.Dependent dependent} objects, may 
+ * obtain information about the injection point to which they belong.</p>
+ * 
  * @author Gavin King
  * @author Pete Muir
  */