Save This Page
Home » apache-tomcat-6.0.26-src » org.apache » catalina » core » [javadoc | source]
org.apache.catalina.core
final class: ApplicationDispatcher [javadoc | source]
java.lang.Object
   org.apache.catalina.core.ApplicationDispatcher

All Implemented Interfaces:
    RequestDispatcher

Standard implementation of RequestDispatcher that allows a request to be forwarded to a different resource to create the ultimate response, or to include the output of another resource in the response from this resource. This implementation allows application level servlets to wrap the request and/or response objects that are passed on to the called resource, as long as the wrapping classes extend javax.servlet.ServletRequestWrapper and javax.servlet.ServletResponseWrapper.
Nested Class Summary:
protected class  ApplicationDispatcher.PrivilegedForward   
protected class  ApplicationDispatcher.PrivilegedInclude   
Constructor:
 public ApplicationDispatcher(Wrapper wrapper,
    String requestURI,
    String servletPath,
    String pathInfo,
    String queryString,
    String name) 
    Construct a new instance of this class, configured according to the specified parameters. If both servletPath and pathInfo are null, it will be assumed that this RequestDispatcher was acquired by name, rather than by path.
    Parameters:
    wrapper - The Wrapper associated with the resource that will be forwarded to or included (required)
    requestURI - The request URI to this resource (if any)
    servletPath - The revised servlet path to this resource (if any)
    pathInfo - The revised extra path information to this resource (if any)
    queryString - Query string parameters included with this request (if any)
    name - Servlet name (if a named dispatcher was created) else null
Method from org.apache.catalina.core.ApplicationDispatcher Summary:
forward,   getInfo,   include
Methods from java.lang.Object:
clone,   equals,   finalize,   getClass,   hashCode,   notify,   notifyAll,   toString,   wait,   wait,   wait
Method from org.apache.catalina.core.ApplicationDispatcher Detail:
 public  void forward(ServletRequest request,
    ServletResponse response) throws ServletException, IOException 
    Forward this request and response to another resource for processing. Any runtime exception, IOException, or ServletException thrown by the called servlet will be propogated to the caller.
 public String getInfo() 
    Return the descriptive information about this implementation.
 public  void include(ServletRequest request,
    ServletResponse response) throws ServletException, IOException 
    Include the response from another resource in the current response. Any runtime exception, IOException, or ServletException thrown by the called servlet will be propogated to the caller.