Класс CookieHandler

java.lang.Object

java.net.CookieHandler

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

public abstract class CookieHandler extends Object

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

Глобальный CookieHandler для использования обработчиком потоков URL HTTP URL-потока может быть зарегистрирован с помощью 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)`	Получает все соответствующие cookie из кэша cookie для указанного uri в заголовке запроса.
`static CookieHandler`	`getDefault()`	Получает глобальный обработчик cookie.
`abstract void`	`put(URI uri, Map<String, List<String>> responseHeaders)`	Устанавливает все соответствующие cookie, например, поля заголовка ответа, которые называются Set-Cookie2, присутствующие в заголовках ответа, в кэш cookie.
`static void`	`setDefault(CookieHandler cHandler)`	Устанавливает (или отменяет) глобальный обработчик cookie.

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

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

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

CookieHandler

public CookieHandler()

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

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

getDefault

public static CookieHandler getDefault()

Получает глобальный обработчик cookie.

Возвращает:

глобальный обработчик cookie; Возвращаемое значение null означает, что в настоящее время не установлен глобальный обработчик cookie.

См. также:

setDefault

public static void setDefault(CookieHandler cHandler)

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

Параметры:

cHandler - Обработчик HTTP cookie или null для отмены.

См. также:

get

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

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

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

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

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

Параметры:

uri - a URI, представляющий предполагаемое использование cookie

requestHeaders - a Map из имён полей заголовков запроса к спискам значений полей, представляющих текущие заголовки запроса

Возвращает:

неизменяемая карта заголовков управления состоянием, с именами полей "Cookie" или "Cookie2" до списка cookie, содержащих информацию о состоянии

Исключения:

IOException - если произошла ошибка ввода-вывода

IllegalArgumentException - если какой-либо из аргументов равен null

См. также:

put

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

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

Параметры:

uri - a URI, откуда поступают cookie

responseHeaders - неизменяемая карта имён полей к спискам значений полей, представляющих поля заголовка ответа, возвращённые

Исключения:

IOException - если произошла ошибка ввода-вывода

IllegalArgumentException - если какой-либо из аргументов равен 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/java.base/java/net/CookieHandler.html