nsIFeedProgressListener

nsIFeedProgressListener インタフェースは、RSS あるいは Atom フィードの処理中に使われるコールバックを定義します。フィードコンテントアクセス API を使うプログラムはこれらのコールバックのいずれも実装する必要はありません。それらは任意ですが、パース処理中にフィードバックを提供することができます。

継承元: nsIFeedResultListener

メソッドの概要

メソッド

handleEntry()

エントリあるいはアイテムが処理された後に呼ばれます。もしドキュメントが単独のアイテムあるいはエントリなら、 handleFeedAtFirstEntry() メソッドが呼ばれることなく、nsIFeedEntry が parent の値に null を持つでしょう。

 void handleEntry(
   in nsIFeedEntry entry,
   in nsIFeedResult result
 );

パラメータ

<tt>entry</tt>

ちょうど処理されたエントリに関する情報を含んでいる nsIFeedEntry のポインタ。

<tt>result</tt>

処理されているフィードに関する現在の情報を含む nsIFeedResult のポインタ。

handleFeedAtFirstEntry()

そのフィードで最初にエントリあるいはアイテムに出会った時に呼ばれます。Atomでは全てのフィードデータがエントリーに先行する必要があります; RSSではこれは必要ではありませんが通常はそうです。言い替えるとこのメソッドが呼ばれるとき、十中八九、ほとんどあるいは全てのフィードレベルのメタデータが処理され、受け取った nsIFeedResult オブジェクトで利用できるでしょう。

 void handleFeedAtFirstEntry(
   in nsIFeedResult result
 );

パラメータ

<tt>result</tt>

最初のエントリが見付かったが、処理される前の時点のフィードを表す nsIFeedResult。

handleStartFeed()

フィードで妥当な先頭部分が検出されるとただちに呼ばれます; これはあなたのコードにそのフィードが他の種類のドキュメントではなく実際のフィードであるように見えることを知らせてくれます。

 void handleStartFeed(
   in nsIFeedResult result
 );

パラメータ

<tt>result</tt>

フィードがパースされ始めた時点での状態を表す nsIFeedResult。

reportError()

致命的な XML パースエラーが発生したときや、ドキュメントがフィードではなかったときにフィードプロセッサによって呼ばれます。

 void reportError(
   in AString errorText,
   in long lineNumber,
   in boolean bozo
 );

それぞれのメソッドは少なくとも処理の時点での状態を表す nsIFeedResult を入力として受け取ります。

参照

nsIFeedResultListener

Interwiki link