Класс 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

Начиная с версии:

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)`	Устанавливает (или отключает) системный кэш.

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

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

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

ResponseCache

public ResponseCache()

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

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

getDefault

public static ResponseCache getDefault()

Возвращает системный кэш ответов.

Возвращает:

системный ResponseCache

Начиная с версии:

1.5

См. также:

setDefault

public static void setDefault(ResponseCache responseCache)

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

Параметры:

responseCache — кэш ответов или null, чтобы отключить кэш.

Начиная с версии:

1.5

См. также:

get

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

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

Параметры:

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

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

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

Возвращает:

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

Выбрасывает:

IOException — если произошла ошибка ввода-вывода

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

См. также:

put

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

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

Параметры:: uri — URI для ссылки на запрошенный сетевой ресурс; conn — экземпляр URLConnection, используемый для получения ответа, который следует кэшировать
Возвращает:: 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://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/net/ResponseCache.html