Интерфейс 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)`	Добавляет файл cookie HTTP в хранилище.
`List<HttpCookie>`	`get(URI uri)`	Получает файлы cookie, связанные с указанным URI или домен которых соответствует указанному URI.
`List<HttpCookie>`	`getCookies()`	Получает все файлы cookie с неистёкшим сроком действия из хранилища.
`List<URI>`	`getURIs()`	Получает все URI, идентифицирующие файлы cookie в этом хранилище.
`boolean`	`remove(URI uri, HttpCookie cookie)`	Удаляет файл cookie из хранилища.
`boolean`	`removeAll()`	Удаляет все файлы cookie из этого хранилища.

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

add

void add(URI uri, HttpCookie cookie)

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

Сохраняемый файл cookie может быть связан с URI, а может и не быть. Если он не связан с URI, его атрибуты домена и пути указывают, откуда он получен. Если он связан с 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; возвращает пустой список, если указанному URI не соответствует ни один файл cookie

Исключения:

NullPointerException — если uri имеет значение null

См. также:

getCookies

List<HttpCookie> getCookies()

Получает все файлы cookie с неистёкшим сроком действия из хранилища.

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

getURIs

List<URI> getURIs()

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

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

remove

boolean remove(URI uri, HttpCookie cookie)

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

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

removeAll

boolean removeAll()

Удаляет все файлы 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://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/net/CookieStore.html