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

setDefault

public static void setDefault(ResponseCache responseCache)

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

Параметры:

responseCache - Кеш ответов или null для отмены кеша.

Исключения:

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

С момента:

1.5

См. также:

getDefault()

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, 2021, 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/17/docs/api/java.base/java/net/ResponseCache.html