Класс CookieHandler

java.lang.Object
- java.net.CookieHandler

Прямые известные подклассы:: CookieManager

public abstract class CookieHandler
extends Object

Объект CookieHandler предоставляет механизм обратного вызова для подключения реализации политики управления состоянием HTTP в обработчик протокола HTTP. Механизм управления состоянием HTTP определяет способ создания состоятельного сеанса с запросами и ответами HTTP.

Системный CookieHandler, используемый обработчиком протокола HTTP, может быть зарегистрирован с помощью CookieHandler.setDefault(CookieHandler). Текущий зарегистрированный CookieHandler может быть получен с помощью вызова CookieHandler.getDefault(). Для получения дополнительной информации об управлении состоянием HTTP см. RFC 2965: Механизм управления состоянием HTTP

С:: 1.5

Конструкторы

Конструктор и описание
`CookieHandler()`

Методы

Модификатор и тип	Метод и описание
`abstract Map<String,List<String>>`	`get(URI uri, Map<String,List<String>> requestHeaders)` Получает все применимые куки из кэша куки для указанного uri в заголовке запроса.
`static CookieHandler`	`getDefault()` Получает системный обработчик куки.
`abstract void`	`put(URI uri, Map<String,List<String>> responseHeaders)` Записывает все применимые куки, например, поля заголовка ответа, имеющие имя Set-Cookie2, присутствующие в заголовках ответа, в кэш куки.
`static void`	`setDefault(CookieHandler cHandler)` Устанавливает (или сбрасывает) системный обработчик куки.

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

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

Конструкторы

CookieHandler

public CookieHandler()

Методы

getDefault

public static CookieHandler getDefault()

Получает системный обработчик куки.

Возвращает:: системный обработчик куки; значение null означает, что системный обработчик куки в настоящее время не установлен.
Выбрасывает:: SecurityException - Если установлен менеджер безопасности, и он запрещает NetPermission("getCookieHandler")
См. также:: setDefault(CookieHandler)

setDefault

public static void setDefault(CookieHandler cHandler)

Устанавливает (или сбрасывает) системный обработчик куки. Примечание: нестандартные обработчики протокола http могут игнорировать это значение.

Параметры:: cHandler - Обработчик HTTP-куки или null для сброса.
Выбрасывает:: SecurityException - Если установлен менеджер безопасности, и он запрещает NetPermission("setCookieHandler")
См. также:: getDefault()

get

public abstract Map<String,List<String>> get(URI uri,
                                             Map<String,List<String>> requestHeaders)
                                      throws IOException

Получает все применимые куки из кэша куки для указанного uri в заголовке запроса.

Переданный в качестве аргумента URI указывает предполагаемое использование куки. В частности, схема должна отражать, будут ли куки отправляться по http, https или использоваться в другом контексте, таком как javascript. Часть хоста должна отражать либо место назначения куки, либо их происхождение в случае javascript.

Реализация должна учитывать URI и атрибуты куки и настройки безопасности, чтобы определить, какие из них должны быть возвращены.

Реализаторы протокола HTTP должны убедиться, что этот метод вызывается после добавления всех заголовков запроса, относящихся к выбору куки, и до отправки запроса.

Параметры:: uri - a URI представляющий предполагаемое использование куки; requestHeaders - - a Map из имён полей заголовка запроса к спискам значений полей, представляющих текущие заголовки запроса
Возвращает:: неизменяемая карта из заголовков управления состоянием, с именами полей "Cookie" или "Cookie2" до списка куки, содержащих информацию о состоянии
Выбрасывает:: IOException - если произошла ошибка ввода/вывода; IllegalArgumentException - если какой-либо из аргументов равен null
См. также:: put(URI, Map)

put

public abstract void put(URI uri,
                         Map<String,List<String>> responseHeaders)
                  throws IOException

Записывает все применимые куки, например, поля заголовка ответа, имеющие имя Set-Cookie2, присутствующие в заголовках ответа, в кэш куки.

Параметры:: uri - a URI от куда пришли куки; responseHeaders - неизменяемая карта из имён полей к спискам значений полей, представляющих поля заголовка ответа, возвращённые
Выбрасывает:: IOException - если произошла ошибка ввода/вывода; IllegalArgumentException - если какой-либо из аргументов равен null
См. также:: get(URI, Map)

© 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.