Класс 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. Все обмены, обрабатываемые контекстом, могут быть предварительно и послеобработаны каждым фильтром в цепочке.
- Since:
- 1.6
Конструкторы
| Модификатор | Конструктор | Описание |
|---|---|---|
protected |
HttpContext() |
Методы
| Модификатор и тип | Метод | Описание |
|---|---|---|
abstract Map<String,Object> |
getAttributes() |
возвращает изменяемую Map, которая может использоваться для передачи конфигурации и других данных модулям фильтра и обработчику обмена контекста. |
abstract Authenticator |
getAuthenticator() |
Возвращает текущего установленного Authenticator для этого контекста, если он существует. |
abstract List<Filter> |
getFilters() |
возвращает список фильтров этого контекста. |
abstract HttpHandler |
getHandler() |
возвращает обработчик для этого контекста |
abstract String |
getPath() |
возвращает путь, с которым был создан этот контекст |
abstract HttpServer |
getServer() |
возвращает сервер, с которым был создан этот контекст |
abstract Authenticator |
setAuthenticator(Authenticator auth) |
Устанавливает Authenticator для этого HttpContext. |
abstract void |
setHandler(HttpHandler h) |
Устанавливает обработчик для этого контекста, если он еще не установлен. |
Методы, унаследованные от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Конструкторы
HttpContext
protected HttpContext()
Методы
getHandler
public abstract HttpHandler getHandler()
возвращает обработчик для этого контекста
- Возвращает:
- HttpHandler для этого контекста
setHandler
public abstract void setHandler(HttpHandler h)
Устанавливает обработчик для этого контекста, если он еще не установлен.
- Параметры:
-
h- обработчик для установки в этот контекст - Исключения:
-
IllegalArgumentException- если обработчик этого контекста уже установлен. -
NullPointerException- если обработчикnull
getPath
public abstract String getPath()
возвращает путь, с которым был создан этот контекст
- Возвращает:
- путь этого контекста
getServer
public abstract HttpServer getServer()
возвращает сервер, с которым был создан этот контекст
- Возвращает:
- сервер этого контекста
getAttributes
public abstract Map<String,Object> getAttributes()
возвращает изменяемую Map, которая может использоваться для передачи конфигурации и других данных модулям фильтра и обработчику обмена контекста.
Каждый атрибут, хранящийся в этой Map, будет виден каждому HttpExchange, обработанному этим контекстом
getFilters
public abstract List<Filter> getFilters()
возвращает список фильтров этого контекста. Это фактический список, используемый сервером при передаче запросов, поэтому изменения в этом списке немедленно влияют на обработку обменов.
setAuthenticator
public abstract Authenticator setAuthenticator(Authenticator auth)
Устанавливает Authenticator для этого HttpContext. После того, как authenticator установлен в контексте, все клиентские запросы должны быть аутентифицированы, и заданный объект будет вызываться для проверки каждого запроса. Каждый вызов этого метода заменяет любое предыдущее значение.
- Параметры:
-
auth- authenticator для установки. Еслиnull, то любой ранее установленный authenticator удаляется, и клиентская аутентификация больше не требуется. - Возвращает:
- предыдущий Authenticator, если он был установлен, или
nullв противном случае.
getAuthenticator
public abstract Authenticator getAuthenticator()
Возвращает текущего установленного Authenticator для этого контекста, если он существует.
- Возвращает:
- Authenticator этого HttpContext, или
nullесли он не установлен.
© 1993, 2020, 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/11/docs/api/jdk.httpserver/com/sun/net/httpserver/HttpContext.html