中国移动MM7 API用户手册(四)
2.7递送报告
报告是接收方（终端）对接收到消息的处理方式信息。递送报告指MMSC在获取这个报告后把这个信息发送给发送方（SP）。接收方对消息的处理可能是接收或者拒绝等。处理流程如下：
l SP发送消息（通过MMSC）给终端，并且要求递送报告；
l 终端接收到消息后做相应处理（接收或拒绝）；
l MMSC把终端对消息的处理信息（递送报告）发送给SP。
3.安装方法
这里主要介绍一下如何将MM7 API运用到VASP自己开发的程序中以及在配置文件中需要注意修改的地方。
3.1 MM7 API的使用
在VASP用Java开发自己程序时，只要将中国移动集团公司提供的mm7api.jar和lib下的所有的Jar文件加入到classpath中即可。
3.2配置文件的设置
配置文件mm7Config.xml需要根据SP情况进行修改。
<?xml version="1.0"?>
<vasp:MM7Config xmlns:vasp="http://mms.chinamobile.com/mm7ConfigSchema">
<AuthenticationMode>1</AuthenticationMode>
<UserName>zxme</UserName>
<Password>zxme</Password>
<MaxMessageSize>100000000</MaxMessageSize>
<LogPath>c:\vas_log</LogPath>
<logLevel>1</logLevel>
<LogNum>100</LogNum>
<LogInterval>120</LogInterval>
<LogSize>200</LogSize>
<Charset>UTF-8</Charset>
<MmscID>1</MmscID>
<mmscURL> /mm7</mmscURL>
<mmscIP>192.120.231.180</mmscIP>
<UseSSL>true</UseSSL>
<ListenIP>192.120.231.228</ListenIP>
<ListenPort>80</ListenPort>
<BackLog>50</BackLog>
<TimeOut>10000</TimeOut>
<ReSendCount>5</ReSendCount>
</vasp:MM7Config>
一些地方需要进行修改，下面一一说明：
<AuthenticationMode>1</AuthenticationMode>
表示VASP作为服务端接收消息时是否进行鉴权或进行什么样的鉴权，0表示不鉴权，1表示进行基本鉴权，2表示进行摘要鉴权。
<UserName>zxme</UserName>
<Password>zxme</Password>
表示彩信中心对VASP进行鉴权时的用户名和密码，同时也是VASP对接入的彩信中心进行鉴权时用户名和密码，是双向的，要VASP和MMSC双方进行约定。
<LogPath>c:\vas_log</LogPath>
表示日志存放的路径，在Windows操作系统下和Linux下是不一样的，要注意进行修改。
<MmscID>1</MmscID>
表示MMSC网关的序号，需要从MMSC处得到。
<mmscURL> /mm7</mmscURL>
<mmscIP>192.120.231.180</mmscIP>
分别表示MMSC网关的URL地址和IP（或主机名），也需要MMSC处得到。这里也可以填成ip:port。例如：192.120.231.180:8080,不填端口号使用默认端口号80。
<ListenIP>192.120.231.228</ListenIP>
<ListenPort>80</ListenPort>
表示当VASP用应用程序方式进行接收消息时的监听地址和端口号。
以上为这个配置文件中主要需要注意修改的地方，当然其他的内容也可以进行修改，如<logLevel>1</logLevel>可以根据需要进行修改，0表示不产生日志；1表示产生错误日志；3表示产生信息日志；6表示产生完整信息日志。
<TimeOut>10000</TimeOut>
表示设置发送的超时时间，到发送超过这个时间，则自动进行重新发送。
<ReSendCount>5</ReSendCount>
表示设置重发的次数，建议在10次以下，一般用3－5次即可。
4.开发方法
这里主要介绍从SP接收MMSC发过来的DeliverReq开始，到SP发送SubmitReq到MMSC的整个流程，SP所需要做的工作。
4.1 VASP接收传送请求（上行业务）
VASP接收可以有两种方式：
l 如果SP的增值应用是一个普通应用程序，可以使用方式1，即接收代理会自动打开一个监听端口，启动一个监听线程来接收来自MMSC的多媒体消息；
l 如果SP的增值应用是一个Web应用，则可以使用方式2，即接收代理作为一个Servlet运行，并自动处理从HttpRequest中搜索数据，并解码成多媒体消息。
4.1.1 方式1：普通应用程序中的用法
public class MyReceiver extends MM7Receiver
{
//定义一个MM7DeliverReq，以便得到MMSC发过来的Deliver消息。（必备）
public static MM7DeliverReq deliverReq = new MM7DeliverReq();
//Main方法
public static void main(String[] args)
{
//初始化VASP
MM7Config mm7Config = new MM7Config(“./config/mm7Config.xml”);
//设置ConnConfig.xml文件的路径
mm7Config.setConnConfigName(“./config/ConnConfig.xml”); //必备
//构造MyReceiver
MyReciever receiver = new MyReceiver();
myReceiver.setConfig(mm7Config); //必备
//创建MM7消息发送接口
MM7Sender mm7Sender = new MM7Sender(mm7Config);
//启动接收器
receiver.start();
}
public MM7VASPRes doDeliver(MM7DeliverReq request)
{
/*接收从MMSC发过来的传送消息，以便取出其中的部分值构造提交消息或得到一些有用
信息，如MMSC的标识符等*/
deliverReq = request;
System.out.println(“收到手机”+request.getSender()
+“提交的消息，标题为：”+request.getSubject());
System.out.println("MMSC的标识符为："+request. GetMMSRelayServerID()) ;
//SP需要进行一些处理，例如构建MM7DeliverRes消息，设置ServiceCode或StatusCode
MM7DeliverRes mm7DeliverRes = new MM7DeliverRes();
mm7DeliverRes.setServiceCode("服务代码"); //设置ServiceCode，可选
mm7DeliverRes.setStatusCode(MMConstants.RequestStatus.SUCCESS) ;/*设置请求完成状
态，必备，以便表明SP已经接收到传送消息。一般设1000。*/
mm7DeliverRes.setStatusText("所用状态文本说明"); /*设置所用状态的文本说明，
应限定请求状态，可选*/
//返回给MM7 API，以便API将MM7DeliverRes返回给MMSC。
return(MM7VASPRes)mm7DeliverRes;
}
}
