java.net

Класс ResponseCache

java.lang. Объект

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) Получите кэшируемый ответ, основанный на турах запроса, запросите метод и запросите заголовки.
static ResponseCache	getDefault() Получает кэш ответа в масштабе всей системы.
abstract CacheRequest	put(URI uri, URLConnection conn) Обработчик протокола вызывает этот метод после того, как ресурс был получен, и ResponseCache должен решить, сохранить ли ресурс в его кэше.
static void	setDefault(ResponseCache responseCache) Наборы (или сбросы) кэш в масштабе всей системы.

Методы java.lang унаследованный от класса. Объект

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)

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

Параметры:

responseCache - Кэш ответа, или null сбрасывать кэш.

Броски:

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

С тех пор:

1.5

См. Также:

getDefault()

добраться

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

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

Параметры:

uri - a URI используемый, чтобы сослаться на требуемый сетевой ресурс

rqstMethod - a String представление метода запроса

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

Возвраты:

a CacheResponse экземпляр при наличии от кэша, или нуля иначе

Броски:

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

IllegalArgumentException - если кем-либо из параметров является нуль

См. Также:

URLConnection.setUseCaches(boolean), URLConnection.getUseCaches(), URLConnection.setDefaultUseCaches(boolean), URLConnection.getDefaultUseCaches()

поместить

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

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

Параметры:

uri - a URI используемый, чтобы сослаться на требуемый сетевой ресурс

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

Возвраты:

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

Броски:

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

IllegalArgumentException - если кем-либо из параметров является нуль