Класс ResponseCache

public abstract class ResponseCache
extends Object

Конструкторы

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 - объект URI используемый для ссылки на запрашиваемый сетевой ресурс

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

rqstHeaders - 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 - объект URI используемый для ссылки на запрашиваемый сетевой ресурс

conn - объект URLConnection, используемый для получения ответа для кэширования

Возвращает:

объект CacheRequest для записи ответа для кэширования. Возврат null указывает, что вызывающий объект не намерен кэшировать ответ.

Исключение:

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

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