[weld-commits] Weld SVN: r4383 - api/trunk/cdi/src/main/java/javax/enterprise/inject/spi.
Author: gavin.king(a)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 @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>
+ * @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
*/