[Myfaces Wiki] Update of "JSR-252 (JSF 1.2) Development" by StanSilvert

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Myfaces Wiki" for change notification.

The following page has been changed by StanSilvert:
http://wiki.apache.org/myfaces/JSR-252_%28JSF_1%2e2%29_Development

New page:
The MyFaces team plans to build and support a compliant, high-quality, implementation of the JSR-252 (JSF 1.2) spec that passes the JSF 1.2 TCK.  

You can get the latest public version of the JSF 1.2 spec [https://javaserverfaces-spec-public.dev.java.net/ here.]

= Jira Tasks =

All tasks related to the JSF 1.2 effort have JSR-252 in the Components field.  You can view all of the tasks [http://issues.apache.org/jira/secure/IssueNavigator.jspa?component=12310871 here.]

Every issue from the JSR-252 expert group that resulted in a spec change has been entered as a Jira task.  However, there are spec changes that don't fit neatly into a single expert group issue number.  So, some tasks might not have an EG reference.  You can browse all of the JSR-252 Expert Group issues [https://javaserverfaces-spec-public.dev.java.net/servlets/ProjectIssues here.]

= SVN =

At this moment we can't commit changes for JSF 1.2.  We are limited to research and coding on our local boxes.  A few of the simpler "bug fix" type tasks that don't break JSF 1.1 compatibility have already been committed to the main branch.  Others will need to wait until after the MyFaces 1.1.2 release.

= New JSF 1.2 Dependencies =

 *JDK 1.5 (JSE 5)
 *JSP 2.1 (click [http://java.sun.com/products/jsp/ here] for info and the spec)
 *JSTL 1.2 (click [http://java.sun.com/products/jsp/jstl/ here] for info and the spec)
 *JSF 1.2 "mostly" requires Servlet 2.5.  However, there is only one minor API change in 2.5 and it shouldn't affect JSF as long as you aren't using JSP.  It has been reported that the Sun JSF 1.2 reference implementation does work with Servlet 2.4 and Facelets. (click [http://java.sun.com/products/servlet/ here] for info and the spec)
 *JEE 5 marks the beginning of JSF inclusion in the JEE stack.  There are some enterprise features of JSF 1.2 that are required for JEE 5.  These features are not required to pass the JSF stand-alone TCK but will be required for the full JEE 5 TCK.

= Dependence on Tomcat 6 =

JSF 1.2 depends heavily on the new Unified Expression Language (Unified EL) found in JSP 2.1.  As of now, this Unified EL code has not been broken out into Apache Commons.  Therefore, MyFaces will depend on several jars in the Tomcat 6 build. The repository is at [http://svn.apache.org/repos/asf/tomcat/tc6.0.x/trunk/].

To build Tomcat 6, you will also need to get the latest version of Ant, Commons Logging, and Eclipse ADT.  

You will need version 3.1.2 or later of ADT.  If you don't want to download all of Eclipse to get it, it should be available [http://sunsite.informatik.rwth-aachen.de/eclipse/downloads/drops/R-3.1.2-200601181600/eclipse-JDT-3.1.2.zip here.]

After downloading Tomcat 6 and the dependencies above, you will need to edit build.properties.default to point to the correct jars.  Then just run ant.

Tomcat 6 does not currently include a run script, so you will need to create your own.  I was able to get it to run with this two-liner:
cd /projects/Tomcat6/trunk/build/bin (copy the ADT jar into this directory or point to it in the classpath)
java -cp commons-logging-1.0.4.jar;bootstrap.jar;org.eclipse.jdt.core_3.1.2.jar org.apache.catalina.startup.Bootstrap

The Tomcat 6 jars known to be needed for MyFaces JSF 1.2 compilation are jasper-el.jar, el-api.jar, jsp-api.jar, and jasper.jar.  If you are using an IDE, make sure that these jars come first in your classpath.  Otherwise, you are likely to be compiling against an older version of JSP, which won't work.