Spec-Zone .ru спецификации, руководства, описания, API

javax.servlet
Интерфейс RequestDispatcher

public interface RequestDispatcher

Определяет объект, который получает запросы от клиента и отправляет им любому ресурсу (такому как сервлет, файл HTML, или файл JSP) на сервере. Контейнер сервлета создает RequestDispatcher объект, который используется в качестве обертки вокруг ресурса сервера, расположенного в определенном пути или данный определенным именем.

Этот интерфейс предназначается, чтобы обернуть сервлеты, но контейнер сервлета может создать RequestDispatcher объекты обернуть любой тип ресурса.

Автор:

Различный

См. Также:

ServletContext#getRequestDispatcher(java.lang.String), ServletContext#getNamedDispatcher(java.lang.String), ServletRequest#getRequestDispatcher(java.lang.String)

Полевая Сводка

static java.lang.String	ERROR_EXCEPTION Имя запроса приписывает, под которым объект исключения распространяется во время ошибки, диспетчеризируют
static java.lang.String	ERROR_EXCEPTION_TYPE Имя запроса приписывает, под которым тип объекта исключения распространяется во время ошибки, диспетчеризируют
static java.lang.String	ERROR_MESSAGE Имя запроса приписывает, под которым сообщение об исключительной ситуации распространяется во время ошибки, диспетчеризируют
static java.lang.String	ERROR_REQUEST_URI Имя запроса приписывает, под которым, URI запроса чья обработка, вызванная, ошибка распространяется во время ошибки, диспетчеризируют
static java.lang.String	ERROR_SERVLET_NAME Имя атрибута запроса, под которым имя сервлета, в котором произошла ошибка, распространяется во время ошибки, диспетчеризирует
static java.lang.String	ERROR_STATUS_CODE Имя запроса приписывает, под которым состояние ответа распространяется во время ошибки, диспетчеризируют
static java.lang.String	FORWARD_CONTEXT_PATH Имя запроса приписывает, под которым исходный путь контекста делается доступным для цели a forward
static java.lang.String	FORWARD_PATH_INFO Имя запроса приписывает, под которым исходная информация пути делается доступной для цели a forward
static java.lang.String	FORWARD_QUERY_STRING Имя запроса приписывает, под которым исходная строка запроса делается доступной для цели a forward
static java.lang.String	FORWARD_REQUEST_URI Имя запроса приписывает, под которым исходный URI запроса делается доступным для цели a forward
static java.lang.String	FORWARD_SERVLET_PATH Имя запроса приписывает, под которым исходный путь сервлета делается доступным для цели a forward
static java.lang.String	INCLUDE_CONTEXT_PATH Имя запроса приписывает под который путь контекста цели include сохранен
static java.lang.String	INCLUDE_PATH_INFO Имя запроса приписывает под который информация пути цели include сохранен
static java.lang.String	INCLUDE_QUERY_STRING Имя запроса приписывает под который строка запроса цели include сохранен
static java.lang.String	INCLUDE_REQUEST_URI Имя запроса приписывает под который URI запроса цели include сохранен
static java.lang.String	INCLUDE_SERVLET_PATH Имя запроса приписывает под который путь сервлета цели include сохранен

Сводка метода

void	forward(ServletRequest request, ServletResponse response) Передает запрос от сервлета до другого ресурса (сервлет, файл JSP, или файл HTML) на сервере.
void	include(ServletRequest request, ServletResponse response) Включает контент ресурса (сервлет, страница JSP, файл HTML) в ответе.

Полевая Деталь

FORWARD_REQUEST_URI

static final java.lang.String FORWARD_REQUEST_URI

Имя запроса приписывает, под которым исходный URI запроса делается доступным для цели a forward

См. Также:

Постоянные Значения полей

FORWARD_CONTEXT_PATH

static final java.lang.String FORWARD_CONTEXT_PATH

Имя запроса приписывает, под которым исходный путь контекста делается доступным для цели a forward

См. Также:

Постоянные Значения полей

FORWARD_PATH_INFO

static final java.lang.String FORWARD_PATH_INFO

Имя запроса приписывает, под которым исходная информация пути делается доступной для цели a forward

См. Также:

Постоянные Значения полей

FORWARD_SERVLET_PATH

static final java.lang.String FORWARD_SERVLET_PATH

Имя запроса приписывает, под которым исходный путь сервлета делается доступным для цели a forward

См. Также:

Постоянные Значения полей

FORWARD_QUERY_STRING

static final java.lang.String FORWARD_QUERY_STRING

Имя запроса приписывает, под которым исходная строка запроса делается доступной для цели a forward

См. Также:

Постоянные Значения полей

INCLUDE_REQUEST_URI

static final java.lang.String INCLUDE_REQUEST_URI

Имя запроса приписывает под который URI запроса цели include сохранен

См. Также:

Постоянные Значения полей

INCLUDE_CONTEXT_PATH

