了解 Adobe Connect Web Services。 掌握基础知识,了解相关 API 的用处和用法。
Adobe Connect 公开了一些 Web 服务,客户端可以调用这些服务与 Adobe Connect 帐户交换数据。 您可以将 Web 服务用于 Adobe Connect 托管帐户以及 Adobe Connect 许可服务器上的帐户。
本指南介绍了应用程序如何调用 Adobe Connect Web 服务以及如何解析 XML 响应。 本指南面向对象为希望为 Adobe Connect 构建自定义应用程序或将其与其他系统(如学习管理系统或 LDAP 目录服务)集成的开发人员。
使用本指南之前,应了解 XML 以及使用 HTTP 从客户端应用程序与服务器进行通信的基础知识。 本指南包含一些 Java 代码示例,但并不要求您使用特定语言或环境。
Adobe Connect Web Services 的开发环境
借助 Adobe Connect Web Services,您可以使用任何语言或任何能够通过 HTTP 发送和接收 XML 的平台来开发自定义应用程序。 例如,您可以使用 Java 和 J2EE 平台、C#.NET、PHP、门户服务器或任何 Web 开发平台。 大多数自定义应用程序都属于 Web 应用程序或门户。
通常情况下,您可能会发现以下类型的工具很有用:
XML 解析器代码库(如果您的编程语言支持 XML 解析)。
Cookie 管理代码库,可助您管理 Adobe Connect 返回的会话 Cookie。
用于在浏览器中查看 HTTP 请求和响应头的工具。 Internet 上有许多此类工具。
其他资源
您可以在 Internet 上找到许多实用资源,可提供有关 Adobe Connect、Web 服务、XML 以及 Adobe Connect 使用的其他技术的信息。
Adobe Connect
Adobe Connect 用户社区
Adobe Connect 用户社区 (connectusers.com) 是 Adobe Connect 社区的中心。 此网站提供论坛、教程、活动、公告、合作伙伴展示等内容。
Adobe Connect 帮助支持中心
Adobe Connect 帮助和支持中心提供 Adobe Connect 文档以及联系信息,便于您获取支持。
XML 和 Web 服务
Web Services 入门
位于 Xml.com 网站 (xml.com),很好地介绍了 Web 服务。
XML 教程
位于 W3Schools 网站 (w3schools.com),可以助您快速入门 XML。
XPath 教程
同样位于 W3Schools 网站 (w3schools.com),描述了 XPath,其中包含对 XML 文档的解析,便于您在应用程序中使用。
XSLT 教程
W3Schools 网站 (w3schools.com) 提供的第三门教程,介绍如何使用 XSL 转换将 XML 数据转换为其他格式。
XSL 转换 (XSLT) 规范
位于 W3C 网站 (w3.org),包含由创建 XSLT 的标准委员会提供的官方定义。
日期和时间的数值表示形式
位于国际标准化组织网站 (iso.org),提供如何使用 ISO 8601 标准日期和时间格式的相关信息。
日期和时间格式
位于 W3C 网站 (w3.org),提供 ISO 8601 日期和时间格式的官方定义。
URI 的通用语法
有关保留字符和百分比编码的信息,请参阅 RFC3986。 必须使用保留字符的百分比编码对 URL 进行正确编码。
其他技术
SCORM 概念
位于 Eduworks Corporation 网站 (eduworks.com),提供有关可共享内容对象参考模型的教程,还介绍了可共享内容对象 (SCO) 和学习管理系统 (LMS)。
LDAP 路线图
位于 Kings Mountain Systems 网站 (www.kingsmountain.com),概述了轻量级目录访问协议 (LDAP),非常实用。 此网站提供的背景资料或链接对于将 LDAP 目录与 Adobe Connect 集成的开发人员而言可能会有帮助。
Microsoft SQL Server
Adobe Connect 使用 Microsoft SQL Server 数据库,自定义应用程序可以从中检索数据并向其中写入数据。 您可以在 Microsoft SQL Server 开发人员中心 (msdn.microsoft.com) 找到各种有用的资源,包括参考资料、社区、支持等信息。
Web Services 指南中使用的约定
本指南使用行业标准约定,因此您应该非常熟悉所显示的代码。
但是,对于 API 引用,使用的则是调用应用程序和服务器之间 API 合约中的正式定义。 因此,应描述请求 URL 的语法定义。
为便于阅读,我们做出调整,让请求 URL 的不同部分各成一行,如下所示:
http://server_name/api/xml ?action=custom-fields &filter-definition=value &session=BreezeSessionCookieValue
在浏览器的地址栏中输入请求 URL 或在应用程序中构建请求 URL 时,请让其单独成行:
https://example.com/api/xml?action=custom-fields&filter-name=location
以蓝色代码字体显示的语法元素表示您构建的定义中带有指向其语法的超链接。