Класс 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)`	Установка (или сброс) системного кэша.

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

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

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

ResponseCache

public ResponseCache()

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

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

getDefault

public static ResponseCache getDefault()

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

Возвращает:

системный ResponseCache

Исключения:

SecurityException - Если установлен менеджер безопасности и он отклоняет NetPermission("getResponseCache")

С тех пор:

1.5

См. также:

setDefault

public static void setDefault(ResponseCache responseCache)

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

Параметры:

responseCache - Кэш ответов, или null для отключения кэша.

Исключения:

SecurityException - Если установлен менеджер безопасности и он отклоняет NetPermission("setResponseCache")

С тех пор:

1.5

См. также:

get

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

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

Параметры:

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

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

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

Возвращает:

экземпляр 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, 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/ResponseCache.html