ICEfaces-2.0.0-Alpha3 Release Notes

You are viewing an old version (v. 10) of this page.
The latest version is v. 17, last edited on May 31, 2010 (view differences | )
<< View previous version | view page history | view next version >>

ICEfaces 2.0.0 Alpha 3 Release Notes

May 31st, 2010

About This Release

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

Notable Changes and Improvements

  • New "Delta-Submit" feature. The Delta-submit feature can greatly reduce network bandwidth requirements when submitting large forms. When enabled, ICEfaces will only submit those form elements who's values have been updated in the browser since the last update. ICEfaces will then reconstruct the complete form on the server by leveraging ICEfaces server-side DOM, resulting in a significant bandwidth reduction that is also completely transparent to the JSF lifecycle, application, and components. Delta Submit can be enabled by setting the 'org.icefaces.deltaSubmit' context parameter to 'true', and is disabled by default.
  • New Auto-ID Generation. ICEfaces will now automatically insert ID attributes on components that have not had IDs specified. This enables ICEfaces to provide a high degree of granularity for DOM updates, resulting in smaller regions of the page being updated in the browser for an improved user experience. For more information see the "AutoID" section under Advanced Configuration in the ICEfaces 2.0 Getting Started topic.
  • New Per-view Ajax Push/Asynchronous Update Mode. ICEfaces will now setup and teardown the asynchronous communication channel (asynchronous update mode, or "Ajax Push") dynamically on a per-view basis. This is useful for applications that only require Ajax Push on specific pages, such that the browser client will only maintain an open asynchronous connection if the user is actively viewing a page that requires it, resulting in reduced fixed overhead for utilizing Ajax Push and improved overall scalability for Ajax Push enabled applications.
  • *Support for *.
  • Consistent Cross-Browser Support for "Submit On Enter". A user pressing the "Enter" key while focussed on an input component ("h:", "ice:", or other) will result in the form that contains the component being submitted, regardless of the browser being used (assuming the component itself doesn't
  • Revised Single-Submit Client APIs. The ICEfaces JavaScript APIs for Single-Submit (primarily used by components) have been revised. The "ice.singleSubmit()" / "" functions have been replaced with two new functions, "" and "ice.ser()". See the JavaScript Client API documentation for details.
  • Improved Mojarra JSF v2.0.2 Support. This release includes improved JSF 2.0 compatibility, including special workarounds for several bugs in Mojarra JSF 2.0.2, including an issue that prevented reliable navigation between ICEfaces and non-ICEfaces pages, and improper rendering of ice:debug and ice:message(s) components when used with ICEfaces. Note that these Mojarra issues are expected to be resolved in the upcoming JSF 2.0.3 release. In addition, the Mojarra 2.0.2 JSF unit-tests now pass with ICEfaces configured.
  • General Bug Fixes. Lots of bugs squashed since Alpha 2.

For a complete list of all changes in this release, see the related JIRA Change Log.

Known Issues

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


  • JSPs are not supported by ICEfaces 2.0, use Facelets instead.
  • Due to a bug in the Sun Mojarra JSF 2 runtime library, navigation between ICEfaces and non-ICEfaces pages is not working in this release.
    It is anticipated that the upcoming Mojarra JSF v2.0.3 release will correct this issue.
    See ICE-5157 for details.
  • In some cases an NullPointerException may be logged against the org.icefaces.application.WindowScopeManager.
    This runtime error can be safely ignored.

1.8.x Compatibility

  • The ice:inputFile component in the ICEfaces 1.8.2 Component Suite is not functional in this release.
  • The following ICEfaces 1.8.2 Component Suite components are deprecated for ICEfaces 2.0 and are not functional.
    JSF 2.0 provides suitable replacements for these that should be used instead.
    • ice:outputDeclaration (use Facelets standard approach instead)
    • ice:outputBody (use h:body instead)
    • ice:outputHead (use h:head instead)
    • ice:outputHtml (use <HTML> tag instead)
  • The "ice:form" component must be used (in place of "h:form") when using the "ice" components via the ICEfaces 1.8 Compatibility components. See ICE-5090 for details.
  • Due to a bug in the Sun Mojarra JSF 2 runtime library, component binding does not work when used within a View scope with the partial submit feature provided by the ICEfaces 1.8 compatibility library. See ICE-5226 for details.


  • ICEpush is limited to a single push application per server in this release. Viewing multiple ICEfaces push applications in the same browser from the same host server concurrently will result in only one of the applications having functional push capabilities.
  • Applications using the PushRender (or SessionRenderer in the compatibility library) may experience sporadic
    premature time-outs of related push groups, causing the push-updates to stop functioning. A page reload will
    correct the problem. See ICE-5227 for details.

Application Servers

  • Glassfish 3
    • When interacting with an ICEfaces 2 application on Glassfish 3, the warning below may be logged,
      with no impact on the application functionality:
      WARNING: PWC4011: Unable to set request character encoding to UTF-8 from context /basic,
       because request parameters have already been read, or ServletRequest.getReader() has already been called.
    • See JIRA-5209 for details.
  • Tomcat 6.0
    • Including icepush.jar causes exception when redeploying application on Tomcat6.0 on WinXP. See ICE-5222 for a configuration work-around.


Open source community support is available at

All questions, comments, or general discussions specific to ICEfaces 2.0 Alpha should be made in the ICEfaces Development Build Feedback forum.

Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

© Copyright 2017 ICEsoft Technologies Canada Corp.