javax.ws.rs.core
Запрос интерфейса


public interface Request

Вводимый помощник для обработки запросов, все методы бросают java.lang. IllegalStateException если вызвано вне контекста запроса (например, от конструктора провайдера). Обработка предварительного условия (см. evaluatePreconditions методы), может привести к любому a null возвращаемое значение, чтобы указать, что предварительные условия были встречены и что запрос должен продолжаться, или ненулевое возвращаемое значение, чтобы указать, что предварительные условия не были встречены. Когда предварительные условия не были встречены, возвращенный ResponseBuilder экземпляр будет иметь соответствующее состояние и будет также включать a Vary заголовок, если selectVariant(java.util.List) до метода вызвали к вызову evaluatePreconditions. Это - обязанность вызывающей стороны проверить состояние и добавить дополнительные метаданные если требующийся. Например, см. HTTP/1.1, раздел 10.3.5 для деталей заголовков, которые, как ожидают, будут сопровождать a 304 Not Modified ответ.


Сводка метода
 Ответ. ResponseBuilder evaluatePreconditions()
          Оцените предварительные условия запроса для ресурса, который в настоящий момент не существует.
 Ответ. ResponseBuilder evaluatePreconditions(java.util.Date lastModified)
          Оцените предварительные условия запроса, основанные на переданном в значении.
 Ответ. ResponseBuilder evaluatePreconditions(java.util.Date lastModified, EntityTag eTag)
          Оцените предварительные условия запроса, основанные на переданном в значении.
 Ответ. ResponseBuilder evaluatePreconditions(EntityTag eTag)
          Оцените предварительные условия запроса, основанные на переданном в значении.
 java.lang.String getMethod()
          Получите метод запроса, например.
 Разновидность selectVariant(java.util.List<Variant> variants)
          Выберите разновидность представления что лучшие соответствия запрос.
 

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

getMethod

java.lang.String getMethod()
Получите метод запроса, например. ДОБЕРИТЕСЬ, POST, и т.д.

Возвраты:
метод запроса
См. Также:
HttpMethod

selectVariant

Variant selectVariant(java.util.List<Variant> variants)
                      throws java.lang.IllegalArgumentException
Выберите разновидность представления что лучшие соответствия запрос. Более явные разновидности выбираются перед менее явными. Изменить заголовок вычисляется от предоставленного списка и автоматически добавляется к ответу.

Параметры:
variants - список Разновидности, которые описывают все доступные разновидности представления.
Возвраты:
разновидность, что лучшие соответствия запрос.
Броски:
java.lang.IllegalArgumentException - если разновидности являются пустыми или нулевыми
java.lang.IllegalStateException - если вызвано вне контекста запроса
См. Также:
Variant.VariantListBuilder

evaluatePreconditions

Response.ResponseBuilder evaluatePreconditions(EntityTag eTag)
Оцените предварительные условия запроса, основанные на переданном в значении.

Параметры:
eTag - Завершающий тег для текущего состояния ресурса
Возвраты:
нуль, если предварительные условия встречаются или набор ResponseBuilder с соответствующим состоянием, если предварительные условия не встречаются. Возвращенный ResponseBuilder будет включать набор заголовка Завершающего тега со значением завершающего тега.
Броски:
java.lang.IllegalArgumentException - если завершающий тег является нулем
java.lang.IllegalStateException - если вызвано вне контекста запроса

evaluatePreconditions

Response.ResponseBuilder evaluatePreconditions(java.util.Date lastModified)
Оцените предварительные условия запроса, основанные на переданном в значении.

Параметры:
lastModified - дата, которая определяет дату модификации ресурса
Возвраты:
нуль, если предварительные условия встречаются или набор ResponseBuilder с соответствующим состоянием, если предварительные условия не встречаются.
Броски:
java.lang.IllegalArgumentException - если lastModified является нулем
java.lang.IllegalStateException - если вызвано вне контекста запроса

evaluatePreconditions

Response.ResponseBuilder evaluatePreconditions(java.util.Date lastModified,
                                               EntityTag eTag)
Оцените предварительные условия запроса, основанные на переданном в значении.

Параметры:
lastModified - дата, которая определяет дату модификации ресурса
eTag - Завершающий тег для текущего состояния ресурса
Возвраты:
нуль, если предварительные условия встречаются или набор ResponseBuilder с соответствующим состоянием, если предварительные условия не встречаются. Возвращенный ResponseBuilder будет включать набор заголовка Завершающего тега со значением завершающего тега.
Броски:
java.lang.IllegalArgumentException - если lastModified или завершающий тег являются нулем
java.lang.IllegalStateException - если вызвано вне контекста запроса

evaluatePreconditions

Response.ResponseBuilder evaluatePreconditions()
Оцените предварительные условия запроса для ресурса, который в настоящий момент не существует. Основное использование этого метода должно поддерживать Если-соответствие: * и, "если Ни один Соответствие": * предварительные условия.

Отметьте это оба предварительных условия If-None-Match: * и If-None-Match: something как будут всегда полагать, был встречен, и это - обязанность за приложения осуществить любую специфичную для дополнительного метода семантику. Например, a PUT на ресурсе, который не существует, мог бы успешно выполниться тогда как a GET на ресурсе, который не существует, вероятно, привел бы к 404 ответам. Это была бы обязанность приложения генерировать 404 ответа.

Возвраты:
нуль, если предварительные условия встречаются или набор ResponseBuilder с соответствующим состоянием, если предварительные условия не встречаются.
Броски:
java.lang.IllegalStateException - если вызвано вне контекста запроса


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

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

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


Spec-Zone.ru - all specs in one place



free hit counter