| 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。在安装的 Instant Messenger 组件中，以 Javadoc 生成的 HTML 文件形式提供这些 API 的详细文档。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 服务 API 可用于：
Messenger Bean
Messenger bean 是动态加载的模块，用于扩充 messenger 功能。Messenger bean 可以添加操作收听者（例如按钮和菜单项）、项目收听者（例如现有 Instant Messenger 窗口中的复选框和切换按钮）。项目收听者在收到最终用户输入内容时被调用，bean 专有操作就是基于最终用户输入内容的。Bean 可以添加自己的设置面板，并在服务器上保存 bean 专有特性。可以向 Bean 通知 Instant Messenger 收到的任何事件，例如新的报警消息。
使用 Messenger Bean 的应用程序：
服务提供者界面
服务提供者界面 API 可用于扩充 Sun ONE Instant Messaging 服务器功能。服务提供者界面由下列三个独立的 API 组成：
归档提供者 API
归档提供者是一软件模块，通常提供与归档或审核系统的集成。将为每个服务过程调用每个配置的归档提供者。
下列服务器过程会调用归档提供者：
使用归档提供者 API 的应用程序：
备注
Sun ONE Instant Messaging 中的缺省 Instant Messaging 归档基于归档提供者 API。有关 Instant Messaging Archive 的详细信息，请参阅管理 Instant Messaging 归档。
消息转换 API
Message Converter 会针对通过服务器的每条消息或每个消息部分进行调用。Message Converter 既有可能不修改此消息部分，也可能进行一些修改，甚至删除此消息部分。文本部分将作为 Java 字符串对象进行处理。Message Converter 将其它附件作为字节流进行处理，然后返回有可能不同的字节流，如果要删除附件，则根本不返回任何内容。
使用 消息转换 API 的应用：
验证提供者 API
利用 验证提供者 API 可在不使用 Sun ONE Identity Server 基于密码或标记的验证服务的环境中部署 Sun ONE Instant Messaging。此 API 在最终用户请求验证时即会调用，它可以与 LDAP 验证结合使用。
使用 验证提供者 API 的应用：
