ICEfaces® v2.0 Alpha 1

Release Notes

October 30th, 2009

ICEfaces Logo


This document contains the following sections:

About This Release

ICEfaces v2.0 Alpha 1 is an early developer milestone for the next-generation of ICEfaces, designed for JSF 2.0.

Review the Known Issues prior to using this release. Review the Migration Notes if you plan to port an existing ICEfaces 1.x application with 2.0 Alpha 1.

This release includes the following:

ICEfaces 2.0 Core

The new ICEfaces 2.0 ("Glimmer") core is suitable for deployment to any JSF 2.0.1 runtime environment. By deploying the icefaces.jar in a JSF 2 application you can immediately benefit from ICEfaces Direct-to-Dom architecture, with all page updates becoming smooth partial-page updates without requiring use of the JSF 2 f:ajax tag (of course, using f:ajax works also).

Internally, the changes are significant, and many simplifications were possible within ICEfaces through use of the standard JSF Ajax features (such as PartialViewContext and jsf.js). For the application developer, though, the major changes at this point lie with JSF 2.0 itself. For instance, two significant benefits from JSF 2.0 are that Facelets is now standard, and that you have the option to use annotations rather than faces-config.xml for managed bean definitions.

Notable Changes

Configuration Tips

Note that the new ICEfaces core is not directly backwards compatible with ICEfaces 1.x applications. Anyone wanting to port and existing ICEfaces 1.x application to ICEfaces 2.0 should see the following section on "ICEfaces 1.x Compatibility Support".

ICEfaces 1.x Compatibility Support

To ease the effort required to port existing ICEfaces 1.x applications to the JSF2/ICEfaces 2.0 this release includes the following backwards-compatibility features:

ICEfaces 1.8 Compatibility APIs

ICEfaces 1.8 Compatible Component Suite

Sample Applications

The following sample applications are included:

Runtime Dependencies

This release requires the following:

Known Issues

The following section describes the most commonly encountered known issues with this release:


Open source community support is available at

About ICEfaces

ICEfaces delivers extensions to Java ServerFaces (JSF) that provide an AJAX-enabled rich presentation environment for JSF applications. ICEfaces brings value to any Java EE development project that needs to provide superior presentation capabilities to the web application user. In particular, ICEfaces provides the following features:

License Notice

License agreements can be found in the .../install_dir/icefaces/docs/license directory.

© Copyright 2005-2009 ICEsoft Technologies, Inc.