Интерфейс Request

Все известные реализующие классы:: HttpExchange, HttpsExchange

public interface Request

Представление неизменяемого состояния запроса HTTP-обмена.

С:: 18

Краткое описание методов

Модификатор и тип	Метод	Описание
`Headers`	`getRequestHeaders()`	Возвращает неизменяемый `Headers`, содержащий HTTP-заголовки, включенные в этот запрос.
`String`	`getRequestMethod()`	Возвращает метод запроса.
`URI`	`getRequestURI()`	Возвращает запрос `URI`.
`default Request`	`with(String headerName, List<String> headerValues)`	Возвращает идентичный `Request` с дополнительным заголовком.

Подробное описание методов

getRequestURI

URI getRequestURI()

Возвращает запрос URI.

Возвращает:: запрос URI

getRequestMethod

String getRequestMethod()

Возвращает метод запроса.

Возвращает:: строка метода запроса

getRequestHeaders

Headers getRequestHeaders()

Возвращает неизменяемый Headers, содержащий HTTP-заголовки, включенные в этот запрос.

Ключи в этом Headers — это имена заголовков, а значения — List строк, содержащих каждое значение, включенное в запрос в порядке их включения. Поля заголовков, встречающиеся несколько раз, представлены как несколько строковых значений.

Ключи в Headers не чувствительны к регистру.

Возвращает:: только для чтения Headers для доступа к заголовкам запроса.

with

default Request with(String headerName, List<String> headerValues)

Возвращает идентичный Request с дополнительным заголовком.

Возвращаемый Request содержит тот же набор headers, что и исходный this запрос, но с добавлением указанного заголовка. Остальное состояние запроса остается неизменным.

Если исходный запрос уже содержит заголовок с тем же именем, что и заданный headerName, то его значение не заменяется.

Требования к реализации:: Стандартная реализация сначала создает новый Headers, h, затем добавляет все заголовки запроса из исходного this запроса в h, затем добавляет заданную пару имя-значение, если она отсутствует в h. Затем создается неизменяемый просмотр h' объекта h и новый Request, r. Методы getRequestMethod и getRequestURI объекта r просто вызывают одноименные методы исходного this запроса. Метод getRequestHeaders возвращает h'. Наконец, возвращается r.
Параметры:: headerName - имя заголовка; headerValues - список значений заголовка
Возвращает:: запрос
Исключения:: NullPointerException - если любой из аргументов равен null, или если какой-либо элемент в headerValues равен null.

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/jdk.httpserver/com/sun/net/httpserver/Request.html