Класс ResponseCache

java.lang.Object

java.net.ResponseCache

public abstract class ResponseCache extends Object

Представляет реализации кэшей URLConnection. Экземпляр такого класса может быть зарегистрирован в системе с помощью ResponseCache.setDefault(ResponseCache), и система будет вызывать этот объект для:

хранения данных ресурсов, которые были получены из внешнего источника в кэше
попытки извлечения запрошенного ресурса, который может быть сохранен в кэше

Реализация ResponseCache определяет, какие ресурсы должны быть кэшированы и на какой срок они должны быть кэшированы. Если запрашиваемый ресурс не может быть получен из кэша, то обработчики протокола извлекут ресурс из его исходного расположения. Настройки URLConnection#useCaches контролируют, разрешено ли протоколу использовать кэшированный ответ. Дополнительную информацию о кэшировании HTTP см. в RFC 2616: Протокол передачи гипертекста — HTTP/1.1

Since:

1.5

Внешние спецификации

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

Конструктор	Описание
`ResponseCache()`	Конструктор для вызова подклассами.

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

Модификатор и тип	Метод	Описание
`abstract CacheResponse`	`get(URI uri, String rqstMethod, Map<String, List<String>> rqstHeaders)`	Получение кэшированного ответа на основе запрошенного URI, метода запроса и заголовков запроса.
`static ResponseCache`	`getDefault()`	Получение системного кэша ответов.
`abstract CacheRequest`	`put(URI uri, URLConnection conn)`	Обработчик протокола вызывает этот метод после получения ресурса, и ResponseCache должен принять решение о том, следует ли сохранить ресурс в своем кэше.
`static void`	`setDefault(ResponseCache responseCache)`	Устанавливает (или сбрасывает) системный кэш.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

ResponseCache

public ResponseCache()

Конструктор для вызова подклассами.

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

getDefault

public static ResponseCache getDefault()

Получение системного кэша ответов.

Возвращает:

системный кэш ResponseCache

Since:

1.5

См. также:

setDefault

public static void setDefault(ResponseCache responseCache)

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

Параметры:

responseCache - Кэш ответов или null для сброса кэша.

Since:

1.5

См. также:

get

public abstract CacheResponse get(URI uri, String rqstMethod, Map<String, List<String>> rqstHeaders) throws IOException

Получение кэшированного ответа на основе запрошенного URI, метода запроса и заголовков запроса. Обычно этот метод вызывается обработчиком протокола перед отправкой запроса для получения сетевого ресурса. Если возвращается кэшированный ответ, этот ресурс используется вместо него.

Параметры:

uri - a URI используемый для ссылки на запрашиваемый сетевой ресурс

rqstMethod - a String представляющий метод запроса

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

Возвращает:

экземпляр CacheResponse, если он доступен из кэша, или null в противном случае

Исключения:

IOException - если возникает ошибка ввода-вывода

IllegalArgumentException - если любой из аргументов равен null

См. также:

put

public abstract CacheRequest put(URI uri, URLConnection conn) throws IOException

Обработчик протокола вызывает этот метод после получения ресурса, и ResponseCache должен принять решение о том, следует ли сохранить ресурс в своем кэше. Если ресурс должен быть кэширован, то put() должен вернуть объект CacheRequest, который содержит OutputStream, который обработчик протокола будет использовать для записи ресурса в кэш. Если ресурс не должен быть кэширован, то put должен вернуть null.

Параметры:: uri - a URI используемый для ссылки на запрашиваемый сетевой ресурс; conn - экземпляр URLConnection, который используется для получения ответа, подлежащего кэшированию
Возвращает:: a CacheRequest для записи ответа, подлежащего кэшированию. Возвращение Null указывает, что вызывающий элемент не намерен кэшировать ответ.
Исключения:: 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/net/ResponseCache.html