Details
-
Type: Improvement
-
Status: Closed
-
Priority: Minor
-
Resolution: Fixed
-
Affects Version/s: 1.7DR#2
-
Fix Version/s: 1.7
-
Component/s: Sample Apps
-
Labels:None
-
Environment:n/a
-
ICEsoft Forum Reference:
-
Affects:Sample App./Tutorial
Description
The web.xml files for all sample apps. and tutorials, etc. included in the ICEfaces bundle need to be reviewed to make sure they reference current config. parameters.
For each web.xml file:
1. Check to see that the web.xml is not using obsolete parameters. Refer to the 1.7 RC1 Developer's Guide, Appendix B. It shows all the valid ICEfaces config. parameters. Anything 'com.icesoft.faces' that's not in this list should be removed. Note that we've had reports specifically that a defunct debugDOMUpdate parameter still appears (like a ghost) in some from web.xml files.
2. Add the following commented-out config params to the web-xml to better advertise their availability to users:
Synchronous apps:
- connectionTimeout
- concurrentDOMViews (should be present in most if not all apps. already)
Async. apps:
- concurrentDOMViews (should be present in most if not all apps. already)
- connectionTimeout
- blockingConnectionTimeout
- heartbeatInterval
- heartbeatRetries
- heartbeatTimeout
- connectionLostRedirectURI (note that the app. must use outputConnectionStatus comp. for this setting to work)
3. Test build the samples to ensure they run as expected after editing.
For each web.xml file:
1. Check to see that the web.xml is not using obsolete parameters. Refer to the 1.7 RC1 Developer's Guide, Appendix B. It shows all the valid ICEfaces config. parameters. Anything 'com.icesoft.faces' that's not in this list should be removed. Note that we've had reports specifically that a defunct debugDOMUpdate parameter still appears (like a ghost) in some from web.xml files.
2. Add the following commented-out config params to the web-xml to better advertise their availability to users:
Synchronous apps:
- connectionTimeout
- concurrentDOMViews (should be present in most if not all apps. already)
Async. apps:
- concurrentDOMViews (should be present in most if not all apps. already)
- connectionTimeout
- blockingConnectionTimeout
- heartbeatInterval
- heartbeatRetries
- heartbeatTimeout
- connectionLostRedirectURI (note that the app. must use outputConnectionStatus comp. for this setting to work)
3. Test build the samples to ensure they run as expected after editing.
Another config. param that we should add to all sample/tutorial app web.xml files follows:
<!-- ConfigureListener is not generally required. Due to an apparent bug in Tomcat users have reported seeing the following error "SEVERE: ICEfaces could not initialize JavaServer Faces. Please check that the JSF .jar files are installed correctly.". Specifying the ConfigureListener resolves the issue. -->
<listener>
<listener-class>
com.sun.faces.config.ConfigureListener
</listener-class>
</listener>