org.eclipse.jetty.server
类 Dispatcher

java.lang.Object
  org.eclipse.jetty.server.Dispatcher

所有已实现的接口：

RequestDispatcher

public class Dispatcher
extends Object
implements RequestDispatcher

Servlet RequestDispatcher.

字段摘要

static String	__FORWARD_PREFIX Dispatch include attribute names
static String	__INCLUDE_PREFIX Dispatch include attribute names
static String	__JSP_FILE JSP attributes

从接口 javax.servlet.RequestDispatcher 继承的字段

ERROR_EXCEPTION, ERROR_EXCEPTION_TYPE, ERROR_MESSAGE, ERROR_REQUEST_URI, ERROR_SERVLET_NAME, ERROR_STATUS_CODE, FORWARD_CONTEXT_PATH, FORWARD_PATH_INFO, FORWARD_QUERY_STRING, FORWARD_REQUEST_URI, FORWARD_SERVLET_PATH, INCLUDE_CONTEXT_PATH, INCLUDE_PATH_INFO, INCLUDE_QUERY_STRING, INCLUDE_REQUEST_URI, INCLUDE_SERVLET_PATH

构造方法摘要

Dispatcher(ContextHandler contextHandler, String name)
Constructor.

Dispatcher(ContextHandler contextHandler, String uri, String pathInContext, String query)

方法摘要

void	error(ServletRequest request, ServletResponse response)
void	forward(ServletRequest request, ServletResponse response) Forwards a request from a servlet to another resource (servlet, JSP file, or HTML file) on the server.
protected void	forward(ServletRequest request, ServletResponse response, DispatcherType dispatch)
void	include(ServletRequest request, ServletResponse response) Includes the content of a resource (servlet, JSP page, HTML file) in the response.

从类 java.lang.Object 继承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细信息

__INCLUDE_PREFIX

public static final String __INCLUDE_PREFIX

Dispatch include attribute names

另请参见：

常量字段值

__FORWARD_PREFIX

public static final String __FORWARD_PREFIX

Dispatch include attribute names

另请参见：

常量字段值

__JSP_FILE

public static final String __JSP_FILE

JSP attributes

另请参见：

常量字段值

构造方法详细信息

Dispatcher

public Dispatcher(ContextHandler contextHandler,
                  String uri,
                  String pathInContext,
                  String query)

参数：

contextHandler -

uri -

pathInContext -

query -

Dispatcher

public Dispatcher(ContextHandler contextHandler,
                  String name)
           throws IllegalStateException

Constructor.

参数：

contextHandler -

name -

抛出：

IllegalStateException

方法详细信息

forward

public void forward(ServletRequest request,
                    ServletResponse response)
             throws ServletException,
                    IOException

从接口 RequestDispatcher 复制的描述

Forwards a request from a servlet to another resource (servlet, JSP file, or HTML file) on the server. This method allows one servlet to do preliminary processing of a request and another resource to generate the response.

For a RequestDispatcher obtained via getRequestDispatcher(), the ServletRequest object has its path elements and parameters adjusted to match the path of the target resource.

forward should be called before the response has been committed to the client (before response body output has been flushed). If the response already has been committed, this method throws an IllegalStateException. Uncommitted output in the response buffer is automatically cleared before the forward.

The request and response parameters must be either the same objects as were passed to the calling servlet's service method or be subclasses of the ServletRequestWrapper or ServletResponseWrapper classes that wrap them.

This method sets the dispatcher type of the given request to DispatcherType.FORWARD.

指定者：

接口 RequestDispatcher 中的 forward

参数：

request - a ServletRequest object that represents the request the client makes of the servlet

response - a ServletResponse object that represents the response the servlet returns to the client

抛出：

ServletException - if the target resource throws this exception

IOException - if the target resource throws this exception

另请参见：

ServletRequest.getDispatcherType()

error

public void error(ServletRequest request,
                  ServletResponse response)
           throws ServletException,
                  IOException

抛出：

ServletException

IOException

include

public void include(ServletRequest request,
                    ServletResponse response)
             throws ServletException,
                    IOException

从接口 RequestDispatcher 复制的描述

Includes the content of a resource (servlet, JSP page, HTML file) in the response. In essence, this method enables programmatic server-side includes.

The ServletResponse object has its path elements and parameters remain unchanged from the caller's. The included servlet cannot change the response status code or set headers; any attempt to make a change is ignored.

The request and response parameters must be either the same objects as were passed to the calling servlet's service method or be subclasses of the ServletRequestWrapper or ServletResponseWrapper classes that wrap them.

This method sets the dispatcher type of the given request to DispatcherType.INCLUDE.

指定者：

接口 RequestDispatcher 中的 include

参数：

request - a ServletRequest object that contains the client's request

response - a ServletResponse object that contains the servlet's response

抛出：

ServletException - if the included resource throws this exception

IOException - if the included resource throws this exception

另请参见：

ServletRequest.getDispatcherType()

forward

protected void forward(ServletRequest request,
                       ServletResponse response,
                       DispatcherType dispatch)
                throws ServletException,
                       IOException

抛出：

ServletException

IOException