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