You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@beehive.apache.org by ri...@apache.org on 2005/05/31 01:13:39 UTC

svn commit: r179169 - /incubator/beehive/branches/v1/m1/samples/netui-jsf /incubator/beehive/branches/v1/m1/samples/netui-jsf/WEB-INF/src /incubator/beehive/branches/v1/m1/samples/netui-samples /incubator/beehive/branches/v1/m1/samples/netui-samples/WEB-INF/src

Author: rich
Date: Mon May 30 16:13:37 2005
New Revision: 179169

URL: http://svn.apache.org/viewcvs?rev=179169&view=rev
Log:
- Added READMEs for netui-samples and netui-jsf.
- Updated the "usage" ant tasks for netui-samples and netui-jsf.

tests: build.dist in trunk (WinXP)
BB, run.tests: self (linux)


Added:
    incubator/beehive/branches/v1/m1/samples/netui-jsf/README.txt   (with props)
    incubator/beehive/branches/v1/m1/samples/netui-samples/README.txt   (with props)
Modified:
    incubator/beehive/branches/v1/m1/samples/netui-jsf/WEB-INF/src/build.xml
    incubator/beehive/branches/v1/m1/samples/netui-samples/WEB-INF/src/build.xml

Added: incubator/beehive/branches/v1/m1/samples/netui-jsf/README.txt
URL: http://svn.apache.org/viewcvs/incubator/beehive/branches/v1/m1/samples/netui-jsf/README.txt?rev=179169&view=auto
==============================================================================
--- incubator/beehive/branches/v1/m1/samples/netui-jsf/README.txt (added)
+++ incubator/beehive/branches/v1/m1/samples/netui-jsf/README.txt Mon May 30 16:13:37 2005
@@ -0,0 +1,90 @@
+Welcome to the NetUI/JSF Sample
+===============================
+
+Requirements
+============
+The following software is required to build and deploy this sample:
+  - Java 5
+  - Ant 1.6.2
+  - Servlet or J2EE Container
+  - A JavaServer Faces implementation; either MyFaces or the JavaServer Faces
+    Reference Implementation.
+
+Installing Dependencies
+=======================
+1) Java 5
+
+  Download: http://java.sun.com/j2se/1.5.0/download.jsp
+
+  Install Java 5 and set the JAVA_HOME environment variable to
+  refernce the JDK install directory.  Ensure that $JAVA_HOME/bin is
+  available in your $PATH.
+
+2) Ant 1.6.2
+
+  Download: http://ant.apache.org/bindownload.cgi
+
+  Ant 1.6.2 is the minimum version required by the Beehive build infrastructure.
+  Install Ant 1.6.2 and set the ANT_HOME environment variable to reference the
+  Ant install directory.  Ensure that $ANT_HOME/bin is available in your $PATH.
+
+3) J2EE Container
+
+  A Servlet or J2EE container is required.  The NetUI/JSF sample will run well
+  on Tomcat 5.x.  If you are using Tomcat, make sure that the CATALINA_HOME
+  environment variable is set to the root of the Tomcat installation.
+
+4) JavaServer Faces
+
+   Download one of the following:
+       - MyFaces 1.0.9 or later, at http://myfaces.apache.org
+       - JavaServer Faces v1.1.01 Reference Implementation, at
+         http://java.sun.com/j2ee/javaserverfaces/download.html
+
+   Once a JSF implementation has been downloaded, set the "myfaces.dir" or
+   "jsf-ri.dir" property as appropriate in WEB-INF/src/build.properties.
+
+Building
+========
+The NetUI/JSF sample is set up to build "in place", so classes are built
+directly to WEB-INF/classes.  The build.xml ant file is found in WEB-INF/src.
+
+The first time you build the web application, the Beehive runtime libraries will
+need to be copied into the webapp with:
+
+  $> ant deploy-beehive
+
+Then, the webapp can be built with:
+
+  $> ant build-myfaces
+          -or-
+  $> ant build-jsf-ri
+
+To clean the webapp, run:
+
+  $> ant clean
+
+To build a .war file for the webapp, run:
+
+  $> ant war
+
+Deploying and Running
+=====================
+Use your container's standard deployment practice to deploy the Web
+application found in samples/netui-jsf.
+
+The default context path for the webapp is "netui-jsf".  When deployed to the
+server, the web appliciation should be available at the URL:
+
+  http://<host>:<port>/netui-jsf/
+
+If you are using Tomcat 5.0.x for you J2EE container, you can deploy using the
+following *after you have built using 'build-myfaces' or 'build-jsf-ri'*:
+
+  $> cd <BeehiveRoot>/samples/netui-jsf/WEB-INF/src
+  $> ant war
+  $> cd <BeehiveRoot>/samples
+  $> cp netui-jsf.war $CATALINA_HOME/webapps
+
+Check the Beehive Wiki or your application container's documentation for
+information about deploying to other application containers.

Propchange: incubator/beehive/branches/v1/m1/samples/netui-jsf/README.txt
------------------------------------------------------------------------------
    svn:eol-style = CRLF

Propchange: incubator/beehive/branches/v1/m1/samples/netui-jsf/README.txt
------------------------------------------------------------------------------
    svn:eolstyle = dos

Modified: incubator/beehive/branches/v1/m1/samples/netui-jsf/WEB-INF/src/build.xml
URL: http://svn.apache.org/viewcvs/incubator/beehive/branches/v1/m1/samples/netui-jsf/WEB-INF/src/build.xml?rev=179169&r1=179168&r2=179169&view=diff
==============================================================================
--- incubator/beehive/branches/v1/m1/samples/netui-jsf/WEB-INF/src/build.xml (original)
+++ incubator/beehive/branches/v1/m1/samples/netui-jsf/WEB-INF/src/build.xml Mon May 30 16:13:37 2005
@@ -139,10 +139,11 @@
         <echo>
 Welcome to the Beehive netui-jsf webapp!
 
