Класс CookieHandler

java.lang.Object

java.net.CookieHandler

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

public abstract class CookieHandler extends Object

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

Общесистемный CookieHandler, используемый обработчиком протокола потоков 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 все подходящие файлы cookie, например поля заголовка ответа с именем Set-Cookie2, содержащиеся в заголовках ответа.
`static void`	`setDefault(CookieHandler cHandler)`	Устанавливает (или отменяет установку) общесистемного обработчика cookie.

Методы, объявленные в классе 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 — обработчик cookie HTTP или 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 — URI, представляющий предполагаемое использование файлов cookie

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

Возвращает:

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

Вызывает исключение:

IOException — если возникает ошибка ввода-вывода

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

См. также:

put

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

Сохраняет в кэше cookie все подходящие файлы cookie, например поля заголовка ответа с именем Set-Cookie2, содержащиеся в заголовках ответа.

Параметры:

uri — 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://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/net/CookieHandler.html