IceFaces quick installation guides
To install IceFaces components you should first download and import JAR files listed below:
xml-apis.jar
backport-util-concurrent.jar
el-api.jar
icefaces.jar
icefaces-comps.jar
xercesImpl.jar
commons-el.jar
commons-lang.jar
acegi-security.jar
el-ri.jar
icefaces-facelets.jar
jsp-api.jar
krysalis-jCharts.jar
servlet-api.jar
Be sure that you already have installed and verified installation of standard JSF library. After you import JARs, you should add couple of lines in your web.xml file:
<servlet>
<servlet-name>Persistent Faces Servlet</servlet-name>
<servlet-class>
com.icesoft.faces.webapp.xmlhttp.PersistentFacesServlet
</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet>
<servlet-name>Blocking Servlet</servlet-name>
<servlet-class>
com.icesoft.faces.webapp.xmlhttp.BlockingServlet
</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>Persistent Faces Servlet</servlet-name>
<url-pattern>*.iface</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>Persistent Faces Servlet</servlet-name>
<url-pattern>/xmlhttp/*</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>Blocking Servlet</servlet-name>
<url-pattern>/block/*</url-pattern>
</servlet-mapping>
<context-param>
<param-name>javax.faces.DEFAULT_SUFFIX</param-name>
<param-value>.iface</param-value>
</context-param>
<listener>
<listener-class>
com.icesoft.faces.util.event.servlet.ContextEventRepeater
</listener-class>
</listener>
IceFaces library uses its own servlet which can parse only XML format of JSP files. Also for configuration above you should use 'iface' prefix in URL address instead of 'faces' prefix tipical for standard JSF. Empty template JSP file will look like this:
<f:view xmlns:f="http://java.sun.com/jsf/core"
xmlns:h="http://java.sun.com/jsf/html"
xmlns:ice="http://www.icesoft.com/icefaces/component">
<html>
<head>
<link href="./xmlhttp/css/xp/xp.css"
rel="stylesheet" type="text/css"/>
<title>Title</title>
</head>
<body>
<ice:form>
YOUR CODE
</ice:form>
</body>
</html>
</f:view>
