Класс 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 в настоящее время не установлен.

Исключения:

SecurityException - Если установлен менеджер безопасности, и он запрещает NetPermission("getCookieHandler")

См. также:

setDefault

public static void setDefault(CookieHandler cHandler)

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

Параметры:

cHandler - Обработчик cookie HTTP или null для сброса.

Исключения:

SecurityException - Если установлен менеджер безопасности, и он запрещает NetPermission("setCookieHandler")

См. также:

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 - карта, сопоставляющая имена полей заголовка запроса со списками значений полей, представляющих текущие заголовки запроса

Возвращает:

неизменяемая карта заголовков управления состоянием со значениями "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 - URI , откуда cookie получены

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

Исключения:

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

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