Класс CookieHandler

java.lang.Object

java.net.CookieHandler

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

public abstract class CookieHandler extends Object

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

Общесистемный CookieHandler, используемый обработчиком протокола потоков URL 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)`	Получает из кэша файлов 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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли другой объект этому объекту.
`protected void`	`finalize()`	Устарело, подлежит удалению: этот элемент API может быть удален в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хэш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного времени.

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

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.