Интерфейс 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 из Strings, содержащий каждое значение, включённое в запрос, в порядке их включения. Поля заголовков, встречающиеся несколько раз, представлены несколькими строковыми значениями.

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

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

with

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

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

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

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

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

© 1993, 2025, 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/25/docs/api/jdk.httpserver/com/sun/net/httpserver/Request.html