1.11 Calendar Server 版本 6.3 的公共 API

Calendar Server 包括以下 API：

• 1.11.1 Calendar Server 版本 6.3 中的 Web 日历访问协议 (Web Calendar Access Protocol, WCAP)

• 1.11.2 Calendar Server 版本 6.3 中的事件通知服务 (Event Notification Service, ENS) API

1.11.1 Calendar Server 版本 6.3 中的 Web 日历访问协议 (Web Calendar Access Protocol, WCAP)

Calendar Server 支持 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 中的事件通知服务 (Event Notification Service, ENS) API

事件通知服务 (Event Notification Service, ENS) 是一种报警分发程序，它会检测报警队列中的事件并向这些事件的订户发送通知。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 文档。