cvs commit: cocoon-2.1/src/blocks/jsp/java/org/apache/cocoon/components/jsp JSPEngine.java

[unico]

unico       2004/01/16 05:46:43

  Modified:    src/blocks/jsp/java/org/apache/cocoon/components/jsp
                        JSPEngine.java
  Log:
  documentation improvements; Servlets don't thorw SAXExceptions; more explicit 
declaration
  
  Revision  Changes    Path
  1.3       +13 -17    
cocoon-2.1/src/blocks/jsp/java/org/apache/cocoon/components/jsp/JSPEngine.java
  
  Index: JSPEngine.java
  ===================================================================
  RCS file: 
/home/cvs/cocoon-2.1/src/blocks/jsp/java/org/apache/cocoon/components/jsp/JSPEngine.java,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- JSPEngine.java    7 Jun 2003 23:01:48 -0000       1.2
  +++ JSPEngine.java    16 Jan 2004 13:46:43 -0000      1.3
  @@ -50,38 +50,34 @@
   */
   package org.apache.cocoon.components.jsp;
   
  -import org.apache.avalon.framework.component.Component;
  -import org.xml.sax.SAXException;
  -
   import javax.servlet.ServletContext;
   import javax.servlet.ServletException;
   import javax.servlet.http.HttpServletRequest;
   import javax.servlet.http.HttpServletResponse;
  +
   import java.io.IOException;
   
   /**
  - * A component for loading and running JSP.
  + * A component for loading and running Servlets and JSPs.
    *
    * @author <a href="mailto:[EMAIL PROTECTED]">Davanum Srinivas</a>
    * @version CVS $Id$
    */
  -public interface JSPEngine extends Component {
  -
  -    String ROLE = JSPEngine.class.getName();
  +public interface JSPEngine {
   
  +    public static final String ROLE = JSPEngine.class.getName();
  +    
       /**
  -     * Execute the JSP and return the output.
  +     * Execute the Servlet/JSP and return the output.
        * Output of the JSPEngine <b>must</b> be in UTF8 encoding.
  -     *
  -     * @param context The Servlet Context
  +     * 
        * @exception IOException
        * @exception ServletException
  -     * @exception SAXException
        * @exception Exception
        */
  -    byte[] executeJSP(String url,
  -                       HttpServletRequest request,
  -                       HttpServletResponse response,
  -                       ServletContext context)
  -        throws IOException, ServletException, SAXException, Exception;
  +    public byte[] executeJSP(String url,
  +                             HttpServletRequest request,
  +                             HttpServletResponse response,
  +                             ServletContext context)
  +        throws IOException, ServletException, Exception;
   }