9.3. Configuration using XML Descriptors

Different policies are configured using portal object properties, allowing the error-handling policy for objects to be configured in XML descriptors -- the *-object.xml files -- for a portal deployment.

9.3.1. Portal Policy Properties

A set of properties configure the behavior of the portal policy. These properties are only taken into account for objects that use the portal type. The following table represents possible portal-policy properties:

Table 9.1. 

Property Name Description Possible Values
control.portal.access_denied when access is denied ignore and jsp
control.portal.unavailable when a resource is unavailable ignore and jsp
control.portal.not_found when a resource is not found ignore and jsp
control.portal.internal_error when an unexpected error occurs ignore and jsp
control.portal.error when an expected error occurs ignore and jsp
control.portal.resource_uri the path to the JSP used for redirections a valid path to a JSP located in the portal-core.war/ directory

The following portal configuration demonstrates the use of portal-policy properties:
<portal>
   <portal-name>MyPortal</portal-name>
   ...
   <properties>
      <property>
         <name>control.portal.access_denied</name>
         <value>ignore</value>
      </property>
      <property>
         <name>control.portal.unavailable</name>
         <value>ignore</value>
      </property>
      <property>
         <name>control.portal.not_found</name>
         <value>ignore</value>
      </property>
      <property>
         <name>control.portal.internal_error</name>
         <value>jsp</value>
      </property>
      <property>
         <name>control.portal.error</name>
         <value>jsp</value>
      </property>
      <property>
         <name>control.portal.resource_uri</name>
         <value>/WEB-INF/jsp/error/portal.jsp</value>
      </property>
      ...
   </properties>
   ...
</portal>