Поле Warning (Предупреждение)

Поле заголовка отклика Warning используется для переноса дополнительной информации о состоянии отклика, которая может отражать статусный код. Эта информация обычно служит для предупреждения о возможной потере семантической прозрачности изза операций кэширования. Заголовки Warning посылаются с откликами, применяя:

Warning = "Warning" ":" 1#warningvalue warningvalue = warncode SP warnagent SP warntext warncode = 2DIGIT warnagent = ( host [ ":" port ] ) | pseudonym ; имя или псевдоним сервера, добавившего заголовок Warning, ; предназначенный для целей отладки warntext = quotedstring

Отклик может нести в себе более одного заголовка Warning.

Запись warntext производится на естественном языке и с применением символьного набора, приемлемого для принимающего отклик лица. Это решение может базироваться на некоей имеющейся информации, такой, как положение кэша или пользователя, поле запроса AcceptLanguage, поле отклика ContentLanguage и т.д. Языком по умолчанию является английский, а символьным набором — ISO88591.

Если используется символьный набор, отличный от ISO88591, он должен быть закодирован в warntext с использованием метода, описанного в RFC-1522 [7.14].

Любой сервер или кэш может добавить заголовки Warning к отклику. Новые заголовки Warning должны добавляться после любых существующих заголовков Warning. Кэш не должен уничтожать какие-­либо заголовки, которые он получил в отклике. Однако если кэш успешно перепроверил запись, ему следует удалить все заголовки Warning, присоединенные ранее, за исключением специальных кодов Warning. Он должен добавить к записи новые заголовки Warning, полученные с откликом перепроверки. Другими словами, заголовками Warning являются те, которые были бы получены в отклике на запрос в данный момент.

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

• Предупреждения, которые появляются в отклике раньше, имеют приоритет перед теми, что появляются позже.

• Предупреждения с предпочитаемым пользователем символьным набором имеют приоритет перед предупреждениями с другими, но идентичными warncodes и warnagents наборами.

Системы, которые генерируют несколько заголовков Warning, должны упорядочить их с учетом ожидаемого поведения агента пользователя.

Далее представлен список определенных в настоящее время кодов предупреждений, каждый из которых сопровождается рекомендуемым текстом на английском языке и описанием его значения.

10 Response is stale (отклик устарел)

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

11 Revalidation failed (перепроверка пригодности неудачна)

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

12 Disconnected operation (работа в отключенном от сети состоянии)

Следует включать, если кэш намерено отключен от остальной сети на определенный период времени.

13 Heuristic expiration (эвристическое определение времени пригодности)

Должно включаться, если кэш эвристически выбрал время жизни больше 24 часов, а возраст отклика превышает эту величину.

14 Transformation applied (применено преобразование)

Должно добавляться промежуточным кэшем или прокси, если он использует какое­либо преобразование, изменяющее кодировку содержимого (как это специфицировано в заголовке Content-Encoding ) или тип среды (как это описано в заголовке Content-Type ) отклика, если только этот код предупреждения не присутствует уже в отклике.

99 Разные предупреждения

Текст предупреждения включает в себя любую информацию, которая может быть представлена человекуоператору или может быть занесена в дневник операций. Система, получающая это предупреждение, не должна предпринимать каких­-либо действий автоматически.