| !Getting started
|
| -!!!What you need
|
| -* JDK 1.4.x
|
| -* Tomcat 4.x or 5.x
|
| +!!!What you need for the Examples Application
|
| +* Tomcat 5.x
|
| + - Get it from [http://jakarta.apache.org/tomcat/index.html])
|
| -* MyFaces binary release
|
| -+ - Download the latest MyFaces ((Download|binaries))
|
| -+ (since we need Sun's jsf-api.jar we are obliged to distribute MyFaces bundled with the full reference implementation to conform to the license terms)
|
| * MyFaces examples
|
| -+ - Download the latest MyFaces ((Download|examples web application))
|
| ++ - Download the latest ((Download|MyFaces examples archive)) (myfaces-{content id=1}-examples.tgz)
|
| !!!Installing and Running the Examples
|
| -* Unpack the MyFaces binaries archive myfaces-{content id=1}.tgz to a directory of your choice.
|
| -* Unpack the MyFaces examples archive myfaces-{content id=1}-examples.tgz to the same directory.
|
| -* Remove any previous MyFaces webapps from your Tomcat installation and clean up your Tomcat work dir.
|
| -* Copy or move the directory web (in webapps/examples) to the webapps dir of your Tomcat installation directory and rename it to "myfaces".
|
| -* Copy the file "jsf-api.jar" from the bundled "{content id=3}" archive jsf-1_0.zip to the WEB-INF/lib dir of your myfaces web application directory.
|
| -* (Re)start Tomcat (there is a known log4j issue - see ((KnownIssues)) if you get errors!)
|
| -* Start your browser and go to [http://localhost:8080/myfaces].
|
| +* Unpack the MyFaces examples archive myfaces-{content id=1}-examples.tgz to a directory of your choice.
|
| +* Remove any previous MyFaces webapps from your Tomcat installation and clean up your Tomcat work dir. Also make sure that there is no jsf-api.jar or jsf-impl.jar (i.e. Suns API implementation) in the classpath or in one of Tomcat's lib directories (common/lib or shared/lib).
|
| +* Copy the file myfaces-examples.war to the webapps dir of your Tomcat installation directory - and check once more that there is no old myfaces-examples directory there ;-)
|
| +* (Re)start Tomcat
|
| +* Start your browser and enjoy it at [http://localhost:8080/myfaces-examples].
|
| +!!!Installing and Running Sun JSF-RI Samples with MyFaces
|
| +((SunJsfExamples|see detailed description))
|
| !!!Using MyFaces in your own web application
|
| * Look at the ((Compatibility|compatibility list)) to find out if your servlet container is supported.
|
| * Download the latest MyFaces ((Download|binary release)) (myfaces-{content id=1}.tgz).
|
| -* Copy the lib/myfaces.jar file to the WEB-INF/lib dir of your Webapplication.
|
| -* Copy the lib/cos.jar file to the WEB-INF/lib dir of your Webapplication.
|
| -* Copy the file "jsf-api.jar" from the bundled "{content id=3}" archive jsf-1_0.zip to the WEB-INF/lib dir of your web application.
|
| +* Copy the jar files myfaces-jsf-api.jar, myfaces.jar, jstl.jar, jakarta-oro.jar, commons-codec-1.2.jar, commons-el.jar, commons-fileupload-1.0.jar, commons-logging.jar and commons-validator.jar from the lib directory to the WEB-INF/lib dir of your Webapplication.
|
| +* If you are using a JSP 1.2 container like Tomcat 4 you must also copy the file jsp-2.0.jar to your WEB-INF/lib dir.
|
| +* Make sure that there is no jsf-api.jar (i.e. Suns API implementation) in the classpath or in one of your container's shared lib directories (e.g. common/lib or shared/lib for Tomcat).
|
| * Configure your webapp's web.xml file (see conf/web.xml for example and documentation)
|
| * Add the following lines to your JSPs:
|
| <%@ taglib uri="http://java.sun.com/jsf/html" prefix="h"%>
|
| <%@ taglib uri="http://java.sun.com/jsf/core" prefix="f"%>
|
| * To be able to use the MyFaces extensions add the following line to your JSPs:
|
| <%@ taglib uri="http://myfaces.sourceforge.net/tld/myfaces_ext_{content id=2}.tld" prefix="x"%>
|
| -
|
| - |
| +!!!Tutorials for getting started with MyFaces
|
| +* Core-Servlets JSF Tutorial by Marty Hall [http://www.coreservlets.com/JSF-Tutorial/]. |