Windows RSS Platform в Delphi. Інтерфейс IFeed., HTML, XML, DHTML, Інтернет-технології, статті

Сьогодні ми розглянемо методи і властивості інтерфейсу IFeed, Який надає нам все необхідне для роботи з RSS-каналом сайту.


Інтерфейс IFeed призначений в першу чергу саме для роботи з каналом, а не окремим елементом фіда, відповідно сьогодні не піде мови про те як прочитати заголовки постів і т.д. – Тільки основа роботи з каналами.


Спочатку розглянемо методи.


Методи інтерфейсу IFeed


Методи AsyncDownload і CancelAsyncDownload


procedure AsyncDownload; safecall
procedure CancelAsyncDownload; safecall


AsyncDownload починає, а CancelAsyncDownload перериває асинхронну завантаження вмісту RSS-каналу.


Метод Delete


procedure Delete
Видаляє канал зі списку в IFeedsManagere.


Метод Download


procedure Download
Починає синхронну завантажувати вміст фіда.


Метод GetItem


function GetItem(itemId: Integer): IDispatch; safecall
Повертає з фіда окремі елементи (IFeedItem) За його itemId або nil , Якщо елемент не знайдений.


Метод MarkAllItemsRead


procedure MarkAllItemsRead; safecall
Зазначає всі елементи фіда як "прочитані".


Метод Merge


procedure Merge (const feedXml: WideString; const feedUrl: WideString); safecall
Об'єднує вказаний XML-код з вказаним URL.


feedXML – XML-код, який підлягає об'єднанню;


feedURL – URL з якого буде грузиться новий фід для об'єднання.


XML-повинен бути складений за всіма правилами RSS 2.0., А URL повинен починатися або з http, або https.


Метод Move


procedure Move(const newParentPath: WideString); safecall
Переносить канал в нову директорію newParentPath . Перед тим як скористатися методом необхідно перевірити існування шляху.


Метод Rename


procedure Rename(const Name: WideString); safecall
Змінює ім'я каналу на Name . Нове ім'я каналу не повинно містити слешем – ці символи зарезервовані як роздільники шляху.


Метод XML


function Xml (Count: Integer; sortProperty: FEEDS_XML_SORT_PROPERTY
sortOrder: FEEDS_XML_SORT_ORDER; filterFlags: FEEDS_XML_FILTER_FLAGS
includeFlags: FEEDS_XML_INCLUDE_FLAGS): WideString; safecall
Повертає XML RSS-каналу.


Count – Кількість елементів фіда, що має бути додано.


sortProperty – Спосіб сортування вмісту. Може приймати одне з наступних значень:



sortOrder – Напрям сортування елементів. Може приймати одне з наступних значень:



filterFlags – Параметр, який вказує чи варто включати у вміст елементи за їх мітці про прочитання. Може приймати одне з наступних значень:



includeFlags – Параметр, який вказує на те, чи варто включати в исходник простору імен для каналу. Приймає одне з наступних значень:



Властивості інтерфейсу IFeed


Властивість Copyright


property Copyright: WideString read Get_Copyright
Повертає копірайт фіда.


Властивість Description


property Description: WideString read Get_Description
Повертає опис RSS-каналу.


Властивість DownloadEnclosuresAutomatically

 property DownloadEnclosuresAutomatically: WordBool read Get_DownloadEnclosuresAutomatically
write Set_DownloadEnclosuresAutomatically
Вказує чи буде вміст RSS-каналу оновлюватись.

Властивість DownloadStatus


property DownloadStatus: FEEDS_DOWNLOAD_STATUS read Get_DownloadStatus
Повертає поточний статус завантаження фіда або його частини. Може приймати одне з наступних значень:



Властивість DownloadUrl


property DownloadUrl: WideString read Get_DownloadUrl
Повертає URL з якого проводиться завантаження каналу.


Властивість Image


property Image: WideString read Get_Image
Повертає URL на зображення для RSS-каналу.


Властивість Interval


property Interval: Integer read Get_Interval write Set_Interval
Повертає або встановлює проміжок часу (у хвилинах) через який буде проводиться автоматичне оновлення фіда.


Властивість IsList


