1 - 简介

Sun Java System Content Delivery Server 定制指南

要部署商业服务，运营商必须将 Sun Java System Content Delivery Server 与现有基础架构集成在一起。记帐系统、用户管理系统和报告系统都具有集成要求，并且涉及运营商的复杂级别。Sun Java System Content Delivery Server API 对此系统集成很有帮助。

1.1 事件服务 API

事件服务 API 提供事件的异步报告，以便外部系统能够提取这些事件或收到事件通知。事件服务 API 使用由管理器组件发布的所有消息。对于每条消息，将提取消息的上下文和详细信息，将其插入数据库中，并进行传播以便在记帐、报告、消息传送和广告中使用。

1.2 记帐 API

记帐 API 支持预付和同步记帐模型。对于支持在购买内容之前收费的记帐系统，记帐 API 用于在允许订户下载内容之前验证其帐户资金足够。对于要求实时记帐的记帐系统，记帐 API 用于在内容被购买时对订户帐户进行收费。

通过记帐 API，运营商还可以对不是在 Vending Manager 中指定的内容收取不同的费用。例如，如果运营商要为商务订户提供特殊折扣，记帐 API 将用于从记帐系统中检索特殊价格并将该价格显示给客户。

1.3 内容管理 API

通过内容管理 API 可以在内容下载到订户设备时对其进行测试。在传给订户之前需要使用用户特定数据或记帐特定数据立即测试内容时使用此 API。内容管理 API 还可以用于更改内容的属性，例如 MIME 类型或内容类型。

1.4 内容验证 API

内容验证 API 处理提交给 Content Delivery Server 的内容。使用此 API 可创建自动验证提交内容时所需的内容验证适配器。在将内容提交到 Content Delivery Server 时执行的提交验证器工作流会使用内容验证适配器。

1.5 用户配置 API

用户配置 API 提供了可进入现有订户数据库的接口。它集成了订户、应用程序开发者、管理员和设备的数据源。运营商无需创建单独的新数据库即可使用 Content Delivery Server。如果运营商需要组合或合并多个数据库项，则用户配置 API 将有助于集成此数据，而不会影响其他服务请求信息。它还有助于集成旧版信息。

通过用户配置 API，Content Delivery Server 为所有访问数据库的组件提供了一个公共服务层。将数据访问抽象化使得 Content Delivery Server 可以不受特定数据库的束缚。通过对请求中频繁使用的数据加以缓存，此服务提供了对基本数据的可伸缩访问。与安全机制结合使用，可以跨不同的用户或管理员控制数据访问。

1.6 WAP 网关 API

WAP 网关 API 用于处理手机识别号 (MSISDN) 验证与头传输中的实现差异。使用 MSISDN 进行验证和会话管理为订户和运营商提供了便利。Content Delivery Server 支持单点登录，因此，如果订户通过移动电话访问系统，则可以使用请求标题执行验证，而无需提供订户的用户名和密码。Content Delivery Server 可以配置为与多个网关类型并行通信。

1.7 消息传送 API

消息传送 API 提供了一种机制，使运营商或应用程序供应商可以通过提供适配器来集成自身的 WAP 或短消息服务 (Short Message Service, SMS) 推送实现。Content Delivery Server 还提供了可以在大多数情况下使用的默认 WAP 和 SMS 推送实现。

1.8 确认服务 API

通过确认服务 API，Content Delivery Server 可以处理多媒体消息服务中心 (Multimedia Messaging Service Center, MMSC) 发送的确认消息。确认信息一般在内容下载到设备后发送。此 API 用于创建指向 MMSC 的连接并监视 MMSC 发送的消息。

1.9 流式传输 API

流式传输 API 处理 Content Delivery Server 与流式传输服务器之间的交互。如果 Vending Manager 储存按需流式传输的内容，则会将其复制到流式传输服务器。如果 Vending Manager 不储存该内容，则会将其从流式传输服务器中删除。当订户购买内容时，将提供用于启动流的 URL。

流式传输 API 包含一些类，用于描述流式传输的内容和购买内容的订户。如果系统支持流式传输的内容，则可以使用该 API 来创建流式传输适配器。

1.10 订户 API

通过订户 API 可以访问由 Content Delivery Server 维护的数据。使用此 API 可以获取创建客户机应用程序所需的数据，以便订户可以访问由 Content Delivery Server 管理的内容。订户 API 可以由基于 Java 技术的本地应用程序（Java 应用程序）直接访问，也可以使用 XML-RPC 从远程应用程序或使用 Java 之外的编程语言编写的应用程序进行访问。

1.11 Vending Manager API

可以使用 Vending Manager API 访问由 Content Delivery Server 维护的 Vending Manager 数据。可以使用该 API 创建和管理包、活动、订户群和订户计划，而无需通过 Vending Manager 管理控制台界面来实现。可以通过 XML-RPC 来访问 Vending Manager API。

1.12 设备客户机 Web 服务

可以使用设备客户机 Web 服务通过 Internet 访问订户 API。可以使用这些 Web 服务通过标准 Web 协议访问由 Content Delivery Server 维护的数据。

1.13 按功能标识的 API

下表表明了用于将某些 Content Delivery Server 功能与现有系统集成的 API。要获得想要在所安装的 Content Delivery Server 中支持的功能，必须实现指定的 API。

表 1-1 到 Content Delivery Server API 的功能映射
功能	系统	API
为朋友购买	简单邮件传输协议 (Simple Mail Transfer Protocol, SMTP)、短消息服务中心 (Short Message Service Center, SMSC)、推送代理网关 (Push Proxy Gateway, PPG) 和多媒体消息服务中心 (Multimedia Message Service Center, MMSC)	消息传送 API
告诉朋友	SMTP、SMSC、PPG 和 MMSC	消息传送 API
事件驱动的活动^{^[1]}	SMTP、SMSC、PPG 和 MMSC	消息传送 API
外发活动*	SMTP、SMSC、PPG 和 MMSC	消息传送 API
确认推送消息	SMTP、SMSC、PPG 和 MMSC（服务必须返回确认消息）	确认服务 API
外部用户数据库	轻量目录访问协议 (Lightweight Directory Access Protocol, LDAP)	用户配置 API
记帐 - 预付	预付记帐系统	记帐 API
记帐 - 后付费	后付费记帐系统	事件服务 API
与外部数字权限管理 (External Digital Rights Management, DRM) 集成	外部 DRM 引擎	内容验证 API, 内容管理 API
单点登录和设备登录	WAP 网关（必须传递 MSIDN 或唯一 ID）	WAP 网关 API
流式传输	流式传输服务器	流式传输 API
门户集成	Web 门户	订户 API, 设备客户机 Web 服务
包、活动、订户计划、订户群	Vending Manager	Vending Manager API

^{1 (表格注解) 促销活动不要求与外部系统集成}

1

简介