APIHTTPCacheView |
|
(Добавлено со сборки 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