-    ant deploy-beehive -- this deploys the Beehive webapp runtime
-    ant build-myfaces  -- this builds the netui-jsf webapp against MyFaces (v1.0.9 or later)
-    ant build-jsf-ri   -- this builds the netui-jsf webapp against the JSF Reference Implementation (v1.1_01)
+    ant deploy-beehive -- deploys the Beehive webapp runtime
+    ant build-myfaces  -- builds the netui-jsf webapp against MyFaces (v1.0.9 or later)
+    ant build-jsf-ri   -- builds the netui-jsf webapp against the JSF Reference Implementation (v1.1.01)
     ant war            -- creates a .war archive to deploy; build-myfaces or build-jsf-ri must be called first
+    ant clean          -- cleans the netui-jsf webapp
         </echo>
 
         <java fork="no" classname="org.apache.tools.ant.Main">

Added: incubator/beehive/branches/v1/m1/samples/netui-samples/README.txt
URL: http://svn.apache.org/viewcvs/incubator/beehive/branches/v1/m1/samples/netui-samples/README.txt?rev=179169&view=auto
==============================================================================
--- incubator/beehive/branches/v1/m1/samples/netui-samples/README.txt (added)
+++ incubator/beehive/branches/v1/m1/samples/netui-samples/README.txt Mon May 30 16:13:37 2005
@@ -0,0 +1,76 @@
+Welcome to the NetUI Samples
+============================
+
+Requirements
+============
+The following software is required to build and deploy this application:
+  - Java 5
+  - Ant 1.6.2
+  - Servlet or J2EE Container
+
+Installing Dependencies
+=======================
+1) Java 5
+
+  Download: http://java.sun.com/j2se/1.5.0/download.jsp
+
+  Install Java 5 and set the JAVA_HOME environment variable to
+  refernce the JDK install directory.  Ensure that $JAVA_HOME/bin is
+  available in your $PATH.
+
+2) Ant 1.6.2
+
+  Download: http://ant.apache.org/bindownload.cgi
+
+  Ant 1.6.2 is the minimum version required by the Beehive build infrastructure.
+  Install Ant 1.6.2 and set the ANT_HOME environment variable to reference the
+  Ant install directory.  Ensure that $ANT_HOME/bin is available in your $PATH.
+
+3) J2EE Container
+
+  A Servlet or J2EE container is required.  The web application will run well
+  on Tomcat 5.x.  If you are using Tomcat, make sure that the CATALINA_HOME
+  environment variable is set to the root of the Tomcat installation.
+
+Building
+========
+The application is set up to build "in place", so classes are built directly to
+WEB-INF/classes.  The build.xml ant file is found in WEB-INF/src.
+
+The first time you build the web application, the Beehive runtime libraries will
+need to be copied into the webapp with:
+
+  $> ant deploy-beehive
+
+Then, the webapp can be built with:
+
+  $> ant build
+
+To clean the webapp, run:
+
+  $> ant clean
+
+To build a .war file for the webapp, run:
+
+  $> ant war
+
+Deploying and Running
+=====================
+Use your container's standard deployment practice to deploy the web
+application found in samples/netui-samples.
+
+The default context path for the webapp is "netui-samples".  When deployed to
+the server, the web appliciation should be available at the URL:
+
+  http://<host>:<port>/netui-samples/
+
+If you are using Tomcat 5.0.x for you J2EE container, you can deploy using the
+following:
+
+  $> cd <BeehiveRoot>/samples/netui-samples/WEB-INF/src
+  $> ant war
+  $> cd <BeehiveRoot>/samples
+  $> cp netui-samples.war $CATALINA_HOME/webapps
+
+Check the Beehive Wiki or your application container's documentation for
+information about deploying to other application containers.

Propchange: incubator/beehive/branches/v1/m1/samples/netui-samples/README.txt
------------------------------------------------------------------------------
    svn:eol-style = CRLF

Modified: incubator/beehive/branches/v1/m1/samples/netui-samples/WEB-INF/src/build.xml
URL: http://svn.apache.org/viewcvs/incubator/beehive/branches/v1/m1/samples/netui-samples/WEB-INF/src/build.xml?rev=179169&r1=179168&r2=179169&view=diff
==============================================================================
--- incubator/beehive/branches/v1/m1/samples/netui-samples/WEB-INF/src/build.xml (original)
+++ incubator/beehive/branches/v1/m1/samples/netui-samples/WEB-INF/src/build.xml Mon May 30 16:13:37 2005
@@ -91,7 +91,7 @@
         <delete dir="${webapp.dir}/WEB-INF/.pageflow-struts-generated"/>
     </target>
 
-    <target name="war" description="Build a compressed WAR file that can be deployed to an application container">
+    <target name="war" depends="build" description="Build a compressed WAR file that can be deployed to an application container">
         <property name="archive.dir" value="${webapp.dir}/.."/>
 
         <!-- this does *not* exclude source from the archive -->
@@ -108,9 +108,10 @@
 Welcome to the Beehive netui-samples webapp!  
 
 To run the webapp, two steps need to occur:
-ant deploy-beehive -- this deploys the Beehive webapp runtime
-ant build          -- this builds the netui-samples webapp
+ant deploy-beehive -- deploys the Beehive webapp runtime
+ant build          -- builds the netui-samples webapp
 ant war            -- creates a .war archive to deploy
+ant clean          -- cleans the netui-samples webapp
         </echo>
     </target>