10:25 a.m.
Author: pete.muir(a)jboss.org
Date: 2009-09-29 11:25:36 -0400 (Tue, 29 Sep 2009)
New Revision: 3802
Modified:
doc/trunk/reference/en-US/environments.xml
doc/trunk/reference/en-US/gettingstarted.xml
Log:
Start to update
Modified: doc/trunk/reference/en-US/environments.xml
===================================================================
--- doc/trunk/reference/en-US/environments.xml 2009-09-29 13:57:56 UTC (rev 3801)
+++ doc/trunk/reference/en-US/environments.xml 2009-09-29 15:25:36 UTC (rev 3802)
@@ -113,6 +113,11 @@
<literal>dom4j.jar</literal>
</para>
</listitem>
+ <listitem>
+ <para>
+ <literal>google-collections.jar</literal>
+ </para>
+ </listitem>
</itemizedlist>
<para>
@@ -130,15 +135,15 @@
<para>
Tomcat has a read-only JNDI, so Web Beans can't automatically bind
- the Manager. To bind the Manager into JNDI, you should populate
+ the BeanManager. To bind the BeanManager into JNDI, you should populate
<literal>META-INF/context.xml</literal> with the following
contents:
</para>
<programlisting role="XML"><![CDATA[<Context>
- <Resource name="app/Manager"
+ <Resource name="BeanManager"
auth="Container"
- type="javax.inject.manager.Manager"
+ type="javax.enterprise.inject.spi.BeanManager"
factory="org.jboss.webbeans.resources.ManagerObjectFactory"/>
</Context>]]></programlisting>
@@ -149,17 +154,17 @@
<programlisting role="XML"><![CDATA[<resource-env-ref>
<resource-env-ref-name>
- app/Manager
+ BeanManager
</resource-env-ref-name>
<resource-env-ref-type>
- javax.inject.manager.Manager
+ javax.enterprise.inject.spi.BeanManager
</resource-env-ref-type>
</resource-env-ref>]]></programlisting>
<para>
Tomcat only allows you to bind entries to
- <literal>java:comp/env</literal>, so the Manager will be
available
- at <literal>java:comp/env/app/Manager</literal>
+ <literal>java:comp/env</literal>, so the BeanManager will be
available
+ at <literal>java:comp/env/BeanManager</literal>
</para>
<para>
@@ -186,12 +191,12 @@
<programlisting role="XML"><![CDATA[<!DOCTYPE Configure
PUBLIC "-//Mort Bay Consulting//DTD Configure//EN"
"http://jetty.mortbay.org/configure.dtd">
<Configure id="webAppCtx"
class="org.mortbay.jetty.webapp.WebAppContext">
- <New id="appManager"
class="org.mortbay.jetty.plus.naming.Resource">
+ <New id="BeanManager"
class="org.mortbay.jetty.plus.naming.Resource">
<Arg><Ref id="webAppCtx"/></Arg>
- <Arg>app/Manager</Arg>
+ <Arg>BeanManager</Arg>
<Arg>
<New class="javax.naming.Reference">
- <Arg>javax.inject.manager.Manager</Arg>
+ <Arg>javax.enterprise.inject.spi.BeanManager</Arg>
<Arg>org.jboss.webbeans.resources.ManagerObjectFactory</Arg>
<Arg/>
</New>
@@ -208,8 +213,8 @@
<para>
Jetty only allows you to bind entries to
- <literal>java:comp/env</literal>, so the Manager will be
available
- at <literal>java:comp/env/app/Manager</literal>
+ <literal>java:comp/env</literal>, so the BeanManager will be
available
+ at <literal>java:comp/env/BeanManager</literal>
</para>
<para>
Modified: doc/trunk/reference/en-US/gettingstarted.xml
===================================================================
--- doc/trunk/reference/en-US/gettingstarted.xml 2009-09-29 13:57:56 UTC (rev 3801)
+++ doc/trunk/reference/en-US/gettingstarted.xml 2009-09-29 15:25:36 UTC (rev 3802)
@@ -12,11 +12,10 @@
<para>
Web Beans comes with a two deployable example applications:
- <literal>webbeans-numberguess</literal>, a war example, containing
only
+ <literal>webbeans-numberguess</literal>, a war example which runs on
+ JBoss AS, Tomcat, Jetty and Google App Engine, containing only
simple beans, and <literal>webbeans-translator</literal> an ear
example,
- containing enterprise beans. There are also two variations on the
- numberguess example, the tomcat example (suitable for deployment to
- Tomcat) and the jsf2 example, which you can use if you are running JSF2.
+ containing enterprise beans.
To run the examples you'll need the following:
</para>
@@ -25,9 +24,12 @@
<para>the latest release of Web Beans,</para>
</listitem>
<listitem>
- <para>JBoss AS 5.0.1.GA, or</para>
+ <para>JBoss AS 5.2.0, or</para>
</listitem>
<listitem>
+ <para>Jetty 6.1.x, or</para>
+ </listitem>
+ <listitem>
<para>Apache Tomcat 6.0.x, and</para>
</listitem>
<listitem>
@@ -39,56 +41,21 @@
<title>Using JBoss AS 5</title>
<para>
- You'll need to download JBoss AS 5.0.1.GA from
+ You'll need to download JBoss AS 5.2.0 from
<ulink
url="http://www.jboss.org/jbossas/downloads/">jboss.org</...;,
and unzip it. For example:
</para>
<programlisting><![CDATA[$ cd /Applications
-$ unzip ~/jboss-5.0.1.GA.zip]]></programlisting>
+$ unzip ~/jboss-5.2.0.Beta.zip]]></programlisting>
- <para>
- Next, download Web Beans from
- <ulink
url="http://seamframework.org/Download">seamframework.org<...;,
- and unzip it. For example
- </para>
-
- <programlisting><![CDATA[$ cd ~/
-$ unzip ~/webbeans-$VERSION.zip]]></programlisting>
-
-
- <para>
- Next, we need to tell Web Beans where JBoss is located. Edit
- <literal>jboss-as/build.properties</literal> and set the
- <literal>jboss.home</literal> property. For example:
- </para>
-
-
<programlisting>jboss.home=/Applications/jboss-5.0.1.GA</programlisting>
-
- <para>
- To install Web Beans, you'll need Ant 1.7.0 installed, and the
- <literal>ANT_HOME</literal> environment variable set. For example:
- </para>
-
<note>
<para>
- JBoss 5.1.0 comes with Web Beans built in, so there is no need to
- update the server.
+ JBoss AS 5.2.0 comes with Web Beans built in.
</para>
</note>
- <programlisting>$ unzip apache-ant-1.7.0.zip
-$ export ANT_HOME=~/apache-ant-1.7.0</programlisting>
-
<para>
- Then, you can install the update. The update script will use Maven to
- download Web Beans automatically.
- </para>
-
- <programlisting>$ cd webbeans-$VERSION/jboss-as
-$ ant update</programlisting>
-
- <para>
Now, you're ready to deploy your first example!
</para>
@@ -132,14 +99,14 @@
To deploy the numberguess example:
</para>
- <programlisting>$ cd examples/numberguess
+ <programlisting>$ cd examples/jsf/numberguess
ant deploy</programlisting>
<para>
Start JBoss AS:
</para>
- <programlisting>$
/Application/jboss-5.0.0.GA/bin/run.sh</programlisting>
+ <programlisting>$
/Application/jboss-5.2.0.Beta/bin/run.sh</programlisting>
<tip>
<para>
@@ -189,12 +156,6 @@
<programlisting><![CDATA[$ cd ~/
$ unzip ~/webbeans-$VERSION.zip]]></programlisting>
-
- <para>
- Next, we need to tell Web Beans where Tomcat is located. Edit
- <literal>jboss-as/build.properties</literal> and set the
- <literal>tomcat.home</literal> property. For example:
- </para>
<programlisting>tomcat.home=/Applications/apache-tomcat-6.0.18</programlisting>
@@ -206,47 +167,36 @@
<itemizedlist>
<listitem>
<para>
- <literal>ant tomcat.restart</literal> - deploy the example
in exploded
- format
+ <literal>mvn war:inplace tomcat:run -Ptomcat</literal> -
deploy the example in an embedded Tomcat
</para>
</listitem>
<listitem>
<para>
- <literal>ant tomcat.explode</literal> - update an exploded
example, without
- restarting the deployment
+ <literal>mvn compile war:exploded tomcat:exploded
-Ptomcat</literal> - deploy the example to a running Tomcat install
</para>
</listitem>
- <listitem>
- <para>
- <literal>ant tomcat.deploy</literal> - deploy the example
in compressed jar format
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>ant tomcat.undeploy</literal> - remove the example
(in compressed jar format) from the server
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>ant tomcat.unexplode</literal> - remove the
example (in exploded format) from the server
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>ant tomcat.clean</literal> - clean the example
- </para>
- </listitem>
</itemizedlist>
+ <para>
+ See the <code>jsf/numberguess/readme.txt</code> for more
details.
+ </para>
</tip>
<para>
To deploy the numberguess example for tomcat:
</para>
- <programlisting>$ cd examples/tomcat
+ <programlisting>$ cd examples/jsf/numberguess
ant tomcat.deploy</programlisting>
<para>
+ Edit <code>$TOMCAT_HOME/conf/tomcat-users.xml</code> and add
+ </para>
+
+ <programlisting><![CDATA[<user username="admin"
password="" roles="manager"/>]]></programlisting>
+
+ <para>This allows Maven to communicate with Tomcat.</para>
+
+ <para>
Start Tomcat:
</para>
@@ -257,6 +207,10 @@
If you use Windows, use the
<literal>startup.bat</literal>script.
</para>
</tip>
+
+ <para>Deploy the application</para>
+
+ <programlisting>$ mvn compile war:exploded tomcat:exploded
-Ptomcat</programlisting>
<para>
Wait for the application to deploy, and enjoy hours of fun at
@@ -562,39 +516,38 @@
<programlisting role="JAVA"><![CDATA[package
org.jboss.webbeans.examples.numberguess;
+import java.io.Serializable;
import javax.annotation.PostConstruct;
+import javax.enterprise.context.SessionScoped;
+import javax.enterprise.inject.Instance;
import javax.faces.application.FacesMessage;
+import javax.faces.component.UIComponent;
+import javax.faces.component.UIInput;
import javax.faces.context.FacesContext;
-import javax.webbeans.AnnotationLiteral;
-import javax.webbeans.Current;
-import javax.webbeans.Initializer;
-import javax.webbeans.Named;
-import javax.webbeans.SessionScoped;
-import javax.webbeans.manager.Manager;
+import javax.inject.Inject;
+import javax.inject.Named;
@Named
@SessionScoped
-public class Game
+public class Game implements Serializable
{
private int number;
private int guess;
private int smallest;
+
+ @Inject @MaxNumber
+ private int maxNumber;
+
private int biggest;
private int remainingGuesses;
- @Current Manager manager;
+ @Inject @Random Instance<Integer> randomNumber;
public Game()
{
}
-
- @Initializer
- Game(@MaxNumber int maxNumber)
- {
- this.biggest = maxNumber;
- }
public int getNumber()
{
@@ -650,11 +603,32 @@
this.smallest = 0;
this.guess = 0;
this.remainingGuesses = 10;
- this.number = manager.getInstanceByType(Integer.class, new
AnnotationLiteral<Random>(){});
+ this.biggest = maxNumber;
+ this.number = randomNumber.get();
}
-}]]></programlisting>
+ public void validateNumberRange(FacesContext context, UIComponent toValidate, Object
value)
+ {
+ if (remainingGuesses <= 0)
+ {
+ FacesMessage message = new FacesMessage("No guesses left!");
+ context.addMessage(toValidate.getClientId(context), message);
+ ((UIInput)toValidate).setValid(false);
+ return;
+ }
+ int input = (Integer) value;
+ if (input < smallest || input > biggest)
+ {
+ ((UIInput)toValidate).setValid(false);
+
+ FacesMessage message = new FacesMessage("Invalid guess");
+ context.addMessage(toValidate.getClientId(context), message);
+ }
+ }
+}
+]]></programlisting>
+
<section>
<title>The numberguess example in Tomcat</title>