中国移动MM7 API培训.pptVIP

中国移动研发中心 MM7 接口协议简介 MM7：是用于多媒体信息中心与增值应用之间的接口。该接 口基于HTTP或SMTP协议，为多媒体信息引入多种增值服务。 MM7 API简介 由于目前的MM7接口辅助API开发包均由MMSC厂商提供， 其结构定义各不相同，这对彩信增值业务的开发带来 障碍。因此，为推动彩信增值业务的发展，本规范对MM7接口API的功能和结构进行了统一定义。 API的主要作用是使SP无需关心底层的通信实现，只需 使用API即可简便的开发业务。 MM7 API功能定位示意图 MM7 API功能特点 采用JAVA语言编写，封装了API的底层通信实现方法 既支持短连接，也可以支持长连接 对于SP和彩信中心之间的鉴权的方法由API底层通信机制封装实现 MM7 API层次结构图 MM7 API层次结构五部分 系统配置信息类别 定义了有关本VASP和对应的MMSC的配置信息，并 保持当前系统一些有用的数据。 消息类别 将所有的MM7消息封装成类，每个类对应一种消息，用户 可直接通过消息对象所提供的方法对消息的属性进行设 置和访问。 消息辅助类别 定义一些帮助类，用于封装多媒体消息的内容和消息头的数值引用,由MMContent和MMConstants组成。 MM7 API层次结构五部分（续） 通信类别 API通过发送和接收类，隐藏了有关SOAP、HTTP及TCP 的底层操作，通过MM7Sender 和 VASPReceiver类来 发送、接收消息。 编解码类别 消息的编解码由编码器SOAPEncoder和解码器 SOAPDecoder来完成。功能是把定义的消息与的 SOAP消息相互转换。 消息类别继承关系 API关键类使用说明 MM7Config：定义了有关本VASP和对应的MMSC的 配置信息。系统在初始化时，必须对该对 象进行定义，它将用于通信类的控制。 MM7Sender：主要功能包括对象建立，初始化及 发送消息到多媒体消息中心,并将MMSC返回 的相应消息返回给调用者 MM7Receiver：应用程序方式的接收器，可被SP重 载来完成接收处理。 MM7ReceiverServlet：Servlet方式的接收器,目的 是方便SP在Web应用环境下实现对MMSC消息的接收处理。 Submit消息中字段的含义及填写方法 setTransactionID(String transactionID) 、getTransactionID() 表示设置或获得MM7_submit.REQ/MM7_submit.RES对的标识 ，只要求填写为String类型的即可，必备 getMM7Version() 表示获得标识VASP所支持接口的版本 ，目前为6.3.0 setVASPID(String vaspID) 、getVASPID() 表示设置或获得SP代码，SP代码由中移统一规定，目前为6位数字，必备 setVASID(String vasID) 、getVASID() 表示设置或获得服务代码 ，现在为4位数字，具体参见用户手册2.2节，必备 setServiceCode(String serviceCode) 、getServiceCode() 表示设置或获得业务代码，目前上行3位数字，下行6位数字，具体参加用户手册2.3节，必备 setSenderAddress(String senderAddress) 、getSenderAddress() 表示设置或获得MM始发方的地址 ，设置时可以填写SP的服务代码，或者填写让用户回复SP的长号码，长号码构成：SP的服务代码＋业务代码＋操作码 ，必备 setChargedPartyID(String chargedPartyID)、getChargedPartyID() 表示设置或获得付费方的手机号码 ，设置时注意一定是付费方的手机号码 ，必备 setTo(List addressList) 、addTo(String address) 、getTo () 表示设置或获得接收方的地址 setCc (List ccAddressList) 、addCc (String ccAddress) 、getCc() 表示设置或获得抄送方的地址 Submit消息中字段的含义及填写方法（续1） setBcc(List bccAddressList) 、addBcc(String bccAddress) 、getBcc() 表示设置或获得密送方的地址 以上三个地址（To、Cc、Bcc），在发送时必须至少填写其中一个 s