static final java.lang.String INCLUDE_CONTEXT_PATH

Имя запроса приписывает под который путь контекста цели include сохранен

См. Также:

Постоянные Значения полей

INCLUDE_PATH_INFO

static final java.lang.String INCLUDE_PATH_INFO

Имя запроса приписывает под который информация пути цели include сохранен

См. Также:

Постоянные Значения полей

INCLUDE_SERVLET_PATH

static final java.lang.String INCLUDE_SERVLET_PATH

Имя запроса приписывает под который путь сервлета цели include сохранен

См. Также:

Постоянные Значения полей

INCLUDE_QUERY_STRING

static final java.lang.String INCLUDE_QUERY_STRING

Имя запроса приписывает под который строка запроса цели include сохранен

См. Также:

Постоянные Значения полей

ERROR_EXCEPTION

static final java.lang.String ERROR_EXCEPTION

Имя запроса приписывает, под которым объект исключения распространяется во время ошибки, диспетчеризируют

См. Также:

Постоянные Значения полей

ERROR_EXCEPTION_TYPE

static final java.lang.String ERROR_EXCEPTION_TYPE

Имя запроса приписывает, под которым тип объекта исключения распространяется во время ошибки, диспетчеризируют

См. Также:

Постоянные Значения полей

ERROR_MESSAGE

static final java.lang.String ERROR_MESSAGE

Имя запроса приписывает, под которым сообщение об исключительной ситуации распространяется во время ошибки, диспетчеризируют

См. Также:

Постоянные Значения полей

ERROR_REQUEST_URI

static final java.lang.String ERROR_REQUEST_URI

Имя запроса приписывает, под которым, URI запроса чья обработка, вызванная, ошибка распространяется во время ошибки, диспетчеризируют

См. Также:

Постоянные Значения полей

ERROR_SERVLET_NAME

static final java.lang.String ERROR_SERVLET_NAME

Имя атрибута запроса, под которым имя сервлета, в котором произошла ошибка, распространяется во время ошибки, диспетчеризирует

См. Также:

Постоянные Значения полей

ERROR_STATUS_CODE

static final java.lang.String ERROR_STATUS_CODE

Имя запроса приписывает, под которым состояние ответа распространяется во время ошибки, диспетчеризируют

См. Также:

Постоянные Значения полей

Деталь метода

передать

void forward(ServletRequest request,
             ServletResponse response)
             throws ServletException,
                    java.io.IOException

Передает запрос от сервлета до другого ресурса (сервлет, файл JSP, или файл HTML) на сервере. Этот метод позволяет одному сервлету делать предварительную обработку запроса и другого ресурса, чтобы генерировать ответ.

Для a RequestDispatcher полученный через getRequestDispatcher(), ServletRequest у объекта есть свои элементы пути и параметры, скорректированные, чтобы соответствовать путь целевого ресурса.

forward должен быть вызван прежде, чем ответ посвятил себя клиенту (прежде, чем вывод тела ответа был сброшен). Если ответ уже фиксировался, этот метод бросает IllegalStateException. Незафиксированный вывод в буфере ответа автоматически очищается перед прямым.

Запрос и параметры ответа должны быть или теми же самыми объектами, как были переданы к методу службы сервлета вызова или быть подклассами ServletRequestWrapper или ServletResponseWrapper классы, которые обертывают их.

Этот метод устанавливает тип диспетчера данного запроса к DispatcherType.FORWARD.

Параметры:

request - a ServletRequest объект, который представляет запрос клиент, делает из сервлета

response - a ServletResponse объект, который представляет ответ сервлет, возвращается к клиенту

Броски:

ServletException - если целевой ресурс выдает это исключение

java.io.IOException - если целевой ресурс выдает это исключение

IllegalStateException - если ответ уже фиксировался

См. Также:

ServletRequest#getDispatcherType

включать

void include(ServletRequest request,
             ServletResponse response)
             throws ServletException,
                    java.io.IOException

Включает контент ресурса (сервлет, страница JSP, файл HTML) в ответе. В основном этот метод включает программируемой стороне сервера, включает.

ServletResponse у объекта есть свои элементы пути, и параметры остаются неизменными от вызывающей стороны. Включенный сервлет не может изменить код состояния ответа или установить заголовки; любая попытка произвести изменение игнорируется.

Запрос и параметры ответа должны быть или теми же самыми объектами, как были переданы к методу службы сервлета вызова или быть подклассами ServletRequestWrapper или ServletResponseWrapper классы, которые обертывают их.

Этот метод устанавливает тип диспетчера данного запроса к DispatcherType.INCLUDE.

Параметры:

request - a ServletRequest объект, который содержит запрос клиента

response - a ServletResponse объект, который содержит ответ сервлета

Броски:

ServletException - если включенный ресурс выдает это исключение

java.io.IOException - если включенный ресурс выдает это исключение

См. Также:

ServletRequest#getDispatcherType