Mojarra 2.0.0 Release Notes
Release Notes
Specification Version: 2.0
Implementation Version: 2.0
This document contains information that should help you use this software library more effectively. See the
JSF FAQ for additional information.
Java
TM
2 Platform, Standard Edition (J2SE
TM
) Requirements
This release of JSF requires
J2SE 5.0 or higher.
Webtier Specification Requirements
This release of JSF requires:
General Comments on the Mojarra 2.0.0 Release
This release should be considered feature complete with respect to the
requirements of the JavaServer Faces 2.0 Propose Final Draft (PFD).
However, there are cases where the implementation has made changes or
contains features that are relevant to the 2.0.
When such cases are encountered, please refer to API documentation included
with the bundle instead of the public PFD offering.
Identifying the JAR Files
| JAR File |
Description |
| jsf-api.jar |
This JAR contains all of the public APIs as described by the specification. |
| jsf-impl.jar |
This JAR contains the runtime implementation per the specification. |
Installing Mojarra 2.0.0 on GlassFish v2
- download the Mojarra 2.0.0 binary bundle from the project page
- backup your existing jsf-impl.jar found in GF_HOME/lib
- copy the new jsf-api and jsf-impl JARs to GF_HOME/lib
- edit your GF_HOME/domains/<domain-name>/config/domain.xml
and add (or update the existing classpath-prefix)
'classpath-prefix="${com.sun.aas.installRoot}/lib/jsf-api.jar"
to the java-config element
- restart your server
Installing Mojarra 2.0.0 on GlassFish v3 (including GlassFish Prelude)
Mojarra 2.0.0 is installed using the Updatetool included with GlassFish. However, due to the still-evolving
nature of the updatetool software, some special steps are required. These steps will be considerably
eased in future releases
- Start up the updatetool in your GlassFish distribution (it's found in the top level bin directory), and select the appropriate image. (If you only have one version of GlassFish installed, you'll only see a single image.)
- On the top menu, select "View", then ensure that the "View all versions" menuitem is checked by selecting it. (This will enable you to see the new version of JSF, otherwise it's hidden.)
- On the left nav bar, select "Available Updates". You should now see one or more entries on the right labeled "JSF implementation". Select (i.e., check the box) of the one with the highest number. Press the "Update" button on the lower right.
- You will now see a license agreement - press "Accept" if you accept the agreement.
- Restart the server.
Uninstalling Mojarra 2.0.0 on GlassFish v3 (including GlassFish Prelude)
It is critical when uninstalling Mojarra 2.0.0 RC, that you also reinstall the 1.2 version of JSF. The admin console of glassfish requires JSF to function correctly.
- Start up the updatetool in your GlassFish distribution (it's found in the top level bin directory), and select the appropriate image. (If you only have one version of GlassFish installed, you'll only see a single image.)
- On the top menu, select "View", then ensure that the "View all versions" menuitem is checked by selecting it. (This will enable you to see the previous versions of JSF, otherwise they're hidden.)
- On the left nav bar, select "Installed Components". You should now see an entry on the right labeled "JSF implementation". Select (i.e., check the box) of that entry. Press the "Remove" button on the lower right. You will be shown a list of what components you are removing - it will say "glassfish-jsf (2.0.0-somebuildnumber)". Be sure that you've selected the correct one, and press "OK". You've now uninstalled JSF2.0, but you still need to reinstall JSF 1.2.
- On the left nav bar, select "Available Add-Ons". On the right pane, find and select "Glassfish JSF", with a version number of 1.2.10 (or greater - you're looking for 1.2). Press the "Install" button on the lower right.
- You will now see a license agreement - press "Accept" if you accept the agreement.
- Restart the server.
Configuring your web application to use Mojarra 2.0.0 RC
NOTE: JSP-based JSF 1.2 applications should deploy and run
without issue using Mojarra 2.0.0 PFD, however, the bulk of the new
features defined will only work with Facelets (specifically the Facelets
implementation included in jsf-impl.jar). If you decided to test your
existing Facelets-based JSF 1.2 application, make sure you do not
include the jsf-facelets.jar with your application.
With JSF 2.0, there is now a set of rules that are followed to determine whe
the Facelets included with Mojarra 2.0.0 will be disabled. See the following list:
-
if /WEB-INF/faces-config.xml is versioned at 1.2 or older, JSF 2.0
Facelets will not be used. Make sure the version and web-facesconfig.xml
schema reference are versioned at 2.0
-
If any of the faces-config.xml files reference the com.sun.facelets.FaceletViewHandler,
JSF 2.0 Facelets will not be used. This allows for easy migration compatibility
for those applications that have direct dependencies on Facelet classes.
With the release of JSF 2.0, it is possible to use both JSP and Facelets in the same
application using *both* prefix and extension mapping for the FacesServlet.
See the updated documentation for ViewHandler.DEFAULT_SUFFIX_PARAM for details
on how the new algorithm works.
Change Log
Known Issues