Icefaces Developer's Guide

Developer’s Guide

Version 1.8 Copyright

The content in this guide is protected under copyright law even if it is not distributed with software that includes an end user license agreement.

The content of this guide is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by ICEsoft Technologies, Inc.

ICEsoft Technologies, Inc. assumes no responsibility or liability for any errors or inaccuracies that may appear in the informational content contained in this guide.

ICEfaces is a registered trademark of ICEsoft Technologies, Inc.

Sun, Sun Microsystems, the Sun logo, Solaris and Java are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and in other countries.

All other trademarks mentioned herein are the property of their respective owners.

ICEsoft Technologies, Inc. Suite 200, 1717 10th Street NW Calgary, Alberta, Canada T2M 4S2

Toll Free: 1-877-263-3822 (USA and Canada) Telephone: 1-403-663-3322 Fax:1-403-663-3320

For additional information, please visit the ICEfaces website: http://www.icefaces.org

ICEfaces Developer’s Guide v1.8

March 2009 About this Guide

The ICEfaces® Developer’s Guide is your manual to developing ICEfaces applications. By reading through this guide, you will: • Gain a basic understanding of what ICEfaces is and what it can do for you. • Understand key concepts related to the ICEfaces Rich Web Presentation Environment. • Examine the details of the ICEfaces architecture. • Access reference information for the following: — ICEfaces system configuration —JSF Page Markup — Java API reference — JavaScript API reference — Custom Component TLD • Learn to use advanced ICEfaces development features. For more information about ICEfaces, visit the ICEfaces website at: http://www.icefaces.org

In this guide...

This guide contains the following chapters organized to assist you with developing ICEfaces applications: Chapter 1: Introduction to ICEfaces — Provides an overview of ICEfaces describing its key features and capabilities. Chapter 2: ICEfaces System Architecture — Describes the basic ICEfaces architecture and how it plugs into the standard JSF framework. Chapter 3: Key Concepts — Explores some of the key concepts and mechanisms that ICEfaces brings to the application developer. Chapter 4: ICEfaces Reference Information — Provides additional reference information for ICEfaces implementations. Chapter 5: Advanced Topics — Introduces several ICEfaces advanced topics, such as server-initiated rendering, drag and drop, effects, Portlets, Push Server, Seam integration, Spring Framework integration, and Direct-to-DOM renderers.

ICEfaces Developer’s Guide v1.8 iii Appendix A: ICEfaces Library/App. Server Dependencies — Shows the ICEfaces library dependencies. Appendix B: ICEfaces Configuration Parameter Overview — Contains tables listing all ICEfaces parameters with their respective default values, along with brief notes on the parameter’s usage.

Prerequisites

ICEfaces applications are JavaServer Faces (JSF) applications, and as such, the only prerequisite to working with ICEfaces is that you must be familiar with JSF application development. For more information on Java Platform, Enterprise Edition (JEE), which JSF is a sub-component of, please refer to http://java.sun.com/javaee/ . Additional JSF resources can be found on the icefaces.org website.

ICEfaces Documentation

You can find the following additional ICEfaces documentation at the ICEfaces website (http://documentation.icefaces.org): • ICEfaces Release Notes — Contains information about the new features and bug fixes included in this ICEfaces release. In addition, important time-saving Known Issues and detailed infor