From richfaces-svn-commits at lists.jboss.org Wed Oct 3 06:09:53 2007 Content-Type: multipart/mixed; boundary="===============8604468627300783054==" MIME-Version: 1.0 From: richfaces-svn-commits at lists.jboss.org To: richfaces-svn-commits at lists.jboss.org Subject: [richfaces-svn-commits] JBoss Rich Faces SVN: r3210 - trunk/docs/userguide/en/src/main/docbook/modules. Date: Wed, 03 Oct 2007 06:09:52 -0400 Message-ID: --===============8604468627300783054== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: vkorluzhenko Date: 2007-10-03 06:09:52 -0400 (Wed, 03 Oct 2007) New Revision: 3210 Modified: trunk/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml Log: http://jira.jboss.com/jira/browse/RF-1049 - added new section "Filter confi= guration" Modified: trunk/docs/userguide/en/src/main/docbook/modules/RFCarchitectover= .xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- trunk/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml 2= 007-10-03 10:00:36 UTC (rev 3209) +++ trunk/docs/userguide/en/src/main/docbook/modules/RFCarchitectover.xml 2= 007-10-03 10:09:52 UTC (rev 3210) @@ -53,9 +53,11 @@ Ajax Filter. To get all benefits of RichFaces, you sho= uld register a Filter in - web.xml file of your application. The Filter recognizes multiple r= equest types. The sequence - diagram on Figure 3 shows the difference in processing of a "= regular" JSF - request and an Ajax request. + web.xml file of your application. The Filter recognizes multiple r= equest types. Necessary + information about Filter configuration can be found in the "Filter configuration"= section. The + sequence diagram on Figure 3 shows the difference in processing of= a + "regular" JSF request and an Ajax request. In the first case the whole JSF tree will be encoded, in the sec= ond one option it depends on the "size" of the Ajax region. As you can see, in the s= econd case the @@ -262,6 +264,122 @@ + +
+ + Filter Configuration + RichFaces uses filters for a correction of code received on an A= jax request. In case of a + "regular" JSF request a browser makes correction independe= ntly. In case of + Ajax request in order to prevent layout destruction it's needed= to use filters, + because a received code could differ from a code validated by a brow= ser and a browser doesn't + make any corrections. + + In RichFaces 3.1 filter configuration becomes more flexible. The= re is no need to select + between two different filters (Filter or Fast Filter) for the whole = application as it was + earlier. Now it's possible to configure different filters for d= ifferent sets of pages + for the same application. The previous variants of configuration for= the Filter and Fast + Filter are also available for backward compatibility (examples are p= laced below). + + The first one: + + Example: + + + + RichFaces Filter + richfaces + org.ajax4jsf.Filter + +... +]]> + + The second one: + + Example: + + + + RichFaces FastFilter + richfaces + org.ajax4jsf.FastFilter + +... +]]> + + In RichFaces 3.1 the possible filter types are: + + + + TIDY + + + + Tidy filter corresponds to the former "Filter". This f= ilter is + recommended for applications with complicated or non-standard markup= when all necessary code + corrections are made by the filter when a response comes from the se= rver. + + + + NEKO + + + + Neko filter corresponds to the former "Fast Filter". I= n case of using + this filter code isn't strictly verified. Use this one if you a= re sure that your + application markup is really strict for this filter. Otherwise it co= uld cause lot's + of errors and corrupt a layout as a result. This filter considerably= accelerates all Ajax + requests processing. + + + + NONE + + + + No correction. + + An example of configuration is placed below. + + Example: + + + + org.ajax4jsf.xmlparser.ORDER + NONE,NEKO,TIDY + + = + + org.ajax4jsf.xmlparser.NONE + /pages/performance\.xhtml,/pages/default.*\.xhtml + + + + org.ajax4jsf.xmlparser.NEKO + /pages/repeat\.xhtml + + = + = + RichFaces Filter = + richfaces = + org.ajax4jsf.Filter = + + = + = + richfaces = + Faces Servlet + FORWARD = + REQUEST + INCLUDE = + +... +]]> + +
+ +
Request Errors and Session Expiration Handling --===============8604468627300783054==--