property IsList: WordBool read Get_IsList
Повертає True , Якщо фід є списком.


Властивість ItemCount


property ItemCount: Integer read Get_ItemCount
Повертає кількість елементів каналу.


Властивість Items


property Items: IDispatch read Get_Items
Повертає перечіслітель (IFeedEnum) для елементів фіда (IFeedItem).


Властивість Language


property Language: WideString read Get Language
Повертає мову для RSS-каналу.


Властивість LastBuildDate




property LastBuildDate: TDateTime read Get_LastBuildDate;
 

Повертає дату останнього оновлення вмісту фіда. Може повернути 0 в разі, якщо канал щойно доданий або він ніколи не завантажувався.


Властивість LastDownloadError




 property LastDownloadError: FEEDS_DOWNLOAD_ERROR read Get_LastDownloadError;
 

Повертає останню помилку завантаження фіда. Може приймати одне з наступних значень:



Властивість LastDownloadTime




 property LastDownloadTime: TDateTime read Get_LastDownloadTime;
 

Час останньої успішної спроби оновити вміст фіда.


Властивість LastWriteTime




property LastWriteTime: TDateTime read Get_LastWriteTime;
 

Повертає дату і час останньої зміни фіда.


Властивість Link




property Link: WideString read Get_Link;
 

Повертає URL фіда.


Властивість LocalEnclosurePath




 property LocalEnclosurePath: WideString read Get_LocalEnclosurePath;
 

Повертає шлях до локального сховища вмісту RSS-каналу.


Властивість LocalId




property LocalId: WideString read Get_LocalId;
 

Повертає GUID для фіда.


Властивість MaxItemCount




 property MaxItemCount: Integer read Get_MaxItemCount write Set_MaxItemCount;
 

Повертає або встановлює максимальну кількість елементів фіда, які будуть завантажені.


Властивість Name




property Name: WideString read Get_Name;
 

Повертає ім'я RSS-каналу.


Властивість Parent




property Parent: IDispatch read Get_Parent;
 

Повертає інтерфейс батька RSS-каналу (IFeedFolder).


Властивість Path




property Path: WideString read Get_Path;
 

Повертає шлях до поточного RSS-каналу в Feed-менеджера.


Властивість PubDate




property PubDate: TDateTime read Get_PubDate;
 

Повертає дату і час публікації фіда.


Властивість SyncSetting




 property SyncSetting: FEEDS_SYNC_SETTING read Get_SyncSetting write Set_SyncSetting;
 

Повертає або встановлює властивості синхронізації вмісту RSS-каналу. Може приймати одне з наступних значень:



Властивість Title




property Title: WideString read Get_Title;
 

Повертає заголовок RSS-каналу.


Властивість Ttl




property Ttl: Integer read Get_Ttl;
 

Повертає час життя фіда, тобто час у хвилинах протягом якого фід буде перебувати в кеші до оновлення вмісту з джерела.


Властивість UnreadItemCount




property UnreadItemCount: Integer read Get_UnreadItemCount;
 

Повертає кількість непрочитаних елементів фіда.


Ось, мабуть основні методи і властивості інтерфейсу IFeed. Як бачите, за допомогою цього інтерфейсу можна витягнути максимум інформації по каналу, починаючи від копірайтів і картинок для каналу і, закінчуючи XML-кодом, приклавши до якого свої навички по роботі з NativeXML або MSXML можна на ходу проводити пошук по вмісту всього каналу, визначених фраз типу "лімузини санкт-петербург", "програмування в Delphi"," Новини "і т.д. Залишилося розглянути роботу ще одного інтерфейсу – IFeedItem (елемент фіда) і можна буде написати невеликий прімерчік ілюструє роботу з Windows RSS Platform у всій її красі. Але це вже в наступному пості. Залишайтеся з нами.


Схожі статті:


Сподобалася стаття? Ви можете залишити відгук або підписатися на RSS , щоб автоматично отримувати інформацію про нові статтях.

Коментарів поки що немає.

Ваш отзыв

Поділ на параграфи відбувається автоматично, адреса електронної пошти ніколи не буде опублікований, допустимий HTML: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>

*

*