APIHTTPCacheView

Previous pageReturn to chapter overviewNext page

 

(Добавлено со сборки 196)

(Удалено со сборки 208)

 

 

Просмотр списка объектов кэша прокси сервера.

 

XMLData = APIHTTPCacheView (Request, Options, User, FromItem, ItemCount)

 

Данные в виде списка возвращаются в XML формате (строка).

 

Аргументы

 

Request - Строка запроса. Если задана опция запроса UseRegExpr (см. ниже), то это полный URL путь к ресурсу, объект ищется по полному совпадению, возвращается информация только об одном объекте. Иначе это шаблон поиска в формате регулярных выражений. Может также содержать список регулярных выражений в кавычках, разделенных запятыми.

 

Options - Набор опций запроса, задается в виде битовых значений:

 

UseRegExpr        = 1

Private                = 2

EnumAll                = 4

Detailed                = 8

 

Если задана опция запроса Private, то также будут выводится объекты, полученные прокси сервером с HTTP атрибутом private, иначе такие атрибуты выводиться не будут. Опция имеет смысл только при поиске с регулярными выражениями (задана опция UseRegExpr).

 

Если задана опция запроса EnumAll, то также будет определено общее количество объектов, подпадающих под условие запроса. Опция имеет смысл только при поиске с регулярными выражениями (задана опция UseRegExpr). Это значение возвращается в XML атрибуте TotalItems и может быть использовано для организации постраничного вывода списков объектов. Без необходимости это использовать не следует, так как при больших списках может существенно нагрузить процессор и заблокировать на некоторое время кэш.

 

Если задана опция запроса Detailed, то возвращается вся доступная информация об объекте, иначе - минимум информации: указатель (Handle), размер и тип контента.

 

User - Строковое выражение, определяющее GUID клиента, при работе которого через прокси сервер объект был записан в кэш. Если параметр пустой (Empty), то ищутся объекты для любых клиентов.

 

FromItem, ItemCount - Параметры, управляющие выводом элементов в списке порциями. Имеют смысл только при поиске с регулярными выражениями (IsRegExpr <> 0). Для предотвращения перегрузки сервера количество выводимых элементов ограничено 1000. ItemCount задает максимальное количество элементов в запросе, FromItem - номер элемента, с которого выводить. Нумерация элементов начинается с "0".

 

 

Возвращаемое значение

 

Для дальнейших операций с данными объекта важно знать его тип. Для этого в XML данных возвращаются атрибуты:

 

ContType - соответствует HTTP атрибуту content-type. Например, "text/plain" - это текстовый файл. Удобно использовать реестр Windows, ветку "HKEY_CLASSES_ROOT\MIME\Database\Content Type" для анализа типа данных и поиска приложений, зарегистрированных для просмотра и редактирования этого типа данных. Следует отметить, что HTTP атрибут типа данных проставляет веб сервер, откуда был взят ресурс, и не всегда тип данных может быть представлен корректно.

 

ContTypeTags - возвращается набор символьных тегов групп контента, описанных в конфигурационном файле CntGrp.ini. Определяется также исходя из HTTP атрибута content-type. Например, наличие тега "T" означает, что это тип данных "Текст".

 

 

 


Текущая страница справки: help.smart-soft.ru/index.html?apihttpcacheview.htm

Сайт разработчиков Traffic Inspector