Класс ResponseCache

java.lang.Object
- java.net.ResponseCache

public abstract class ResponseCache
extends Object

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

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

Реализация ResponseCache определяет, какие ресурсы должны быть помещены в кэш и на какой срок. Если запрошенный ресурс не может быть получен из кэша, обработчики протокола извлекут ресурс из исходного расположения. Настройки URLConnection#useCaches управляют тем, разрешено ли протоколу использовать кэшированный ответ. Дополнительную информацию об кэшировании HTTP см. в RFC 2616: Hypertext Transfer Protocol -- 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
Исключение:: SecurityException - Если установлен менеджер безопасности, и он отклоняет NetPermission("getResponseCache")
Since:: 1.5
См. также:: setDefault(ResponseCache)

setDefault

public static void setDefault(ResponseCache responseCache)

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

Параметры:: responseCache - кэш ответов, или null для сброса кэша.
Исключение:: SecurityException - Если установлен менеджер безопасности, и он отклоняет NetPermission("setResponseCache")
Since:: 1.5
См. также:: getDefault()

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
См. также:: URLConnection.setUseCaches(boolean), URLConnection.getUseCaches(), URLConnection.setDefaultUseCaches(boolean), URLConnection.getDefaultUseCaches()

put

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

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

Параметры:: uri - a URI используемый для ссылки на запрашиваемый сетевой ресурс; conn - - экземпляр URLConnection, используемый для получения ответа для кэширования
Возвращает:: объект CacheRequest для записи ответа для кэширования. Возврат Null указывает, что вызывающий объект не планирует кэшировать ответ.
Исключение:: IOException - если возникает ошибка ввода/вывода; IllegalArgumentException - если любой из аргументов равен null