RichFaces Developer Guide
iii
1. Introduction ................................................................................................................... 1
2. Technical Requirements ................................................................................................. 3
2.1. Supported Java Versions .................................................................................... 3
2.2. Supported JavaServer Faces Implementations and Frameworks ............................ 3
2.3. Supported Servers .............................................................................................. 3
2.4. Supported Browsers ............................................................................................ 4
3. Getting Started with RichFaces ...................................................................................... 5
3.1. Downloading the RichFaces ................................................................................ 5
3.2. Simple JSF application with RichFaces ................................................................ 5
3.2.1. Adding RichFaces libraries into the project ................................................ 5
3.2.2. Registering RichFaces in web.xml ............................................................. 6
3.2.3. Managed bean ......................................................................................... 8
3.2.4. Registering bean in faces-cofig.xml ........................................................... 8
3.2.5. RichFaces Greeter index.jsp ..................................................................... 9
3.3. Integration of RichFaces into Maven Project ....................................................... 10
3.4. Relevant Resources Links ................................................................................. 16
4. Settings for different environments ................................................................................ 17
4.1. Web Application Descriptor Parameters .............................................................. 17
4.2. Sun JSF RI ...................................................................................................... 20
4.3. Apache MyFaces .............................................................................................. 20
4.4. Facelets Support ............................................................................................... 21
4.5. JBoss Seam Support ........................................................................................ 21
4.6. Portlet Support .................................................................................................. 25
4.7. Sybase EAServer .............................................................................................. 25
4.8. Oracle AS/OC4J ............................................................................................... 25
5. Basic concepts of the RichFaces Framework ................................................................ 27
5.1. Introduction ....................................................................................................... 27
5.2. RichFaces Architecture Overview ....................................................................... 28
5.3. Partial Rendering .............................................................................................. 31
5.4. RichFaces Integral Parts ................................................................................... 31
5.5. Limitations and Rules ........................................................................................ 32
5.6. Ajax Request Optimization ................................................................................. 32
5.6.1. Re-Rendering ......................................................................................... 32
5.6.2. Queue and Traffic Flood Protection ......................................................... 34
5.6.3. Queue Principles .................................................................................... 35
5.6.4. Data Processing Options ........................................................................ 41
5.6.5. Action and Navigation ............................................................................. 42
5.6.6. JavaScript Interactions ............................................................................ 42
5.6.7. Iteration components Ajax attributes ........................................................ 44
5.6.8. Other useful attributes ............................................................................ 44
5.6.9. Common Ajax Attributes ......................................................................... 45
5.7. How To... ......................................................................................................... 55
5.7.1. Send an Ajax request ............................................................................. 55
5.7.2. Decide What to Send ............................................................................. 56