Класс HttpContext

java.lang.Object

com.sun.net.httpserver.HttpContext

public abstract class HttpContext extends Object

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

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

Цепочка объектов Filter может быть добавлена в HttpContext. Все обмены, обрабатываемые контекстом, могут быть предварительно и послеобработаны каждым Filter в цепочке.

Since:: 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)`	Устанавливает обработчик для этого контекста, если он ещё не установлен.

Методы, унаследованные от класса java.lang.Object

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

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

HttpContext

protected HttpContext()

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

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

getHandler

public abstract HttpHandler getHandler()

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

Возвращает:: обработчика для этого контекста

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, 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/HttpContext.html