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

[weld-commits at lists.jboss.org]

Author: gavin.king at jboss.com
Date: 2009-11-15 23:44:04 -0500 (Sun, 15 Nov 2009)
New Revision: 5076

Modified:
   doc/trunk/reference/en-US/extend.xml
Log:
wrapping InjectionTarget

Modified: doc/trunk/reference/en-US/extend.xml
===================================================================
--- doc/trunk/reference/en-US/extend.xml	2009-11-16 04:18:06 UTC (rev 5075)
+++ doc/trunk/reference/en-US/extend.xml	2009-11-16 04:44:04 UTC (rev 5076)
@@ -309,13 +309,40 @@
    
 }]]></programlisting>
 
+      <para>The <literal>AnnotatedType</literal> is not the only thing that can be wrapped by an extension.</para>
+
    </section>
 
    <section>
       <title>Wrapping an <literal>InjectionTarget</literal></title>
       
-      <para>TODO</para>
+      <para>
+          The <literal>InjectionTarget</literal> interface exposes operations for producing and disposing an instance
+          of a component, injecting its dependencies and invoking its lifecycle callbacks. A portable extension may 
+          wrap the <literal>InjectionTarget</literal> for any Java EE component that supports injection, allowing it
+          to intercept any of these operations when they are invoked by the container.
+      </para>
       
+      <programlisting role="JAVA"><![CDATA[class MyExtension implements Extension {
+      
+   <T extends Servlet> void processServlet(ProcessInjectionTarget<T> pit) {
+      final InjectionTarget<T> it = pit.getInjectionTarget();
+      InjectionTarget<T> wrapped = new InjectionTarget<T>() {
+         public T produce(CreationalContext<T> ctx) {
+            Logger.global.debug("instantiating a servlet");
+            return it.produce(ctx);
+         }
+         public void inject(T instance, CreationalContext<T> ctx) {
+            Logger.global.debug("injecting servlet dependencies");
+            it.inject(instance, ctx);
+         }
+         ...
+      }
+      pat.setInjectionTarget(wrapped);
+   } 
+   
+}]]></programlisting>
+
    </section>
 
   <!--