Sun Java System Instant Messaging 7 2005Q1 管理指南 |
附錄 C
Instant Messaging API本章會描述 Instant Messaging 所使用的 API。
Instant Messaging API 摘要Instant Messaging 所提供的 Java API 可以用來開發延伸或整合模組。這些 API 的詳細文件皆以 Javadocs 所產生的 HTML 檔案形式提供已安裝的 Instant Messenger 元件。Javadoc 檔案安裝於 im_svr_base/html/apidocs/ 目錄。若要檢視 API 文件,請將瀏覽器指向 imcodebase/apidocs,其中 codebase 為 Instant Messenger 資源代碼庫。
下列為 Instant Messaging API:
Instant Messaging 服務 API位於相同主機或遠端主機中的應用程式會使用 Instant Messaging API 來存取 Instant Messaging 服務,例如「線上狀態」、「會議」、「通知」、「輪詢」和「新聞」通道。
Instant Messaging Service API 可以用於:
Messenger BeanMessenger Bean 是一個動態載入的模組,其作用在於延伸 Messenger 的功能。Messenger Bean 可以新增動作傾聽者 (例如按鈕和功能表項目) 以及項目傾聽者 (例如在現有 Instant Messenger 視窗中的核取方塊和切換按鈕)。當收到一般使用者輸入並且根據一般使用者輸入建立 Bean 特定的動作時,則會呼叫項目傾聽者。Bean 擁有能力可以新增它們自身的設定面板並將 Bean 特定的屬性儲存在伺服器中。可以使用 Instant Messenger 所收到的任何事件來通知 Bean。例如新的警示訊息。
使用 Messenger Beans 的應用為:
服務提供者介面「服務提供者介面 API」提供了延伸 Instant Messaging 伺服器功能的能力。「服務提供者介面」是由下列獨立的 API 所組成:
歸檔提供者 API
「歸檔提供者」是一個軟體模組,通常提供與歸檔或稽核系統的整合。每個配置的「歸檔提供者」會在每個伺服器程序中啟動。
「歸檔提供者」會在下列的伺服器程序中呼叫:
使用「歸檔提供者 API」的應用程式如下:
- Instant Messaging Archive
Instant Messaging 中的預設 Instant Messaging 歸檔是根據「歸檔提供者 API」所建立的。如需有關 Instant Messaging 歸檔的更多資訊,請參閱管理 Instant Messaging 歸檔。
- 記錄使用統計作為調整大小之用的應用程式
訊息轉換 API
可以在每個訊息或每個經歷伺服器的訊息部份中呼叫「訊息轉換程式」。「訊息轉換程式」可能會將訊息部份保留不變,或修改或移除訊息部份。文字部份會作為 Java String 物件處理。「訊息轉換程式」會將其他附件以位元組流的形式處理,並傳回潛在不同的位元組流。如果附件已刪除的話,則不傳回任何資料。
使用訊息轉換 API 的應用為:
認證提供者 API「認證提供者 API」提供了在不是使用 Access Manager 密碼基礎或記號基礎的認證服務的環境中部署 Instant Messaging 的能力。每當一般使用者請求認證時將會啟動 API,而它也可以用於與 LDAP 認證連結。
會使用認證提供者 API 單次登入 (SSO) Access Manager。此 API 也可以用來與其他認證系統進行整合。