Configuring a JSF 2 Application to Use ICEfaces
If you're just starting to build a JSF 2 application, or you've already started building one and you'd like to add ICEfaces, it's simple to do:
Add <h:head> and <h:body> tags
JSF 2 includes head and body components that can be added to the page by using the <h:head> and <h:body> tags. ICEfaces makes use of these components to automatically add certain scripts and other elements to the page, so the <h:head> and <h:body> tags are required on any pages of your application that use ICEfaces.
Include the Necessary Libraries
ICEfaces provides the following libraries:
- icefaces.jar - This is the ICEfaces core framework and is required for all applications.
- icepush.jar - Provides Ajax Push functionality for ICEfaces. This library is only required if Ajax Push functionality is required in the application. See the Ajax Push overview, and API for details.
- icefaces-ace.jar - This library contain the ACE Components. You should include this library if you want to use latest ICEfaces components in your application. See the ACE Components topic for details.
|The ICE Components require additional 3rd party libraries. See the ICE Components topic for details.|
- jsf-api.jar and jsf-impl.jar - Must be included if the application server platform you plan to run on does not already supply them. For example, JEE6-compliant platforms such as Glassfish 3 and JBoss 7 already have the JSF 2 libraries provided, but servlet-containers such as Tomcat do not.
The ICEfaces core framework (icefaces.jar), ICEpush (icepush.jar), and ACE Components (icefaces-ace.jar) do not require any additional configuration beyond what JSF 2 requires.
Simply ensure you have the FacesServlet is declared appropriately in your web.xml file:
ICE Components Configuration
The ICE Components require additional configuration steps before they can be used in your application. See the ICE Components topic for details. (ICEfaces 3.x only)
With ICEfaces there is no need for a faces-config.xml file, but if you are using one in your application or for your own components, remember to use the new schema for JSF 2:
And if you are specifying your own components, use the new Facelets Taglib schema as well:
ICEfaces provides a number of configuration parameters that need not be adjusted for typical applications, but may be useful for diagnostic purposes or in special cases. These parameters are fully documented in the Configuration section.