第 9 章

确认服务 API

通过 Sun Java System Content Delivery Server 确认服务 API，Content Delivery Server 可以处理多媒体消息服务中心 (MMSC) 发送的的确认信息。确认信息一般在内容下载到设备后发送。

确认服务 API 包括

ConfirmServiceAdapter 类：一个抽象类，您可以扩展该类以连接到 MMSC 并监听消息。
ConfirmResponse 类：包含收到的确认信息的类。
ConfirmServiceException 类：确认服务 API 抛出的异常。

有关这些类的其他信息，请参见 $CDS_HOME/javadoc/cdsapi/index.html 处的 Javadoc 工具的 HTML 输出。

9.1 一般处理流程

Content Delivery Server 可以将多媒体消息中的内容发送到支持多媒体消息服务 (MMS) 标准的设备。当设备收到 MMS 消息内容时，确认消息将通过 MMSC 发回。使用确认服务 API 编写的确认服务适配器用于设置 Content Delivery Server 与 MMSC 间的连接，以及处理来自 MMSC 的确认消息。

9.2 ConfirmServiceAdapter 类

ConfirmServiceAdapter 类使用 MMSC 建立连接、监听确认消息以及将收到的消息传递到 Content Delivery Server。扩展 ConfirmServiceAdapter 以创建系统的确认服务适配器。

ConfirmServiceAdapter 类位于 com.sun.content.server.confirmservice 包中。

9.2.1 connect()

public abstract boolean connect() throws ConnectionFailedException 

使用此方法可以将 Content Delivery Server 连接至正在使用的 MMSC。

9.2.2 listen()

public abstract void listen() throws ConfirmServiceException 

使用此方法可以监听来自 MMSC 的确认消息。收到确认消息时，通过使用消息中的信息可以创建 ConfirmResponse 对象并调用 messageReceived() 方法。

ConfirmResponse 对象需要下表中显示的信息。

9.2.3 messageReceived()

protected void messageReceived(ConfirmResponse confirmResponse) throws ConfirmServiceException 

使用此方法可以将确认消息中收到的信息发送到 Content Delivery Server。从 listen() 方法的实现中调用此消息。

9.3 使用确认服务 API

在 $CDS_HOME/deployment/deployment-name/conf 目录中修改 ConfirmListener.properties 文件来添加以下属性的另一个实例：

confirmservice.class.id 

将此属性设置为 ConfirmServiceAdapter 的实现的类名。例如，

confirmservice.class.id=com.sun.content.server.server.confirm.mms.MMSConfirmService 

确认服务 API 的类可以在 cdsapi.jar（位于 $CDS_HOME/deployment/deployment-name/lib/cdslib 目录）中找到。

编译适配器时，cdsapi.jar 文件必须位于类路径中。

为使适配器可用于 Content Delivery Server，请执行以下操作：

定制指南 Sun Java™ System Content Delivery Server，版本 2004Q1

版权所有 © 2004 Sun Microsystems, Inc. 保留所有权利。必须依据许可证条款使用。