[weld-commits] Weld SVN: r4181 - doc/trunk/reference/en-US.

[weld-commits at lists.jboss.org]

Author: pete.muir at jboss.org
Date: 2009-10-18 09:04:11 -0400 (Sun, 18 Oct 2009)
New Revision: 4181

Modified:
   doc/trunk/reference/en-US/ri-spi.xml
Log:
Update requirements for performing EE component injection

Modified: doc/trunk/reference/en-US/ri-spi.xml
===================================================================
--- doc/trunk/reference/en-US/ri-spi.xml	2009-10-18 12:51:53 UTC (rev 4180)
+++ doc/trunk/reference/en-US/ri-spi.xml	2009-10-18 13:04:11 UTC (rev 4181)
@@ -760,11 +760,25 @@
                   class.
                </para>
                
-               <programlisting><![CDATA[
+               <para>
+                  The CDI specification also requires that a 
+                  <literal>ProcessInjectionTarget</literal> event is fired for
+                  every Java EE component class. Furthermore, if an observer
+                  calls <literal>ProcessInjectionTarget.setInjectionTarget()</literal>
+                  the container must use <emphasis>the specified</emphasis> injection
+                  target to perform injection.
+               </para>
+               
+               <para>
+                  To help the integrator, Weld provides
+                  <literal>WeldManager.fireProcessInjectionTarget()</literal>
+                  which returns the <literal>InjectionTarget</literal> to use.
+               </para>
+               
+               <programlisting><![CDATA[// Fire ProcessInjectionTarget, returning the InjectionTarget
+// to use
+InjectionTarget it = weldBeanManager.fireProcessInjectionTarget(clazz);
 
-// Create the injection target, once per class
-InjectionTarget it = beanManager.createInjectionTarget(clazz);
-
 // Per instance required, create the creational context
 CreationalContext<?> cc = beanManager.createCreationalContext(null);