仕様書

用法

[3] フィードから削除されたエントリーは通常フィードに含まれませんが、 そうするとキャッシュその他で既に以前のフィードから保存してあるエントリーが削除されたことを知る術がありません。 そのため削除されたエントリーを把握できるよう at:deleted-entry 要素が追加されました。 >>1

[20] とはいえ Atom処理器がこの要素に従い処理する保証はなく、 削除されたエントリーであっても処理を続ける可能性があることに注意が必要です。 >>1

文脈

[13] Atomフィードは任意の個数の at:deleted-entry 要素を含むことができますが、 ref と when の組み合わせが同じ物が複数あってはなりません >>1。

属性

[5] この要素には次の属性があります。

内容

[8] この要素の内容は次の通りです。

[14] 子要素の順序は任意です >>1 RELAX NG スキーマ。

[22] anyElement が RELAX NG スキーマ上認められていますが、その意味は明記されていません。 任意の要素、あるいは拡張要素を認めることを意図しているのかもしれませんが、不明です。

[23] atom:entry の子要素として使える各種要素を使いたいという需要はありそうなものですが、 それについて何も言及がなく、排除することを意図しているのか認めているのか不明です。例えば atom:published や atom:author を含めたいこともありそうですが。

エントリーと削除済みエントリー

[19] atom:entry 要素によって表されるエントリーと at:deleted-entry 要素によって表される削除済みエントリーで atom:id や ref が重複していても構いません。 その場合 atom:updated と when の日時を比較した上で、

• when の方が新しいか等しければ、削除済みとみなします。エントリーは無視するべきです。
• when の方が古ければ、再出版されたものとみなします。削除の方を無視するべきです。

... と解釈します。 >>1

保安性

[21] atom:entry や at:deleted-entry を不正に注入する手段があると、 本当は削除されていないエントリーを削除したように扱わせたり、その逆のように扱わせたりできるかもしれず、 注意が必要です。 >>1

例

     <feed xmlns="http://www.w3.org/2005/Atom"
           xmlns:at="http://purl.org/atompub/tombstones/1.0">
        ...
        <!-- Minimal deleted-entry -->
        at:deleted-entry
          ref="tag:example.org,2005:/entries/1"
          when="2005-11-29T12:11:12Z"/>

        <!-- Extended deleted-entry -->
        at:deleted-entry
          ref="tag:example.org,2005:/entries/2"
          when="2005-11-29T12:11:12Z">
          at:by
            <name>John Doe</name>
            <email>jdoe@example.org</email>
          </at:by>
          at:commentRemoved comment spam</at:comment>
        </at:deleted-entry>
        ...
     </feed>