1.11 Calendar Server 版本 6.3 的公用 API

Calendar Server 包括以下 API：

• 1.11.1 Calendar Server 版本 6.3 的 Web 行事曆存取控制協定 (WCAP)

• 1.11.2 Calendar Server 版本 6.3 的事件通知服務 (ENS) API

1.11.1 Calendar Server 版本 6.3 的 Web 行事曆存取控制協定 (WCAP)

Calendar Server 支援 WCAP 3.0，WCAP 3.0 是一個基於指令的高階協定，允許與用戶端進行通訊。WCAP 指令 (副檔名為 .wcap) 可讓用戶端獲得、修改和刪除行事曆元件、使用者喜好設定、行事曆特性以及其他行事曆資訊 (例如時區)。WCAP 元素 (例如時間、字串和參數) 通常遵循 RFC 2445、RFC 2446 和 RFC 2447 規格。

WCAP 使用以下格式在 HTTP 訊息中傳回輸出行事曆資訊：

• 標準 RFC 2445 iCalendar 格式 (text/calendar)

• XML 格式 (text/xml)

透過 WCAP 指令，使用 login.wcap 登入的 Calendar Server 管理員具有以下能力：

• 置換 WCAP 指令的存取控制

  管理員可以使用 WCAP 指令讀取 (擷取)、替代 (儲存) 或刪除其他使用者的行事曆。若要使管理員擁有此權限，ics.conf 檔案中的以下參數必須設定為 "yes"：

  service.admin.calmaster.overrides.accesscontrol="yes"

• 擷取和修改任何使用者的喜好設定

  管理員可以使用 get_userprefs.wcap 和 set_userprefs.wcap 來擷取和修改任何使用者的喜好設定。若要使管理員擁有此權限，ics.conf 檔案中的以下參數必須設定為 "yes"：

  service.admin.calmaster.wcap.allowmodifyuserprefs="yes"

如需更多資訊，請參閱「Sun Java System Calendar Server 6.3 WCAP Developer’s Guide」。

1.11.2 Calendar Server 版本 6.3 的事件通知服務 (ENS) API

事件通知服務是一個警示派送程式它會偵測警示佇列中的事件並將這些事件的通知傳送給訂閱者。ENS API 可讓程式設計師修改 Calendar Server 使用的發佈和訂閱功能，以執行訂閱事件、取消訂閱事件以及通知事件訂閱者之類的功能。ENS API 由這些特定 API 組成：發佈者 API、訂閱者 API 以及發佈和訂閱派送程式 API。

如需有關 ENS API 的資訊，請參閱「Sun Java Communications Suite 5 Event Notification Service Guide 」。

Calendar Server 軟體也包含將 Java Message Queue 用於通知的支援，但是 csnotifyd 不會訂閱它。因此，它不是預設警示及通知系統的一部分。如需更多資訊，請參閱 Sun Java System Java Message Queue 文件。