MyFaces

!Getting started
!!!What you need
* JDK 1.4.x
* Tomcat 4.x or 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))
!!!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].
!!!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.
* 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"%>