Класс HttpContext

java.lang.Object

com.sun.net.httpserver.HttpContext

public abstract class HttpContext extends Object

HttpContext представляет собой связь между корневым путём URI приложения и HttpHandler, который вызывается для обработки запросов, предназначенных для этого пути, на связанном HttpServer или HttpsServer.

Экземпляры HttpContext создаются методами create в HttpServer и HttpsServer.

К HttpContext можно добавить цепочку объектов Filter. Каждый Filter в цепочке может выполнять предварительную и последующую обработку всех обменов, обрабатываемых этим контекстом.

Начиная с:: 1.6

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

HttpContext()

Модификатор	Конструктор	Описание
`protected`	Конструктор для вызова подклассами.

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

Модификатор и тип	Метод	Описание
`abstract Map<String,Object>`	`getAttributes()`	Возвращает изменяемый `Map`, который можно использовать для передачи конфигурации и других данных модулям `Filter` и обработчику обменов контекста.
`abstract Authenticator`	`getAuthenticator()`	Возвращает текущий `Authenticator`, заданный для этого контекста, если он существует.
`abstract List<Filter>`	`getFilters()`	Возвращает `List` фильтров этого контекста.
`abstract HttpHandler`	`getHandler()`	Возвращает обработчик этого контекста.
`abstract String`	`getPath()`	Возвращает путь, с которым был создан этот контекст.
`abstract HttpServer`	`getServer()`	Возвращает сервер, с которым был создан этот контекст.
`abstract Authenticator`	`setAuthenticator(Authenticator auth)`	Устанавливает `Authenticator` для этого `HttpContext`.
`abstract void`	`setHandler(HttpHandler handler)`	Устанавливает обработчик этого контекста, если он ещё не установлен.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Показывает, равен ли другой объект этому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API планируется удалить в будущей версии. Финализация объявлена устаревшей и планируется к удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного периода реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного периода реального времени.

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

HttpContext

protected HttpContext()

Конструктор для вызова подклассами.

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

getHandler

public abstract HttpHandler getHandler()

Возвращает обработчик этого контекста.

Возвращает:: HttpHandler этого контекста

setHandler

public abstract void setHandler(HttpHandler handler)

Устанавливает обработчик этого контекста, если он ещё не установлен.

Параметры:: handler — обработчик, который нужно установить для этого контекста
Исключения:: IllegalArgumentException — если контекст для этого обработчика уже установлен.; NullPointerException — если обработчик равен null

getPath

public abstract String getPath()

Возвращает путь, с которым был создан этот контекст.

Возвращает:: контекст этого пути

getServer

public abstract HttpServer getServer()

Возвращает сервер, с которым был создан этот контекст.

Возвращает:: контекст этого сервера

getAttributes

public abstract Map<String,Object> getAttributes()

Возвращает изменяемый Map, который можно использовать для передачи конфигурации и других данных модулям Filter и обработчику обменов контекста.

Каждый атрибут, хранящийся в этом Map, будет виден для каждого HttpExchange, обрабатываемого этим контекстом.

Возвращает:: Map, содержащий атрибуты этого контекста

getFilters

public abstract List<Filter> getFilters()

Возвращает List фильтров этого контекста. Это фактический список, используемый сервером при распределении запросов, поэтому изменения в этом списке немедленно влияют на обработку обменов.

Возвращает:: List, содержащий фильтры этого контекста

setAuthenticator

public abstract Authenticator setAuthenticator(Authenticator auth)

Устанавливает Authenticator для этого HttpContext. После назначения аутентификатора контексту все клиентские запросы должны проходить аутентификацию, а указанный объект будет вызываться для проверки каждого запроса. Каждый вызов этого метода заменяет ранее установленное значение.

Параметры:: auth — Authenticator, который нужно установить. Если null, то ранее установленный Authenticator удаляется, и аутентификация клиентов больше не требуется.
Возвращает:: предыдущий Authenticator, если он был установлен, или null в противном случае.

getAuthenticator

public abstract Authenticator getAuthenticator()

Возвращает текущий Authenticator, заданный для этого контекста, если он существует.

Возвращает:: Authenticator этого HttpContext или 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.