mirror of
https://github.com/moparisthebest/JdbcMapper
synced 2024-11-25 18:32:18 -05:00
90 lines
2.7 KiB
Plaintext
90 lines
2.7 KiB
Plaintext
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 application is set up to create an exploded web application directory in
|
|
build/ by copying the web/ directory, building Beehive source artifacts, and
|
|
compiling the source files in the src/ directory.
|
|
|
|
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'*:
|
|
|
|
$> ant build war
|
|
$> 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.
|