現在,就一起來探索 Atom 那些令人振奮的方方面面吧。
作為一種聯合格式,Atom 並非憑空而來,而是從 RSS(有非常多版本)的實務經驗中淬鍊而成。它一方面把 RSS 規範裡含糊其辭的地方講清楚,讓格式更好用(例如 RSS 從未明訂 title 元素能否包含標記);另一方面修正了若干有問題之處(例如確定不同摘要間的重複項目——這種情況在聚合內容中屢见不鮮)。原本用於 RSS 的用戶端與工具,如今大多已支援或準備支援 Atom 內容;既然它解決了 RSS 的老問題,我會推薦採用它。不過基本上,Atom 對 RSS 而言是逐步改良,而非革命性的翻新。
Atom 邁出的一個進化步驟,是支援兩種基本類型的聯合文件:摘要(feed)與項目(entry)。摘要與 RSS 相似,是項目的集合;但項目本身也能作為獨立文件,內含一篇文章(可能是一則新聞或一篇部落格貼文),或對外部文件(例如一張圖片)的引用。兩者兼備,讓這種聯合格式為打造發布協議提供了靈活的基礎。
清單 1 展示了一個 Atom 摘要的小範例:
清單 1. Atom 摘要
<?xml version='1.0' encoding='UTF-8'?>
<feed xmlns='https://www.w3.org/2005/Atom'>
<id>urn:uuid:E14A6C6B-A832-4AE9-9D67-263181407D5E</id>
<link rel="self" href="/temp/index.atom"/>
<updated>2006-04-19T18:43:55Z</updated>
<title type='text'>Cool gizmos</title>
<subtitle type='text'>The latest in high-tech gizmos.</subtitle>
<author>
<name>Dethe Elza</name>
<email>dethe.elza@livingcode.org</email>
</author>
<entry>
<id>urn:uuid:2C31F522-20A6-44DF-AA63-6524441FF6A3</id>
<published>2006-05-02T19:00:10Z</published>
<updated>2006-04-30T20:57:20Z</updated>
<title type='text'>This new gizmo is hot, hot hot!</title>
<content type='text'>I just got my hands on the latest gizmo...</content>
</entry>
</feed>
作為發布協議,Atom 懷抱著更大的野心。過去曾數度嘗試打造管理 Web 內容(例如部落格)的通用協議(儘管常被誤稱為 API),但這些嘗試不是缺乏必要功能,就是得依賴某個工作區或私有介面。最關鍵的是,它們都沒有善用良好的 Web 應用實務,例如 REST。LiveJournal 是最早的嘗試之一,但它把一切都透過 HTTP POST 傳輸,忽略了 GET、PUT 與 DELETE,也沒使用 HTTP 驗證。XML-RPC 走了同樣的路——與 LiveJournal 協議一樣,所有資訊都靠 URI 傳遞;而且直到最近,XML-RPC 仍把字串限制在 ASCII,等於一開始就放棄了 XML 的主要優勢之一。雖然 XML-RPC 本身並非發布協議,但不少協議是以它為基礎的,包括 Manila RPC、Blogger API、MetaWeblog API 以及 LiveJournal XML-RPC Client/Server 協議。這些協議都不支援國際化、都以明文傳遞密碼,也都不易擴展。相比之下,Atom Publishing Protocol 徹底發揮了 XML(國際化、可用名稱空間擴展)與 HTTP(所有方法、驗證、以 URI 標識資源)的長處。
Atom Publishing Protocol 以部落格協議為基礎,卻又超越了它,成為管理 Web 內容的便利工具,應用範圍十分廣泛,包括 Bugzilla、Google Data APIs Protocol,以及上一期「XML 問題」提到的許多行事曆網站——還有一個當時未及討論、但底下就要談的重要網站。
我認為 Atom Publishing Protocol 是通往「可寫入 Web」征途上的一座重要里程碑。Web 從來都是雙向的,PUT 與 DELETE 方法一直是 HTTP 的一部分,只是在走向「讀/寫 Web」的路上曾經岔開了。我們透過 wiki、XML-RPC 與龐大的 WebDAV,一路緩慢地折返回 Web 最初的模樣。WebDAV(或簡稱 DAV,即 Distributed Authoring and Versioning,分散式編輯與版本管理)的目標是「完成 Web 最初的理想——成為一種可寫的、協作的媒介」(引自 WebDAV FAQ)。因此把 APP 與 DAV 拿來對比是公平的。DAV 提供的功能遠超 APP,包括鎖定、任意中繼資料的儲存,以及資源的刪除或重新命名。公平地說,Atom 也能支援任意中繼資料,因為透過 XML 名稱空間擴展輕而易舉。Atom 對協作的支援相對薄弱(僅有發布,含後續編輯),因此對鎖定的需求不大,而重新命名也可以用 DELETE 搭配 PUT 來完成——這些都不必擴展 HTTP 或新增方法。反觀 WebDAV,它極其複雜,一直飽受各家主要供應商糟糕且漏洞百出的實作所苦;即便如此,WebDAV 社群仍不滿足於 DAV 對 HTTP 的擴展,於是層層加碼(或準備)進一步擴展,例如 Advanced Collections、Versioning and Configuration Management(畢竟 Distributed Authoring and Versioning 竟不支援版本化)以及 Access Control。但這些擴展對行事曆來說還不夠,於是又出現了對 HTTP 做更多擴展的 CalDAV。
或許不令人意外,WebDAV 始終未能真正征服 Web——它難以實作,設定與管理也頗為麻煩。DAV 固然也有成功案例,特別是 Subversion 這個被捧為 CVS 接班人的版本控制系統。Subversion 建立在 DAV 與 Versioning 擴展(又稱 DeltaV)之上,但它只挑選了 DAV 中相關的部分,捨棄其餘,再加入自己的協議。儘管 Subversion 相當成功,卻並未能證明 DAV 那巴洛克式複雜性的正當性。對於 DAV 九成的功能,我認為 APP 更為合適;剩下的一成,則可交由其他系統處理。APP 本身並非包羅萬象的終極方案——它沒有解決驗證問題,未提供查詢機制,自然也無意支援即時協作這類功能。我認為讀/寫式 Web 仍在成長之中,也期待有天 Jabber XMPP 協議能嵌入瀏覽器,成為雙向即時的端對端協議,但那是後話了。
James Tauber 正在進行一個與 Atom 和 Subversion 有關的 Python 專案,稱為 Demokritos,它提供了 Atom Store;有趣的地方(至少對本文而言)在於底層使用 Subversion 提供持久化。專案仍處於早期階段(未來版本將加入驗證),但值得持續關注。Google Base 可視為 Atom Store 的商業版本(儘管多數上傳仍採用已被取代的 Atom Syndication Format 0.3 版);Amazon 的 S3 資料儲存則在「使用 HTTP GET/PUT/DELETE」這一點上,概念上近似於 Atom Publishing Protocol。有選擇當然好,但若所有選擇都能收攏到一個簡單而穩健的標準上,那就更理想了。
Atom Publishing Protocol 的運作方式是:用戶端可以先查詢自省(introspection)文件,這類文件列出了所提供的內容集合、能力(例如可讀、可寫)及其位址 URI。接著,用戶端可查詢集合本身,發現與其自身內容類似的其他資訊——可以是 Atom Entries,也可以是圖片、音訊、視訊之類的媒體。集合本身就是一份 Atom 摘要;要新增內容,只需 PUT 一份 Atom Entry 文件,收到指向該資源的 URI 後,就能對它進一步處理(用 POST 編輯、用 GET 讀取、用 DELETE 刪除)。舉例來說,清單 2 是一份簡單的自省文件:
清單 2. 自省文件範例
<?xml version="1.0" encoding='utf-8'?>
<service xmlns="https://purl.org/atom/app#">
<workspace title="Gizmo Page" >
<collection title="Cool gizmos"
href="https://example.org/gizmo/index.atom" >
<member-type>entry</member-type>
</collection>
<collection title="Photos of Gizmos"
href="https://example.org/gizmo/image" >
<member-type>media</member-type>
</collection>
</workspace>
</service>
這個自舉過程仍有個問題:一開始該如何發現自省文件?有一份雖已過期、卻被广泛實作的 IETF 草案——Atom Feed Autodiscovery,描述了如何在 HTML 頁面的中繼資料裡嵌入一個或多個 Atom 摘要引用。這套方法對自省文件同樣管用。做法很簡單:在 HTML 文件的 <head> 中插入一個 <link> 元素,其 rel 屬性含關鍵字「alternate」,type 屬性值為「application/atom+xml」,href 指向一份 Atom 摘要。雖然 Atom 工作小組未明確說明這套方法如何套用到自省文件上,但大致形式類似,只是如 Atom wiki 所述做幾點調整:rel 屬性改為「introspection」,type 屬性須為「application/atomserv+xml」,href 則指向自省文件而非摘要。無論哪種情況,<link> 元素都應在 title 屬性中包含人類可讀的值。例如:
<link rel="introspection" type="application/atomserv+xml"
href="/introspection.atomsrv" title="All about my feeds"/>
在上一期「XML 問題」中,我提到只有與 Atom 結合,微格式才能真正大規模落地。這句話至今仍然成立。Uche Ogbuji 是 Atom 的支持者,卻對微格式的使用持保留意見。專門針對 Atom 的微格式目前有兩種(就我所知):hAtom 是 Atom 的一個子集;此外還有一份關於「用於 Atom Publishing Protocol 的 XHTML 微格式」的 IETF 草案,提出了兩種微格式,用來在 APP 中描述類別與錯誤。我目前還沒看到這些微格式的實際應用。
最有趣的是,微格式是用來嵌入其他文件的,而 Atom 文件的目的正是要(以謹慎受控的方式)承載 HTML 或 XHTML 片段。因此,Atom 摘要裡沒有理由不能嵌入 hCalendar 制定的行事曆。事實上,就在上一篇文章進入最終編輯階段時,Google 發布了它的 Calendar 產品,允許以 Atom 格式訂閱行事曆摘要。可惜,雖然能以含 iCalendar 資訊的方式取得摘要,Google 卻沒在摘要中提供 hCalendar。有些人注意到了這點,寫出 GreaseMonkey 腳本之類的東西,在網頁中尋找 hCalendar 並加進 Google Calendar;但我更想走另一條路——用我的 Google Calendar Atom 摘要,向一份 hCalendar 格式的部落格新增事件。快速搜尋後沒發現有人做過,我只好自己動手寫了個簡單而粗糙的腳本。我用 Python 撰寫,需要兩個第三方函式庫:httplib2 與 ElementTree。這只是個示範,和一般範例一樣沒有做錯誤檢查,也不夠靈活。清單 3 展示了示範其用法的測試函式:
清單 3. Atom 轉部落格的腳本
''' Utility to grab a Google Calendar feed and return hCalendar code '''
import StringIO
import httplib2
import cElementTree
_ATOM_NS = 'https://www.w3.org/2005/Atom'
_GDATA_NS = 'https://schemas.google.com/g/2005'
_EVENT_TEMPLATE = '''<div class="vevent" xmlns="https://www.w3.org/1999/xhtml">
<abbr class="dtstart" title="%(start)s">%(start_hr)s</abbr> -
<abbr class="dtend" title="%(end)s">%(end_hr)s</abbr> -
<span class="summary">%(summary)s</span> - at
<span class="location">%(where)s</span>
<div class="description">%(description)s</div>
</div>
'''
def _entries_for_feed(feed_uri, start, end):
h = httplib2.Http('.cache')
resp, content = h.request('%s?start-min=%s&start-max=%s' % (feed_uri, start, end), 'GET')
doc = cElementTree.parse(StringIO.StringIO(content))
return doc.findall('//{%s}entry' % _ATOM_NS)
def _event_for_entry(entry):
when = entry.find('{%s}when' % _GDATA_NS)
start = when.get('startTime')
end = when.get('endTime')
where = entry.find('{%s}where' % _GDATA_NS).get('valueString')
summary = entry.findtext('{%s}title' % _ATOM_NS)
description = entry.findtext('{%s}content' % _ATOM_NS)
return locals().copy()
def events_for_feed(feed_uri, start, end):
return [_EVENT_TEMPLATE % _event_for_entry(entry) for entry in _entries_for_feed(feed_uri, start, end)]
把這支腳本接到行事曆摘要上,並提供起始與結束日期,它就會回傳一列 hCalendar 格式的字串,可以插入部落格中。這正是讀/寫式 Web 的優美之處:若某一方不支援你的格式,但他們用的格式是開放的、並附有文件(就像 Google 那樣),你便能依需求自行打造。我的觀點是——微格式與 Atom 相輔相成、缺一不可;這一點雖尚未完全證實,但至少以另一種方式說明了兩者能夠協同運作(儘管還有許多工作待完成)。
關於 Atom Publication Protocol 的研究仍在持續,其他相關規範(如 Google Calendar 擴展)亦然。網站正快速採用 Atom,應用程式與開發工具也在逐步適應它。開放、可擴展、定義清晰的格式,讓 Atom 有可能對 Web 產生類似關聯式資料庫之於企業那樣的深遠影響。HTTP GET 加上「檢視原始碼」,至今仍是極其實用的組合,一如 Web 的早年時光。
透過這篇簡短的介紹,我希望你能理解 Atom Syndication 格式的重要性,以及 Atom Publication Protocol 如何讓它的使用變得更單純。