Return-Path: 
 <dev-return-35424-apmail-struts-dev-archive=struts.apache.org@struts.apache.org>
Delivered-To: apmail-struts-dev-archive@www.apache.org
Received: (qmail 63387 invoked from network); 19 Jun 2005 06:51:15 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199)
  by minotaur.apache.org with SMTP; 19 Jun 2005 06:51:15 -0000
Received: (qmail 96430 invoked by uid 500); 19 Jun 2005 06:51:11 -0000
Delivered-To: apmail-struts-dev-archive@struts.apache.org
Received: (qmail 96413 invoked by uid 500); 19 Jun 2005 06:51:11 -0000
Mailing-List: contact dev-help@struts.apache.org; run by ezmlm
Precedence: bulk
List-Unsubscribe: <mailto:dev-unsubscribe@struts.apache.org>
List-Help: <mailto:dev-help@struts.apache.org>
List-Post: <mailto:dev@struts.apache.org>
List-Id: "Struts Developers List" <dev.struts.apache.org>
Reply-To: "Struts Developers List" <dev@struts.apache.org>
Delivered-To: mailing list dev@struts.apache.org
Received: (qmail 96400 invoked by uid 500); 19 Jun 2005 06:51:11 -0000
Received: (qmail 96397 invoked by uid 99); 19 Jun 2005 06:51:11 -0000
X-ASF-Spam-Status: No, hits=0.2 required=10.0
	tests=NO_REAL_NAME
X-Spam-Check-By: apache.org
Received: from minotaur.apache.org (HELO minotaur.apache.org)
 (209.237.227.194)
    by apache.org (qpsmtpd/0.29) with SMTP; Sat, 18 Jun 2005 23:51:07 -0700
Received: (qmail 63366 invoked by uid 65534); 19 Jun 2005 06:50:50 -0000
Message-ID: <20050619065050.63365.qmail@minotaur.apache.org>
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable
Subject: svn commit: r191322 -
 /struts/core/trunk/doc/userGuide/building_controller.xml
Date: Sun, 19 Jun 2005 06:50:50 -0000
To: commits@struts.apache.org
From: mrdon@apache.org
X-Mailer: svnmailer-1.0.2
X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N

Author: mrdon
Date: Sat Jun 18 23:50:48 2005
New Revision: 191322

URL: http://svn.apache.org/viewcvs?rev=3D191322&view=3Drev
Log:
Adding a listing and description of all possible attributes for the
exception element.  Also included a description of what happens when no
'handler' attribute is specified.

PR: 14068

Modified:
    struts/core/trunk/doc/userGuide/building_controller.xml

Modified: struts/core/trunk/doc/userGuide/building_controller.xml
URL: http://svn.apache.org/viewcvs/struts/core/trunk/doc/userGuide/building=
_controller.xml?rev=3D191322&r1=3D191321&r2=3D191322&view=3Ddiff
=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=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D
--- struts/core/trunk/doc/userGuide/building_controller.xml (original)
+++ struts/core/trunk/doc/userGuide/building_controller.xml Sat Jun 18 23:5=
0:48 2005
@@ -972,6 +972,122 @@
     The <code>key</code> is a key into your message resources properties f=
ile=20
     that can be used to retrieve an error message.
     </p>
+    <p>
+    If the <code>handler</code> attribute is not specified, the default ha=
ndler
+    stores the exception in the request attribute under the value of the=20
+    <code>Globals.EXCEPTION_KEY</code> global key.
+    </p>
+
+    <p>
+    The possible attributes for the "exception" element are as follows:
+    </p>
+    <table>
+    <tr>
+        <th>Attribute</th>
+        <th>Description</th>
+        <th>Default</th>
+    </tr>   =20
+    <tr>
+        <td>
+        <code>bundle</code>
+        </td>
+        <td>
+            Servlet context attribute for the message resources bundle
+            associated with this handler. The default attribute is the
+            value specified by the string constant declared at
+            <code>Globals.MESSAGES_KEY</code>.
+        </td>
+        <td>
+            <code>org.apache.struts.Globals.MESSAGES_KEY</code>
+        </td>
+    </tr>
+    <tr>
+        <td>
+        <code>className</code>
+        </td>
+        <td>
+            The configuration bean for this ExceptionHandler object.
+            If specified, className must be a subclass of the default
+            configuration bean
+        </td>
+        <td>
+            "<code>org.apache.struts.config.ExceptionConfig</code>"
+        </td>
+    </tr>
+    <tr>
+        <td>
+        <code>extends</code>
+        </td>
+        <td>
+            The name of the exception handler that this=20
+            will inherit configuration information from.
+        </td>
+        <td>
+            None
+        </td>
+    </tr>
+    <tr>
+        <td>
+        <code>handler</code>
+        </td>
+        <td>
+            Fully qualified Java class name for this exception handler.
+        </td>
+        <td>
+            "<code>org.apache.struts.action.ExceptionHandler</code>"
+        </td>
+    </tr>
+    <tr>
+        <td>
+        <code>key</code>
+        </td>
+        <td>
+            The key to use with this handler's message resource bundle
+            that will retrieve the error message template for this
+            exception.
+        </td>
+        <td>
+            None
+        </td>
+    </tr>
+    <tr>
+        <td>
+        <code>path</code>
+        </td>
+        <td>
+            The module-relative URI to the resource that will complete
+            the request/response if this exception occurs.
+        </td>
+        <td>
+            None
+        </td>
+    </tr>
+    <tr>
+        <td>
+        <code>scope</code>
+        </td>
+        <td>
+            The context ("request" or "session") that is used to access
+            the ActionError object [org.apache.struts.action.ActionError]
+            for this exception.
+        </td>
+        <td>
+            "<code>request</code>"
+        </td>
+    </tr>
+    <tr>
+        <td>
+        <code>type</code>
+        </td>
+        <td>
+            Fully qualified Java class name of the exception type to
+            register with this handler.
+        </td>
+        <td>
+            None
+        </td>
+    </tr>
+    </table>
    =20
     <p>
     You can override global exception handlers by defining a handler insid=
e an=20



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org