附录 C Instant Messaging API

Instant Messaging 提供可以用来开发扩展或集成模块的 Java API。在安装的 Instant Messenger 组件中，以 Javadoc 生成的 HTML 文件形式提供这些 API 的详细文档。 Javadoc 文件安装在 im_svr_base/html/apidocs/ 目录中。要查看 API 文档，请将浏览器指向 imcodebase/apidocs，其中 codebase 是 Instant Messenger 资源代码库。

Instant Messaging 服务 API

Instant Messaging API 供位于同一主机或远程主机中的应用程序使用，以访问 Instant Messaging 服务，如“在线状态”、“会议”、“通知”、“轮询”和“新闻频道”。

基于 Java 或基于 Web 的客户机，例如门户频道

启用另一类客户机的网桥或网关。

将 Instant Messenger 和“在线状态”集成到现有应用程序中

将新闻信息包显示为 Instant Messenger 新闻。

Messenger Bean

Messenger bean 是动态加载的模块，用于扩充 messenger 功能。Messenger bean 可以添加操作侦听器（例如按钮和菜单项）、项目侦听器（例如现有 Instant Messenger 窗口中的复选框和切换按钮）。项目侦听器在收到最终用户输入内容时被调用，bean 专有操作就是基于最终用户输入内容的。Bean 可以添加自己的设置面板，并在服务器上保存 bean 专有属性。可以向 Bean 通知 Instant Messenger 收到的任何事件，例如新的警报消息。

可让最终用户共享应用程序、会议及音频或视频。

可以检索和处理会议的抄本以作归档之用，例如收到或发送的警报的内容。



注	“Instant Messenger 归档控制”功能通过 Messenger Bean 提供。

服务提供者接口

“服务提供者接口 API”可用于扩充 Instant Messaging 服务器功能。服务提供者接口由下列三个独立的 API 组成：

归档提供者 API

文档转换器 API

验证提供者 API

归档提供者 API

Archive Provider 是一个软件模块，通常提供与归档或审核系统的集成。系统将为每个服务器进程调用每个配置的 Archive Provider。

发送即时消息时。例如警报、轮询、聊天、新闻或会议等“即时消息”。

验证事件（例如登录或注销）时。

在线状态发生变化时。

订阅事件时。例如，有人加入或离开会议、订阅或取消订阅新闻频道时。

Instant Messaging Archive

Instant Messaging 中的默认 Instant Messaging 归档基于“归档提供者 API”。有关 Instant Messaging 归档的更多信息，参见管理 Instant Messaging 归档。

为调整大小而记录使用统计资料的应用程序

消息转换 API

Message Converter 会针对通过服务器的每条消息或每个消息部分进行调用。Message Converter 既有可能不修改此消息部分，也可能进行一些修改，甚至删除此消息部分。文本部分将作为 Java 字符串对象进行处理。Message Converter 将其他附件作为字节流进行处理，然后返回有可能不同的字节流，如果要删除附件，则根本不返回任何内容。

病毒检查和消除

转换引擎集成

消息内容过滤

验证提供者 API

利用“验证提供者 API”可在不使用 Access Manager 基于口令或基于标记的验证服务的环境中部署 Instant Messaging。此 API 在最终用户请求验证时即会调用，它可以与 LDAP 验证结合使用。

对 Access Manager 的“单点登录”(SSO) 是使用“验证提供者 API”来执行的。此 API 还可用于集成其他验证系统。

上一页目录索引下一页
Sun Java System Instant Messaging 7 2005Q1 管理指南