Developer’s Guide
Version 1.8
Copyright
Copyright 2005-2009. ICEsoft Technologies, Inc. All rights reserved.
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
ICEfaces Developer’s Guide v1.8
iii
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
iv
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 information about
supported browsers, application servers, portal containers, and IDEs can also be found in this
document.
• ICEfaces Getting Started Guide — Includes information to help you configure your environment to
run sample applications and a tutorial designed to help you get started as quickly as possible using
ICEfaces technology.
ICEfaces Technical Support
For more information about ICEfaces, visit the ICEfaces Technical Support page at:
http://support.icefaces.org/
v
ICEfaces Developer’s Guide v1.8
Contents
Copyright . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .ii
About this Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii
Chapter 1 Introduction to ICEfaces . . . . . . . . . . . . . . . . . . . . . . . . .1
Chapter 2 ICEfaces System Architecture . . . . . . . . . . . . . . . . . . . . .3
Chapter 3 Key Concepts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5
Direct-to-DOM Rendering . . . . . . . . . . . . . . . . . . . . . . . . . . .6
Incremental, In-place Page Updates . . . . . . . . . . . . . . . . . . .8
Synchronous and Asynchronous Updates . . . . . . . . . . . . . . . .9
Connection Management . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Server-initiated Rendering (Ajax Push) . . . . . . . . . . . . . . . . 12
Partial Submit – Intelligent Form Processing . . . . . . . . . . . . 13
Components and Styling . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Cascading Style Sheets (CSS) Styling . . . . . . . . . . . . . . 15
Other Custom Components . . . . . . . . . . . . . . . . . . . . . 16
Drag and Drop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Effects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Browser-Invoked Effects . . . . . . . . . . . . . . . . . . . . . . . 18
Concurrent DOM Views . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Integrating ICEfaces With Existing Applications . . . . . . . . . . 21
JSP Inclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
JSF Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Facelets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Chapter 4 ICEfaces Reference Information . . . . . . . . . . . . . . . . . .23
JSP Markup Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Java API Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
JavaScript API Reference . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Partial and Full Submit . . . . . . . . . . . . . . . . . . . . . . . . 26
View Removal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Bridge Connection Status Events . . . . . . . . . . . . . . . . . 27
Configuration Reference . . . . . . . . . . . . . . . . . . . . . . . . . . 29
评论0