[portal-commits] JBoss Portal SVN: r10799 - docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules.

Author: mmcallis Date: 2008-05-23 00:35:49 -0400 (Fri, 23 May 2008) New Revision: 10799 Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/errorhandling.xml Log: 8.2.1. Policy Delegation and Cascading - revising Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/errorhandling.xml =================================================================== --- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/errorhandling.xml 2008-05-23 01:57:33 UTC (rev 10798) +++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/errorhandling.xml 2008-05-23 04:35:49 UTC (rev 10799) @@ -44,21 +44,38 @@ </para> </sect1> <sect1> - <title>Control policies</title> - <para>When an error occurs, the request control flow changes according to the configuration. The configuration - is also called <emphasis>control policy</emphasis>.</para> + <title>Control Policies</title> + <para>If an error occurs, the request control-flow changes according to the configuration. This configuration is known as the <emphasis>control policy</emphasis>.</para> <sect2> - <title>Policy delegation and cascading</title> - <para>Whenever a control policy is invoked it is possible to change the response sent - by the control flow. If the control policy ignores the error then the next policy will handle the error - at this turn. However if the control policy decides to provide a new response then the next policy - will not be invoked since the new response will not be of type error. For instance, if a portlet part of a - page produces an exception, the following reactions are possible: + <title>Policy Delegation and Cascading</title> + <para> + When the control policy is invoked, the response sent by the control flow can be changed. If the control policy ignores the error, the error is handled by the next policy. If the control policy provides a new response, the next policy is not invoked, since the new response will not be an error. + </para> + <para> + If a portlet in a page produces an exception, the following reactions are possible: + </para> + <para> <itemizedlist> - <listitem>The error is displayed in the window</listitem> - <listitem>The window is removed from the aggregation</listitem> - <listitem>An portal error page is displayed</listitem> - <listitem>An HTTP 500 error response is sent to the browser</listitem> + <listitem> + <para> + the error is displayed in the window. + </para> + </listitem> + <listitem> + <para> + the window is removed from the aggregation. + </para> + </listitem> + <listitem> + <para> + a portal error page is displayed. + </para> + </listitem> + <listitem> + <para> + a HTTP 500 error response is sent to the Web browser. + </para> + </listitem> </itemizedlist> </para> </sect2>