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

[weld-commits at lists.jboss.org]

Author: gavin.king at jboss.com
Date: 2009-11-15 19:52:46 -0500 (Sun, 15 Nov 2009)
New Revision: 5067

Modified:
   doc/trunk/reference/en-US/ee.xml
Log:
note

Modified: doc/trunk/reference/en-US/ee.xml
===================================================================
--- doc/trunk/reference/en-US/ee.xml	2009-11-16 00:41:32 UTC (rev 5066)
+++ doc/trunk/reference/en-US/ee.xml	2009-11-16 00:52:46 UTC (rev 5067)
@@ -41,6 +41,18 @@
             </listitem>
          </itemizedlist>
          
+         <note>
+            <para>
+               The CDI specification does not require the servlet context objects, <literal>HttpServletRequest</literal>,
+               <literal>HttpSession</literal> and <literal>ServletContext</literal> to be exposed as injectable beans. If 
+               you really want to be able to inject these objects, it's easy to create a portable extension to expose them 
+               as beans. However, we recommend that direct access to these objects be limited to servlets, servlet filters 
+               and servlet event listeners, where they may be obtained in the usual way as defined by the Java Servlets spec.
+               The <literal>FacesContext</literal> is also not injectable. You can get at it by calling 
+               <literal>FacesContext.getCurrentInstance()</literal>.
+            </para>
+         </note>
+         
       </section>
 
    <section>