From webbeans-commits at lists.jboss.org Thu Apr 23 18:55:19 2009
Content-Type: multipart/mixed; boundary="===============0596029630849494380=="
MIME-Version: 1.0
From: webbeans-commits at lists.jboss.org
To: weld-commits at lists.jboss.org
Subject: [webbeans-commits] Webbeans SVN: r2616 - doc/trunk/reference/en-US.
Date: Thu, 23 Apr 2009 18:50:50 -0400
Message-ID: <E1Lx7ko-00082k-03@committer01.frg.pub.inap.atl.jboss.com>

--===============0596029630849494380==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

Author: dan.j.allen
Date: 2009-04-23 18:50:49 -0400 (Thu, 23 Apr 2009)
New Revision: 2616

Modified:
   doc/trunk/reference/en-US/environments.xml
Log:
WBX-31


Modified: doc/trunk/reference/en-US/environments.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- doc/trunk/reference/en-US/environments.xml	2009-04-22 18:42:57 UTC (rev=
 2615)
+++ doc/trunk/reference/en-US/environments.xml	2009-04-23 22:50:49 UTC (rev=
 2616)
@@ -45,7 +45,7 @@
    </section>
    =

    <section>
-      <title>Glassfish</title>
+      <title>GlassFish</title>
       =

       <para>TODO</para>
    </section>
@@ -65,11 +65,11 @@
       </note>
       =

       <para>
-         Web Beans should be used as a web application library in a servle=
t =

-         container. You should place <literal>webbeans-servlet.jar</litera=
l> in
-         <literal>WEB-INF/lib</literal>. <literal>webbeans-serv;et.jar</li=
teral>
-         is an "uber-jar" provided for your convenience. Instead, you coul=
d use
-         its component jars: =

+         Web Beans should be used as a web application library in a servlet
+         container. You should place <literal>webbeans-servlet.jar</litera=
l>
+         in <literal>WEB-INF/lib</literal>.
+         <literal>webbeans-servlet.jar</literal> is an "uber-jar" provided=
 for
+         your convenience. Alternatively, you could use its component jars=
: =

       </para>
       =

       <itemizedlist>
@@ -117,41 +117,43 @@
       =

       <para>
          You also need to explicitly specify the servlet listener (used to
-         boot Web Beans, and control its interaction with requests) in =

+         boot Web Beans, and control its interaction with requests) in
          <literal>web.xml</literal>:
       </para>
          =

-      <programlisting><![CDATA[<listener>
+      <programlisting role=3D"XML"><![CDATA[<listener>
    <listener-class>org.jboss.webbeans.environment.servlet.Listener</listen=
er-class>
 </listener>]]></programlisting>
 =

       <section>
          <title>Tomcat</title>
 =

-	      <para>
-	         Tomcat has a read-only JNDI, so Web Beans can't automatically bi=
nd =

-	         the Manager. To bind the Manager into JNDI, you should add the =

-	         following to your <literal>META-INF/context.xml</literal>:
-	      </para>
+         <para>
+            Tomcat has a read-only JNDI, so Web Beans can't automatically =
bind =

+            the Manager. To bind the Manager into JNDI, you should populat=
e =

+            <literal>META-INF/context.xml</literal> with the following
+			contents:
+         </para>
       =

-         <programlisting><![CDATA[<Resource name=3D"app/Manager" =

-          auth=3D"Container"
-          type=3D"javax.inject.manager.Manager"
-          factory=3D"org.jboss.webbeans.resources.ManagerObjectFactory"/>
-]]></programlisting>
+         <programlisting role=3D"XML"><![CDATA[<Context>
+   <Resource name=3D"app/Manager" =

+      auth=3D"Container"
+      type=3D"javax.inject.manager.Manager"
+      factory=3D"org.jboss.webbeans.resources.ManagerObjectFactory"/>
+</Context>]]></programlisting>
 =

          <para>
-           and make it available to your deployment by adding this to =

-            <literal>web.xml</literal>:
+            and make it available to your deployment by adding this to =

+            the bottom of <literal>web.xml</literal>:
          </para>
       =

-         <programlisting><![CDATA[<resource-env-ref>
-  <resource-env-ref-name>
-    app/Manager
-  </resource-env-ref-name>
-  <resource-env-ref-type>
-    javax.inject.manager.Manager
-  </resource-env-ref-type>
+         <programlisting role=3D"XML"><![CDATA[<resource-env-ref>
+   <resource-env-ref-name>
+      app/Manager
+   </resource-env-ref-name>
+   <resource-env-ref-type>
+      javax.inject.manager.Manager
+   </resource-env-ref-type>
 </resource-env-ref>]]></programlisting>
 =

          <para>
@@ -163,14 +165,59 @@
          <para>
             Web Beans also supports Servlet injection in Tomcat. To enable=
 this,
             place the <literal>webbeans-tomcat-support.jar</literal> in =

-           <literal>$TOMCAT_HOME/lib</literal>, and add the following to y=
our
-           <literal>META-INF/context.xml</literal>:
+            <literal>$TOMCAT_HOME/lib</literal>, and add the following to =
your
+            <literal>META-INF/context.xml</literal>:
          </para>
       =

-         <programlisting><![CDATA[<Listener className=3D"org.jboss.webbean=
s.environment.tomcat.WebBeansLifecycleListener" />]]></programlisting>
+         <programlisting role=3D"XML"><![CDATA[<Listener className=3D"org.=
jboss.webbeans.environment.tomcat.WebBeansLifecycleListener"/>]]></programl=
isting>
          =

       </section>
 =

+      <section>
+         <title>Jetty</title>
+
+         <para>
+            Like Tomcat, Jetty has a read-only JNDI, so Web Beans can't
+            automatically bind the Manager. To bind the Manager to JNDI, y=
ou
+            should populate <literal>WEB-INF/jetty-env.xml</literal> with =
the
+            following contents:
+         </para>
+      =

+         <programlisting role=3D"XML"><![CDATA[<!DOCTYPE Configure PUBLIC =
"-//Mort Bay Consulting//DTD Configure//EN"
+   "http://jetty.mortbay.org/configure.dtd">
+<Configure id=3D"webAppCtx" class=3D"org.mortbay.jetty.webapp.WebAppContex=
t">
+   <New id=3D"jdciManager" class=3D"org.mortbay.jetty.plus.naming.Resource=
">
+      <Arg><Ref id=3D"webAppCtx"/></Arg> =

+      <Arg>app/Manager</Arg>
+      <Arg>
+         <New class=3D"javax.naming.Reference">
+            <Arg>javax.inject.manager.Manager</Arg> =

+            <Arg>org.jboss.webbeans.resources.ManagerObjectFactory</Arg>
+            <Arg/>
+         </New>
+      </Arg>
+   </New>
+</Configure>]]></programlisting>
+
+         <para>
+            Notice that Jetty doesn't not have built-in support for an
+            <literal>javax.naming.spi.ObjectFactory</literal> like Tomcat,=
 so
+            it's necessary to manually create the
+            <literal>javax.naming.Reference</literal> to wrap around it.
+         </para>
+
+         <para>
+            Jetty only allows you to bind entries to
+            <literal>java:comp/env</literal>, so the Manager will be avail=
able =

+            at <literal>java:comp/env/app/Manager</literal>
+         </para>
+
+         <para>
+            Web Beans does not currently support Servlet injection in Jett=
y.
+         </para>
+
+      </section>
+
    </section>
    =

    <section>
@@ -286,4 +333,4 @@
 =

    </section>
 =

-</chapter>
\ No newline at end of file
+</chapter>


--===============0596029630849494380==--