Модули расширения для внешних источников данных
h2>8.1.2. Поиск
Функция YDS_OpenDataSrc вызывается при выполнении первого поискового запроса, в результате которого нашлись документы из внешнего источника данных, и дизайн страницы результатов поиска предполагает ссылку на содержимое документа, с подсветкой или без. В третьем параметре передается 0. После формирования страницы выдачи вызывающий тред заканчивает свою работу. Гарантируется отсутствие повторных или одновременных вызовов.
Если библиотека содержит функцию YDS_OpenParseDocUrl, то при формировании показываемого пользователю URL, ведущему на содержание документа, последовательно вызываются функции YDS_OpenParseDocUrl и YDS_CloseDocQuery для каждого URL. YDS_OpenParseDocUrl возвращает YDS_OK, установив третий параметр на область памяти, включающую URL со схемой, которую понимает браузер, и остающуюся корректной до вызова YDS_CloseDocQuery. Этот URL будет показан на странице выдачи. Например, это может быть адрес скрипта на веб-сервере, принимающего CGI-параметры, сформированные на основании идентификатора документа, переданного во втором параметре функции YDS_OpenParseDocUrl. Если же YDS_OpenParseDocUrl отсутствует или возвращает YDS_EOF, в качестве URL, ведущего на содержание документа, будет показан тот же адрес, что и для подсвеченного документа, но без подсветки.
При выполнении запроса на получение подсвеченного документа последовательно вызываются YDS_OpenDocQuery, YDS_GetDocument, и YDS_CloseDocQuery в новом треде. В третьем параметре в YDS_GetDocument всегда передается 0, что соответствует необходимости получить содержание документа. После этого вызывающий тред заканчивает свою работу.
Функция YDS_CloseDataSrc вызывается из еще одного треда в момент остановки поискового сервиса.
Copyright © 1997 ? 2004 «Яндекс»Назад | Содержание | Вперед |
Язык запросов Яndex.Server 3.1 | Программа attributer |
|
|