| !Getting started
|
| !!!What you need for the Examples Application
|
| -* JDK 1.4.x
|
| -* Tomcat 4.x or 5.x
|
| +* Tomcat 5.x
|
| + - Get it from [http://jakarta.apache.org/tomcat/index.html])
|
| * 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 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 (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.
|
| -* (Re)start Tomcat (there is a known log4j issue - see ((KnownIssues)) if you get errors!)
|
| +* 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 all jar files from the lib directory (myfaces.jar, cos.jar, jstl.jar, commons-el.jar and commons-logging.jar) to the WEB-INF/lib dir of your Webapplication.
|
| -* Make sure that there is no jsf-api.jar (i.e. Suns API implementation) in the classpath or in one of Tomcat's lib directories (common/lib or shared/lib).
|
| +* 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/]. |