cvs commit: jakarta-servletapi/src/share/javax/servlet/jsp JspException.java

[ed...@locus.apache.org]

eduardop    00/10/11 17:29:52

  Modified:    src/share/javax/servlet/jsp Tag: SERVLET_23_JSP_12
                        JspException.java
  Log:
  Added methods and constructors to provide rootCause
  
  Revision  Changes    Path
  No                   revision
  
  
  No                   revision
  
  
  1.1.1.1.4.2 +75 -1     jakarta-servletapi/src/share/javax/servlet/jsp/JspException.java
  
  Index: JspException.java
  ===================================================================
  RCS file: /home/cvs/jakarta-servletapi/src/share/javax/servlet/jsp/JspException.java,v
  retrieving revision 1.1.1.1.4.1
  retrieving revision 1.1.1.1.4.2
  diff -u -r1.1.1.1.4.1 -r1.1.1.1.4.2
  --- JspException.java	2000/08/24 21:05:23	1.1.1.1.4.1
  +++ JspException.java	2000/10/12 00:29:52	1.1.1.1.4.2
  @@ -62,17 +62,91 @@
    */
   
   public class JspException extends Exception {
  +
  +    private Throwable rootCause;
  +
  +
       /**
        * Construct a JspException
        */
       public JspException() {
       }
   
  +
       /**
  -     * An exception with a message
  +     * Constructs a new JSP exception with the
  +     * specified message. The message can be written 
  +     * to the server log and/or displayed for the user. 
  +     *
  +     * @param msg 		a <code>String</code> 
  +     *				specifying the text of 
  +     *				the exception message
  +     *
        */
       public JspException(String msg) {
   	super(msg);
       }
   
  +
  +    /**
  +     * Constructs a new JSP exception when the JSP 
  +     * needs to throw an exception and include a message 
  +     * about the "root cause" exception that interfered with its 
  +     * normal operation, including a description message.
  +     *
  +     *
  +     * @param message 		a <code>String</code> containing 
  +     *				the text of the exception message
  +     *
  +     * @param rootCause		the <code>Throwable</code> exception 
  +     *				that interfered with the servlet's
  +     *				normal operation, making this servlet
  +     *				exception necessary
  +     *
  +     */
  +    
  +    public JspException(String message, Throwable rootCause) {
  +	super(message);
  +	this.rootCause = rootCause;
  +    }
  +
  +
  +    /**
  +     * Constructs a new JSP exception when the JSP 
  +     * needs to throw an exception and include a message
  +     * about the "root cause" exception that interfered with its
  +     * normal operation.  The exception's message is based on the localized
  +     * message of the underlying exception.
  +     *
  +     * <p>This method calls the <code>getLocalizedMessage</code> method
  +     * on the <code>Throwable</code> exception to get a localized exception
  +     * message. When subclassing <code>JspException</code>, 
  +     * this method can be overridden to create an exception message 
  +     * designed for a specific locale.
  +     *
  +     * @param rootCause 	the <code>Throwable</code> exception
  +     * 				that interfered with the JSP's
  +     *				normal operation, making the JSP exception
  +     *				necessary
  +     *
  +     */
  +
  +    public JspException(Throwable rootCause) {
  +	super(rootCause.getLocalizedMessage());
  +	this.rootCause = rootCause;
  +    }
  +
  +    
  +    /**
  +     * Returns the exception that caused this JSP exception.
  +     *
  +     *
  +     * @return			the <code>Throwable</code> 
  +     *				that caused this JSP exception
  +     *
  +     */
  +    
  +    public Throwable getRootCause() {
  +	return rootCause;
  +    }
   }