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


Представьте ошибку или функцию

Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается срокам действия лицензии.

Сгенерированный на 10-February-2011 12:41


Spec-Zone.ru - all specs in one place



free hit counter