作者:Jason Kitchen 劉建華 譯
Jabber 是一套開放、以 XML 為資料模型與傳輸格式的即時訊息協定。它最大的意義,是讓開發者擺脫「即時訊息伺服器必須向特定服務商購買」的束縛。本文示範如何用開源的 Java API,把即時訊息能力接進自己的應用程式。
即時訊息作為個人對個人的通訊工具已經非常成功,有些地方甚至取代了電子郵件成為首選聯絡方式。但一直到最近,這項技術仍掌握在少數服務商手上,各家採用私有協定,形成一座座通訊孤島。開發者面臨一個兩難:要嘛支援多種協定,要嘛綁死在單一服務商上,而無論哪種選擇,都必須依賴屬於該服務商的伺服器。
開放協定的價值就在這裡:它鼓勵出現多種競爭性的實作,促成單一公共協定的普及,避免孤島化。Jabber 的架構刻意模仿網際網路上一貫採用的分散式模型——正如電子郵件由散落在各地的伺服器分擔,Jabber 用戶連上的也是本地伺服器,而不是某個中央巨型主機。這與 AIM、ICQ、MSN、Yahoo 這類集中式服務形成鮮明對比。
Jabber 的位址格式幾乎等同基本 SMTP 風格,例如 myname@elogex.com 就是一個合法的 Jabber 位址(JID,Jabber ID)。此外,多數 Jabber 伺服器實作都可自由取得,你不必再依賴第三方 IM 服務商。
IETF 的 IMPPWG(即時訊息與現場協定工作組)已有多份有效 RFC,其中最重要的是 RFC 2778(現場與即時訊息模型)與 RFC 2779(即時訊息/現場協定需求),並已起草名為 CPIM(Common Presence and Instant Messaging)的網際網路標準。Jabber 本身也是一份草案標準,但不屬於 IMPPWG 的工作範圍。Jabber 官方表示承諾支援包括 IETF 協定在內的任何開放即時訊息協定,並打算把自己定位為推動 IETF 協定的開放原始碼平台。目前 IETF 的工作仍偏重需求收集而非實作,因此 Jabber 暫時成為事實上的開放即時訊息標準。
另一個值得留意的競爭者是 Sun 的 Jxta——同樣以 XML 為基礎,但鎖定 P2P 應用開發。由於起步較晚,Jxta 的能見度與採用度目前仍不及 Jabber。
由於各實作都採用標準的 Jabber XML 與終端應用溝通,伺服器的選擇相對自由。Jabberd 是最早的實作,開放原始碼、設定簡單,在 Unix、Linux、Windows 與 Mac OS X 上都可用。JabaServer 也是值得一看的 Java 方案,但目前成熟度仍不如 Jabberd,而且安裝前必須先下載、設定第三方資料庫並建立必要的表結構。
本文選用 Jabberd。官方同時提供二進位與原始碼發佈,除非你想自行編譯,否則直接下載二進位檔即可。在 Windows 上安裝就是執行 .exe 並依精靈前進;裝完在 Windows 2000 上甚至不必額外設定,雙擊執行檔就能啟動。
本文使用開源的 Exodus 用戶端(0.6 版)。它附帶一個除錯頁籤,可以直接檢視收發的原始 XML,也能手動鍵入 XML 訊息送給伺服器,對測試協定行為相當方便。解壓後即得執行檔與一個 DLL。若要用 Java 端開發,則需另外下載 Muse API。
使用 Muse 時,先建立 JabberContext,再交給 Jabber 的 session 工廠:
// 初始化 Jabber context
JabberContext jabberContext = new JabberContext("user", "pass", "localhost");
// 建立 Jabber session factory
Jabber jabber = new Jabber();
// 建立新 session
JabberSession jabberSession = jabber.createSession(jabberContext);
JabberContext 保存使用者相關資訊(帳號、密碼、位址)以及後續建立 session 時需要的唯一識別碼;為了示範,這裡直接寫死了帳號、密碼與主機。
接著連線並登入:
// 連線到伺服器
jabberSession.connect("localhost", 5222);
// 登入
jabberSession.getUserService().login();
標準的 Jabber 連接埠是 5222。login() 本身不帶參數,它會回頭向與 session 關聯的 JabberContext 取用身分資訊。
JabberSession 是 Muse 存取伺服器各項服務的主要入口,包括:連線服務(連線與中斷)、使用者服務(認證與註冊)、現場服務(接收與廣播 presence)、名冊服務(好友清單/通訊簿)、聊天服務(群聊、私聊、標題等多種訊息類型)、伺服器服務(查詢本機提供的服務)與客戶服務(例如查詢他人最後登入時間)。
// 建立測試訊息
JabberChatMessage msg =
new JabberChatMessage(JabberChatMessage.TYPE_HEADLINE);
msg.setSubject("Hello world");
msg.setBody("Hello world");
msg.setTo("user2@localhost");
// 送出
jabberSession.sendMessage(msg);
JabberChatMessage 這個名字有點誤導——它其實能承載 Jabber 協定定義的四種訊息:normal、chat、headline 與 error。setSubject() 與 setBody() 分別設定主旨與本文,setTo() 指定收件者的 JID。在封裝內部,這些資訊會被轉成 DOM 樹,送出時再序列化為 XML。
Muse 把連線管理與 XML 解析的細節都藏了起來,但了解底層的交換過程很有幫助。以下用 RECV/SEND 前綴分別標示接收與送出的訊息。
所有 Jabber 交換都發生在 XML 串流的上下文中,連線存活期間雙方各維持一份 XML 文件,逐段傳輸:
SEND: <?xml version="1.0" encoding="UTF-8" ?> <stream:stream to="localhost" xmlns="jabber:client" xmlns:stream="https://etherx.jabber.org/streams"> RECV: <stream:stream from="localhost" id="3D160545">
隨後客戶端詢問可用的認證方式:
SEND: <iq xmlns="jabber:client" type='get' id='id_10028'>
<query xmlns="jabber:iq:auth">
<username>user</username>
</query>
</iq>
RECV: <iq xmlns="jabber:client" type='result' id='id_10028'>
<query xmlns="jabber:iq:auth">
<username>user</username>
<password />
<digest/>
<sequence>482</sequence>
<token>3D15E63A</token>
<resource />
</query>
</iq>
伺服器列出的選項有三種:純文字(password 標籤)、零知識認證(sequence 與 token 標籤),以及 digest——形式與純文字相同,但密碼經過 SHA-1 編碼。本例採用 digest:
SEND: <iq xmlns="jabber:client" type='set' id='id_10030'>
<query xmlns="jabber:iq:auth">
<username>user</username>
<hash>425c73373237061edcc5f23ba239c6cc69556f5c</hash>
<resource>Home</resource>
</query>
</iq>
RECV: <iq xmlns="jabber:client" type='result' id='id_10030'></iq>
認證通過後就能送訊息:
SEND: <message xmlns="jabber:client" type='headline' id='id_10032' to='user2@localhost'> <thread xmlns="jabber:client">id_10033</thread> <subject xmlns="jabber:client">Hello world</subject> <body xmlns="jabber:client">Hello world</body> </message>
值得注意的是 id 標籤反覆出現:由於一個 session 可能同時包含多個非同步會話,id 負責把請求與回應配對起來。
Muse 用 listener 機制接收進來的訊息。listener 實際上是掛在連線上,但 JabberSession 提供了便利方法,因此我們掛在 session 層級:
jabberSession.addMessageListener(
new JabberMessageListener() {
public void messageReceived(JabberMessageEvent event) {
if (event.getMessageType() == JabberCode.MSG_CHAT) {
JabberChatMessage msg =
(JabberChatMessage)event.getMessage();
JabberChatMessage reply =
new JabberChatMessage(JabberChatMessage.TYPE_HEADLINE);
reply.setTo(msg.getFrom());
reply.setSubject("Re: " + msg.getSubject());
reply.setBody(
"I'm just a sender: please send messages to someone else");
// 送出回覆
jabberSession.sendMessage(reply);
}
}
}
);
客戶端可以掛多個 listener,每收到一則訊息就依序呼叫。常見做法有三種:為每一種要處理的訊息類型各掛一個 listener;同一類型但依不同行為再細分多個 listener;或者只掛一個 listener 全包。選擇取決於你想完成什麼。
listener 必須是實作 JabberMessageListener 介面的類別實例,該介面只要求實作 void messageReceived(JabberMessageEvent)。在上例中,先判斷訊息類型(Jabber 用戶代理通常以 MSG_CHAT 送訊),再從事件中取出訊息、設定回覆收件人、沿用原主旨加上 Re: 前綴、帶入預設本文,最後用 sendMessage() 送回。
Jabber 的應用遠不限於傳統 P2P 風格的聊天。例如 jogger.jabber.org 提供的 Jogger,讓你傳一則訊息就能更新個人 Weblog;在協作類與使用者服務類應用上,Jabber 同樣有可觀的發揮空間。
如範例所示,透過 Muse 或 JabberBeans 這類 API,幾行 Java 程式碼就能具備即時訊息能力。本文受限於篇幅,無法涵蓋 presence 服務與名冊管理等重要特性;另一個關鍵優勢是 Jabber 伺服器的模組化與可擴充性——開發者可以直接把自製服務掛進伺服器。