[webbeans-commits] Webbeans SVN: r1774 - doc/trunk/reference/en-US.

[webbeans-commits at lists.jboss.org]

Author: pete.muir at jboss.org
Date: 2009-03-05 17:20:30 -0500 (Thu, 05 Mar 2009)
New Revision: 1774

Modified:
   doc/trunk/reference/en-US/ri-spi.xml
Log:
Document the servlet injection

Modified: doc/trunk/reference/en-US/ri-spi.xml
===================================================================
--- doc/trunk/reference/en-US/ri-spi.xml	2009-03-05 16:51:38 UTC (rev 1773)
+++ doc/trunk/reference/en-US/ri-spi.xml	2009-03-05 22:20:30 UTC (rev 1774)
@@ -325,6 +325,29 @@
          ]]></programlisting>
 
        </section>
+       
+       <section>
+         <title>Servlet injection</title>
+         
+         <para>
+            Java EE / Servlet does not provide any hooks which can be used to 
+            provide injection into Servlets, so Web Beans provides an API to 
+            allow the container to request JSR-299 injection for a Servlet.
+         </para>
+         
+         <para>
+            To be compliant with JSR-299, the container should request servlet
+            injection for each newly instantiated servlet after the constructor
+            returns and before the servlet is placed into service.
+         </para>
+         
+         <para>
+            To perform injection on a servlet call 
+            <literal>WebBeansManager.injectIntoServlet()</literal>. The manager
+            can be obtained from <literal>Bootstrap.getManager()</literal>.
+         </para>
+         
+       </section>
    
     </section>