Интерфейс 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, но с добавлением указанного заголовка. Всё остальное состояние запроса остаётся неизменным.

Если запрос 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://download.java.net/java/early_access/jdk24/docs/api/jdk.httpserver/com/sun/net/httpserver/Request.html