geirm 01/03/19 10:05:54
Modified: xdocs developer-guide.xml
Log:
Added info re the application exceptions
Revision Changes Path
1.28 +31 -0 jakarta-velocity/xdocs/developer-guide.xml
Index: developer-guide.xml
===================================================================
RCS file: /home/cvs/jakarta-velocity/xdocs/developer-guide.xml,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- developer-guide.xml 2001/03/19 17:52:18 1.27
+++ developer-guide.xml 2001/03/19 18:05:54 1.28
@@ -912,6 +912,37 @@
template content other than template files.
</p>
+<strong>Exceptions</strong>
+<p>
+There are three exceptions that Velocity will throw during the parse / merge cycle.
+This are additional to the exceptions that will come from IO problems, etc.
+They are found in the package <code>org.apache.velocity.exception</code> and are :
+
+<ol>
+<li>
+<code>ResourceNotFoundException</code><br/>
+Thrown when the resource managment system cannot find a resource (template) that
+was requested.
+</li>
+
+<li>
+<code>ParseErrorException</code><br/>
+Thrown when a VTL syntax error is found when parsing a resource (template).
+</li>
+
+<li>
+<code>MethodInvocationException</code><br/>
+Thrown when a method of object in the context thrown an exception during
+render time. This exception wraps the thrown exception and propogates it
+to the application. This allows you to handle problems in your own objects
+at runtime.
+</li>
+</ol>
+
+In each case, a message is put into the runtime log. For more information,
+see the Javadoc API documentation.
+</p>
+
<strong>Miscellaneous Details</strong>
<p>
While the above example used the default properties, setting your own
