Интерфейс CookieStore

public interface CookieStore

Объект CookieStore представляет хранилище для файлов cookie. Может хранить и извлекать файлы cookie.

CookieManager будет вызывать CookieStore.add для сохранения файлов cookie для каждого входящего HTTP-ответа и вызывать CookieStore.get для извлечения файла cookie для каждого исходящего HTTP-запроса. CookieStore отвечает за удаление экземпляров HttpCookie, срок действия которых истек.

С момента:: 1.6

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`add(URI uri, HttpCookie cookie)`	Добавляет один HTTP-файл cookie в хранилище.
`List<HttpCookie>`	`get(URI uri)`	Извлекает файлы cookie, связанные с заданным URI или чей домен соответствует заданному URI.
`List<HttpCookie>`	`getCookies()`	Получить все непросроченные файлы cookie в хранилище cookie.
`List<URI>`	`getURIs()`	Получить все URI, которые идентифицируют файлы cookie в этом хранилище cookie.
`boolean`	`remove(URI uri, HttpCookie cookie)`	Удаляет файл cookie из хранилища.
`boolean`	`removeAll()`	Удаляет все файлы cookie в этом хранилище cookie.

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

add

void add(URI uri, HttpCookie cookie)

Добавляет один HTTP-файл cookie в хранилище. Это вызывается для каждого входящего HTTP-ответа.

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

Если файл cookie, соответствующий заданному URI, уже существует, он заменяется новым.

Параметры:

uri - uri, с которым связан этот файл cookie. Если null, этот файл cookie не будет связан с URI

cookie - файл cookie для хранения

Исключения:

NullPointerException - если cookie является null

См. также:

get

List<HttpCookie> get(URI uri)

Извлекает файлы cookie, связанные с заданным URI или чей домен соответствует заданному URI. Возвращаются только файлы cookie, срок действия которых не истек. Это вызывается для каждого исходящего HTTP-запроса.

Параметры:

uri - uri, связанный с возвращаемыми файлами cookie

Возвращает:

неизменяемый список HttpCookie, возвращает пустой список, если нет файлов cookie, соответствующих заданному URI

Исключения:

NullPointerException - если uri является null

См. также:

getCookies

List<HttpCookie> getCookies()

Получить все непросроченные файлы cookie в хранилище cookie.

Возвращает:: неизменяемый список файлов cookie http; возвращает пустой список, если в хранилище нет файла cookie http

getURIs

List<URI> getURIs()

Получить все URI, которые идентифицируют файлы cookie в этом хранилище cookie.

Возвращает:: неизменяемый список URI; возвращает пустой список, если ни один файл cookie в этом хранилище cookie не связан с URI

remove

boolean remove(URI uri, HttpCookie cookie)

Удаляет файл cookie из хранилища.

Параметры:: uri - uri, с которым связан этот файл cookie. Если null, удаляемый файл cookie не связан с URI при добавлении; если не null, удаляемый файл cookie связан с заданным URI при добавлении.; cookie - файл cookie для удаления
Возвращает:: true если в этом хранилище содержался указанный файл cookie
Исключения:: NullPointerException - если cookie является null

removeAll

boolean removeAll()

Удаляет все файлы cookie в этом хранилище cookie.

Возвращает:: true если хранилище изменилось в результате вызова

© 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/CookieStore.html