|
Deployment Guide
This guide shows you how to deploy the JavaServer Faces 1.0 EA4 Demo
web applications available in the
JavaTM Web Services Developer Pack ("Java WSDP") 1.2
download to web containers other than that provided by the Java WSDP 1.2
environment. These web containers must be compliant with either the
JavaTM 2 Platform, Enterprise Edition 1.3 platform
(J2EETM platform 1.3) or the J2EE platform 1.4.
Deploying on Containers Compliant with the J2EE Platform 1.4
Example container's include:
There are no extra steps required to deploy the JavaServer Faces 1.0
EA4 Demo web applications in a container compliant with the J2EE
platform 1.4. You can copy the pre-built WAR files available
in your <JWSDP_HOME>/jsf directory
to your container's webapps directory.
Deploying on Containers Compliant with the J2EE Platform 1.3
Example container's include:
To deploy the bundled Java WSDP 1.2 JavaServer Faces demo web applications
on a container compliant with the J2EE platform 1.3, you need to perform two
simple tasks:
Replace the bundled JSTL 1.1 JAR files with the JSTL 1.0.x JAR Files
The Java WSDP 1.2 JavaServer Faces demos
come bundled with JSTL 1.1. The JSTL 1.1 implementation is dependant on a
J2EE 1.4 platform container. Therefore, you need to remove this implementation and
replace it with a JSTL 1.0.x implementation by performing these steps:
- Unbundle the desired example WAR file:
jar -xvf <example-war-file>
- Remove the following JAR files, which are located in the WEB-INF/lib
directory of the demo WAR file:
- Download JSTL 1.0.x. If you are using the Java WSDP 1.1 or Apache
JSTL 1.0.x implementation you will need these JAR files:
- jstl.jar
- standard.jar
- jaxen-full.jar
- saxpath.jar
- Copy the JAR files you downloaded to the WEB-INF/lib directory
of the WAR file that you unbundled in step 1.
- Rebundle the WAR file:
jar uf <example-war-file> WEB-INF/lib/jstl.jar WEB-INF/lib/standard.jar WEB-INF/lib/jaxen-full.jar WEB-INF/lib/saxpath.jar
Modify the Demo's web.xml File
In a J2EE platform 1.3 container, the ordering of web.xml
elements is strictly enforced. The ordering requirements of the J2EE platform 1.4
container are less restrictive.
The web.xml files used by the
JavaServer Faces demos do not follow the strict ordering required by a J2EE platform
1.3 container. This is a known oversight. Future
JavaServer Faces Demo releases will follow the strict ordering
requirement so that you will not need to modify a demo's web.xml file to run
the demo in a J2EE platform 1.3 container.
In the meantime, you need to modify the web.xml file of your
desired JavaServer Faces demo by following these steps:
- Open the
web.xml file located in the example's WEB-INF directory using your preferred editor.
- Move the
<display-name> element so that it
is before the <description> element and after the <web-app>
element. Here is an example that illustrates the
change:
Before:
...
<web-app>
<description>
JavaServer Faces Car Demo Sample Application
</description>
<display-name>JavaServer Faces Car Demo Sample Application</display-name>
...
After:
...
<web-app>
<display-name>JavaServer Faces Car Demo Sample Application</display-name>
<description>
JavaServer Faces Car Demo Sample Application
</description>
...
Demo Dependency Table
This table lists the JavaServer Faces Demo web application version
dependencies. You will need these JAR files in your demo web
application's WEB-INF/lib directory.
Project
|
Packages
|
Versions
|
JavaServer
Faces
|
|
|
JSP
Standard Tag Library
|
J2EE 1.4 compliant container:
J2EE 1.3 compliant container:
jstl.jar
|
standard.jar
|
jaxen-full.jar
|
| saxpath.jar |
|
J2EE 1.4 compliant container:
J2EE 1.3 compliant container:
JSTL
1.0.x
|
JSTL
1.0.x
|
Jaxen
1.0
|
Saxpath
1.0
|
|
Jakarta
Commons
|
commons-beanutils.jar
|
commons-digester.jar
|
commons-logging.jar
|
|
Jakarta
Commons Bean Utils 1.6
|
Jakarta
Commons Digester 1.5
|
Jakarta
Commons Logging 1.0.3
|
|
Client Versions
You should use the following clients in order to properly view the
JavaServer Faces Demo web applications:
Client
|
Version
|
Netscape
|
7.0+
|
Mozilla
|
1.2+
|
Internet
Explorer
|
6.0+
|
|
Print-friendly Version
