Интерфейс 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, 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/CookieStore.html