MAS20JAVAAPI接口插件开发手册

1、中国移动代理服务器MASV2.0JAVAAPI接口插件开发手册Bs嘉讯软件Jasnsonsoft深圳市嘉讯软件有限公司2008年9月目录1. 引言41.1. 编写目的41.2. 背景说明42. 相关术语与缩略语解释4API结构说明4运行环境5开发步骤52.1. 在Mas服务器新建一个企业应用52.2. 启动企业应用62.3. 开发时需要引入的包.1. 接口开发及使用举例6APIClient工厂类-ApiClientFactory类7创建短信API客户端-createSmsApiClient方法7短信接口7短信API客户端主要操作类-SmsApiClient类7设置自动重连服务器

2、-setTimingConnect方法7设置自动重连服务器相隔时间-setConnectTime方法7设置与服务连接超时时长-setConnectTimeout方法8设置发送超时时长-setSendTimeout方法8启动API-start方法8获得网关连接状态-getConnStatusIAGW方法8取消短信发送-canelSms方法8获得短信队列中未发送的条数-getStat方法8获得扩展服务代码长度-getXCodeLength方法8计算短信条数和字数-getSmsCount方法8获得预览的短信内容-getSmsContentPreview方法错误！未定义书签。.2. 短信

3、API退出-loginOut方法8获得MAS短信提交的限制数量-getDestAddrsLimit方法.9发送短信-sendSms方法9短信回调对象处理类-SmsApiClientHandler类10发送响应通知-notifySmsSendResponse方法错误！未定义书签。状态报告通知-notifySmsDeliveryStatus方法10MO短信通知-notifySmsReception方法10通知取消成功的手机号码-notifyCanelSmsList方法11短信开发客户端代码举例11彩信接口14彩信API客户端主要操作类-MmsApiClient类14设置是否自动重连到服务器-set

4、TimingConnect方法14设置自动重连服务器相隔时间-setConnectTime方法14嘉讯软件2设置与服务连接超时时长-setConnectTimeout方法4设置发送超时时长-setSendTimeout方法14启动API-start方法14彩信API退出-loginOut方法14获得网关连接状态-getConnStatusIAGW方法14获得MAS彩信提交的限制数量-getDestAddrsLimit方法.15发送彩信-sendMms方法15获取该次发送还未提交到彩信网关的数量-getStat方法.15取消彩信发送-canelMms方法16彩信服务回调对象进行

5、处理类-MmsApiClientHandler类16发送响应通知-notifyMmsSendResponse方法16状态报告通知-notifyMmsDeliveryStatus方法16MO彩信通知-notifyMmsReception方法17通知取消成功的手机号码-notifyCanelMmsMobile方法错误！未定义书签。3. 彩信多媒体消息内容格式定义说明17彩信多媒体内容类型17彩信多媒体内容加密17彩信多媒体内容编码17彩信多媒体内容支持附件的类型18彩信多媒体消息内容示例18彩信多媒体消息具体加密前后内容示例18彩信开发客户端代码举例20API异常错误对应常量22接口描述233.1

6、.1. 短信接口描述23接口说明23流程说明23主要类说明244. 彩信接口描述24接口说明24流程说明24主要类说明25API短信DEMO使用说明25使用说明25主要命令说明25注意事项275. 参考文档27嘉讯软件31. 引言1.1. 编写目的本手册详细描述了中国移动代理服务器（MAS）短信、彩信API的开发步骤以及注意事项。其阅读对象为需要MAS开发、工程支持人员、集成开发人员、SI厂商开发人员、企业客户IT开发人员。1.2. 背景说明近年来移动业务高速发展，MAS业务也开展的如火如荼，但同时许多集团客户有许多自己的IT系统，他们如何把自己的IT系统也“移动”化起来呢？MAS做为移动代理

7、服务器，提供了许多手段来供企业IT系统接入（如WS接口、DB接口、WAP适配），但此次API又为这许多手段之外再增加了一种方式，并且这种方式更为高效、更稳定、扩展性更强。本手册适用于产品“中国移动代理服务器MAS”V2.0版本。只描述了以JAVA语言客户端来接入MAS的内容，其它语言开发客户端可以参考本手册。1.3. 相关术语与缩略语解释缩写词英文解析中文解析MASMobileAgentServer移动代理服务器HTTPHypertextTransferProtocol超文本传输协议HTTPSSecureHTTP加密的HTTP协议SOAPSimpleObjectAccessProtocol简单

8、对象访问协议UCAUnifiedCommunicationAgent统一通信代理API结构说明企业侧企业应用ApiClienlSocketMAS2.0ApiAdapterServer企业应用通过APIClient来与MAS通信，底层采用Socket，这样可以保证高性能与稳定性。API方式通信适配插件接口封装了以下移动通信能力：短信彩信此外，还提供基座与企业应用之间的插件管理功能接口。MAS服务器应提供配置工具，指定对于某个集团客户应用系统或应用插件，通过API方式通信适配插件或数据库方式通信适配插件接入MAS服务器。这是当应用作为插件的身份来接入MAS时才考滤的开发环境。当应用不作为插件而做为

9、集团客户应用的身份来接入时不需关注，只需通过标准的API接口即可。运行环境MAS2.0基座运行环境MAS服务平台环境JDK1.5及以上开发步骤在Mas服务器新建一个企业应用运行MAS2服务器，登录到系统管理-“插件管理”中新建一个企业应用在开发完成后准备调试前，先运行MAS2.0服务器，然后在插件管理里新建一个应用或插件。嘉讯软件5注意：新建时通信接口方式”选择API42启动企业应用厂SSIis-iiso轨阿亘用怅EJflrmatiFlHilr号：123爭乎:BZ3毎債子号：無舌舌rAFTMEUSCnXSKEmAfl血診丰：K】L53】就定n孑号:m否正1fig否rWUSTRTQ片脅乎iDIF

10、A1UW拥I子号：11正韋图4-2插件管理页面要新建的插件API接口可用，需要点击“开关”列的运行按钮。否则在使用API接口通信时可能会报POL0906错误。当然要确保API接口能正常使用，还需要管理平台相应的业务能力。43开发时需要引入的包客户端开发时，要引入mas-api.3.x.jar包。接口开发及使用举例441.APIClient工厂类-ApiClientFactory类描述：APIClient工厂类，用来创建短信APIClient与彩信APIClient。.创建短信API客户端-createSmsApiClient方法功能：创建短信API客户端，一个SmsApiClie

11、nt绑定了一个Socket连接。参数描述备注smsHandler短信服务回调接口，如状态报告通知、M0短信接收、发送响应等masIPMAS服务器IP地址masApiPortMAS服务器API适配监听端口MAS默认一般是61616，具体可在MAS上修改apiIDAPI的标识，新建API时指定的见图4-1passwordAPI登录的密码，新建API时指定见图4-.创建彩信API客户端-createMmsApiClient方法功能：创建彩信API客户端，一个MmsApiClient绑定了一个Socket连接。参数类型描述备注mmsHandlerMmsApiClientHandler彩

12、信服务回调接口，如状态报告通知、M0彩信接收等masIPStringEMA服务器IP地址masApiPortintEMA服务器彩信API适配监听端口EMA默认一般是61617，具体可在EMA上修改apiIDStringAPI的标识，新建API时指定的见图4-1passwordStringAPI登录的密码，新建API时指定见图4-1短信接口.短信API客户端主要操作类-SmsApiClient类短信API客户端主要操作接口，通过ApiClientFactory类来创建期实例，一个SmsApiClient对象代表了与服务器连接，在正常与服务器通信时需要先调其start方法来初始化。设

13、置自动重连服务器-setAutoConnect方法功能：设置是否自动重连到服务器。设置自动重连服务器相隔时间-setReConnectInterval方法功能：设置自动重连服务器相隔时间（单位：秒），默认为30秒442.13设置与服务连接超时时长-setConnectTimeout方法功能：设置与服务连接超时时长，单位：millisecond，需要在调用start方法前设置方可生效。设置发送超时时长-setSendTimeout方法功能：设置发送超时时长，单位：millisecond，需要在调用start方法前设置方可生效。启动API-start方法功能：启动API，该方法会自动连接到MAS服

14、务器并进行登录。所有的发送、接收等操作都需要在start成功后方可使用。获得网关连接状态-getConnStatusIAGW方法功能：获得网关连接状态。取消短信发送-canelSms方法功能：取消短信发送。获得短信队列中未发送的条数-getStat方法功能：获得短信队列中未发送的条数。获得扩展服务代码长度-getXCodeLength方法功能：获得扩展服务代码（插件短信扩展号码+流水号）长度。计算短信条数和字数-getSmsCount方法功能：计算短信条数和字数。短信API退出-loginOut方法功能：短信API退出。嘉讯软件442.1.12.获得MAS信提交的限制数量-getDestAdd

15、rsLimit方法功能：获得mas当前短信提交的限制数量。442.1.13.发送短信-sendSms方法功能：发送短信。SmsSendRequest对象参数说明如下:字段类型描述备注appIDString插件IDAPI插件标识IDdestAddrsList目的地址，即手机号码集合一次发送的最大长度，具体可通过getDestAddrsLimit方法获得xCodeString短信子码+流水号messageString短信内容msgFormatMsgFmt短信内容编码格式ASCII:ASCII字符。UCS2G:USC2格式的UniCode字符。B18030:GB18030格式的中文字符。GB2312

16、:GB2312格式的中文字符。Binary:二进制短信，用十六进制字符串。typeSmsType短信类型Normal:普通短信Instant:免提短信Long：长短信Structured:二进制短信WapPush：WapPush短信priorityint短信优先级。大于0的正整数，数字越小优先级越高。targetURLString推送URL发送Wappush短信时有效，其它类型短信时忽略isNeedReportboolean是否需要状态报告validTimeint短信存活期，单位秒开始时间以MAS收到API提交时间为准，validTime默认为0时，存活期为24小时。linkedIDStrin

17、g保留字段返回值SmsSendResponse本次发送响应其SmsSendResponse参数说明如下字段|类型描述备注嘉讯软件JAsvonaortrequestIDString提交到MAS服务平台标识对应submitIDcodeString错误编码descString错误描述4422短信回调对象处理类-SmsApiClientHandler类描述：由企业应用来实现，该接口类主要是对短信服务的一些回调对象进行处理，如接收状态报告、mo短信等。44221.状态报告通知-notifySmsDeliveryStatus方法功能：状态报告通知。如果在发送时指定不要状态报告将不会调用到此方法字段类型描述

18、备注submitIDString提交到MAS服务平台标识sendSms方法返回的值deliveryInfoReport状态报告对象其Report参数说明如下:字段类型描述备注addressString提交的手机号码sendTimelong提交到网关的时间detailResultString规范状态报告描述可以忽略此项timelong状态报告收到时间sendResultint提交到网关的返回响应的结果此值为0,表示正确提交到网关smsTypeint短信类型statString提交网关成功后，网关返回的状态报告的状态码sendResult为0时此值有效，stat为“DELIVRD”，表示手机正确收

19、到短信，其它表示发送失败，具体描述看errDescmsgIDString短消息ID可不用关心errDescString错误描述1. 注：一条状态报告成功与否有以下几种情况sendResult如果为0，则看stat,stat为“DELIVRD”则表示发送成功，stat为其它则表示发送失败，errDesc为错误描述sendResult不为0，则表示发送失败，不用看stat,直接看errDesc错误描述44222.MO信通知-notifySmsReception方法功能：MO短信通知。其sms参数说明如下字段类型描述备注destIDStringMO流水号一般跟发送时的xCode对应mobileStr

20、ing上行的手机号码contentErrCode短信内容.:嘉讯软件msgFormatMsgFmt短信内容编码ASCII:ASCII字符。UCS2G:USC2格式的UniCode字符。B18030:GB18030格式的中文字符。GB2312:GB2312格式的中文字符。Binary:二进制短信，用十六进制字符串。msgIDString消息ID44223.通知取消成功的手机号码-notifyCanelSmsList方法功能：通知取消成功的手机号码，其参数说明如下字段类型描述备注submitIDString提交到MAS服务平台标识canelMobileListList取消成功的手机号码集合4423

21、短信开发客户端代码举例由图4-1所示，新建了API插件，API插件标识为“API插件”，API插件密码“123123”，下面代码演示API客户端发送短信及相关方法。.：嘉讯软件/设置是否自动重连到服务器(可以不需要设置)smsApiClient.setAutoConnect(true);/设置自动重连服务器相隔时间(单位：秒),默认为30秒(可以不需要设置)smsApiClient.setReConnectInterval(60);/设置与服务连接超时时长，单位：millisecond(可以不需要设置)smsApiClient.setConnectTimeout(100000);/设置发送超时

22、时长，单位：millisecond(可以不需要设置)smsApiClient.setSendTimeout(1000000);/获得短信群发提交的数量限制intret=smsApiClient.getDestAddrsLimit();/获取网关连接状态(Connect:连接正常，Disconnect:断连，NotConnect:没有连接,Other:其他)ConnectStatusconnectStatus=smsApiClient.getConnStatuslAGW();if(!ConnectStatus.Connect.equals(connectStatus)System.out.pri

23、ntln(网关未连接)；return;/计算短信条数和字数SmsCountsmsCount=smsApiClient.getSmsCount(content,MsgFmt.GB2312,SmsType.Normal);/获得扩展服务代码(插件短信扩展号码+流水号)长度intxcodeLength=smsApiClient.getXCodeLength()/发送短信/=构造发送短信对象开始，下面代码演示发送短信对象几个比较主要的属性值，其它的属性可以不设置，如果要设置可以参考sendSms方法中SmsSendRequest参数=SmsSendRequestsmsSendRequest=newSm

24、sSendRequest();Listlist=newArrayList();/每次群发数量不能超过最大限制数for(inti=0;iret;i+)longaddress=mobile+i;list.add(String.valueOf(address);嘉讯软件12smsSendRequest.destAddrs=list;/短信存活期，单位秒/短信扩展码/短信内容smsSendRequest.validTime=10000;smsSendRequest.xCode=xCode;/短信编码类型smsSendRequest.message=content;smsSendRequest.msgF

25、ormat=MsgFmt.GB2312;smsSendRequest.isNeedReport=true;/短信是否需要状态报告smsSendRequest.priority=1;/短信网关优先级，短信优先级大于0的整数0为最高优先级,数字越大级别越低/Normal:普通短信，lnstant:免提短信，Long：长短信Structured:二进制短信，WapPush：/WapPush短信smsSendRequest.type=SmsType.Normal;smsSendRequest.appID=appID;/=构造发送短信对象结束=SmsSendResponsesmsSendResponse

26、=smsApiClient.sendSms(smsSendRequest);System.out.println(提交成功，requestID:+smsSendResponse.requestlD);catch(Exceptione)System.out.println(API短信客户端调用失败:+e.getMessage();return;如提交成功会收到requestID，如有网络连接、密码错误等问题，则会抛相应的异常，相关异常信息请参考444API异常错误对应常量。SmsApiClientHandler接口类主要是对短信服务的一些回调对象进行处理，如接收状态报告、MO短信等，下面是对该类

27、中一些回调方法的代码举例。短信服务的一些回调方法调用代码example/*接收状态报告状态报告对象*paramdeliveryInfo*/Reportreport)+:SmsReport0.sendResult);publicvoidnotifySmsDeliveryStatus(StringsubmitID，System.out.println(接收到状态报告+report.lengthsubmitID:+submitID+sendResul=+report/*接收MO短信* parammessage* return*/publicvoidnotifySmsReception(Smssms)

28、System.out.println（收到一条MO,destld:+sms.destID+；内容：+message.content+手机号码：+sms.mobile）;443. 彩信接口彩信API客户端主要操作类-MmsApiClient类彩信API客户端主要操作接口，通过ApiClientFactory类来创建期实例，一个MmsApiClient对象代表了与服务器连接，在正常与服务器通信时需要先调其start方法来初始化。.1. 设置是否自动重连到服务器-setAutoConnect方法功能：设置是否自动重连到服务器。.2. 设置自动重连服务器相隔时间-setRe

29、ConnectInterval方法功能：设置自动重连服务器相隔时间（单位：秒），默认为30秒。.3. 设置与服务连接超时时长-setConnectTimeout方法功能：设置与服务连接超时时长，单位：millisecond，需要在调用start方法前设置方可生效。.4. 设置发送超时时长-setSendTimeout方法功能：设置发送超时时长，单位：millisecond，需要在调用start方法前设置方可生效。.5. 启动彩信API-start方法功能：启动API，该方法会自动连接到MAS服务器并进行登录。所有的发送、接收等操作都需要在start成功

30、后方可使用。.6. 彩信API退出-loginOut方法功能：彩信API退出。.7. 获得网关连接状态-getConnStatusIAGW方法功能：获得网关连接状态。嘉讯软件443.18获得MAS彩信提交的限制数量-getDestAddrsLimit方法功能：获得mas当前彩信提交的限制数量。.9.发送彩信-sendMm方法功能：发送彩信。其MmsSendRequest参数说明如下字段类型描述备注appIDString插件IDAPI插件标识IDdestAddrsString目的地址，即手机号码集合,多个手机号码之间用英文“，”号隔开一次发送的最大长度，

31、具体可通过getDestAddrsLimit方法获得xCodeString彩信子码+流水号subjectString彩信主题contentString彩信内容mime文件格式，采用BASE64加密。priorityMessagePriority彩信网关发送优先级DefaultLowNormalHighlevelintMAS发送彩信优先级。大于等于0的正整数。数字越小优先级越高，0为最高优先级，依次减小。isNeedReportboolean是否需要状态报告validTimeint彩信存活期，单位秒开始时间以MAS收到API提交时间为准，validTime默认为0时，存活期为24小时。返回值Mm

32、sSendResponse本次发送响应其MmsSendResponse参数说明如下字段类型描述备注requestIDString提交到MAS服务平台标识对应submitIDcodeString错误编码descString错误描述.10.获取该次发送还未提交到彩信网关的数量-getStat方法功能：提交到MAS服务平台标识（submitID）来获取该次发送还未提交到彩信网关的数量。字段类型描述备注submitIString提交到MAS服务平台标对应MmsSendResponse中的requestIDD识返回值int获得该submitID提交到MAS的彩信，但还未提交到网关的数量大批

33、量发送时用于查看当前的进度取消彩信发送-canelMms方法功能：根据发送标识取消彩信发送，已提交到网关的不能取消。字段类型描述备注submitIDString提交到MAS服务平台标识对应MmsSendResponse中的requestID返回值List取消成功的手机号码4432彩信服务回调对象进行处理类-MmsApiClientHandler类由企业应用来实现，该接口类主要是对彩信服务的一些回调对象进行处理，如接收状态报告、mo彩信等。发送响应通知-notifyMmsSendResponse方法功能：发送响应通知。其mmsSendResponse说明如下字段类型描述备注requestIDSt

34、ring发送请求标识sendMms方法返回的值submitIDString提交到MAS服务平台标识可以对应后续收到的状态报告errCodeErrCode错误代码，为null表示发送成功嘉讯软件44322.状态报告通知-notifyMmsDeliveryStatus方法功能：状态报告通知。如果在发送时指定不要状态报告将不会调用到此方法字段类型描述备注submitIDString提交到EMA服务平台标识对应MmsSendResponse中的requestIDreportListReport状态报告对象字段类型描述备注errDescString错误描述当提交失败时，参数有效submitResulti

35、nt提交结果成功为1，失败为0delStatusDeliveryStatus发送状态DeliveredToNetwork,DeliveryUncertain,DeliveryImpossible,其Report参数说明如下:16MessageWaiting,DeliveredToTerminal,DeliveryNotificationNotSupportedaddressString消息接收地址sendTimeString提交到网关的时间recDelTimeDate收到状态报告时间44323.MO彩信通知-notifyMmsReception方法功能：M0彩信通知。字段类型描述备注messa

36、geMmsMessageReferenee彩信对象contentString消息内容其MmsMessageReferenee参数说明如下字段类型描述备注messagelDString彩信ID，如接收彩信为纯文本则此参数无效messageServiceActivationNumberString目的地址senderAddressString发送方地址subjectString彩信的标题messageString右接收彩信为纯文本，则此参数为消息体内容，当此参数存在时，messagelD参数无效。dateTimeDate消息接收时间xCodeString扩展号码mmsMessageMmsMessa

37、ge彩信附件对象4433彩信多媒体消息内容格式定义说明彩信多媒体内容类型mas提供的各种彩信发送接口，彩信内容(content)项均是字符串类型。443.32彩信多媒体内容加密彩信多媒体消内容必须经是过BASE64加密的字符串44333.彩信多媒体内容编码彩信多媒体消内容文本附件内容必须采用utf-8编码443.34彩信多媒体内容支持附件的类型text/plain,text/xml,application/smil,audio/amr,audio/midi,text/i-melody,text/e-melody,image/gif,image/jpeg,image/vnd.wap.wbm,im

38、age/png44335.彩信多媒体消息内容示例以下为加密前内容示例，通过mas发送彩信必须将此内容采用BASE64加密后发送：-SubPart_7452684322002_77645Content-Type:application/smilContent-Transfer-Encoding:8bitContent-ID:20080815103000023.smilContent-Location:20080815103000023.smilsmil附件内容”-SubPart_7452684322002_77645Content-Type:image/gifContent-Transfer-E

39、ncoding:8bitContent-ID:20080815102800026.gifContent-Location:20080815102800026.gifgif附件内容,-SubPart_7452684322002_77645Content-Type:text/plain;charset=UTF-8Content-Transfer-Encoding:8bitContent-ID:200808151030000231.txtContent-Location:200808151030000231.txt文本附件内容”-SubPart_7452684322002_77645-NextPar

40、t_0_2817_24856示例内容说明，内容中可以存在多个附件，每个附件前必须“-SubPart_7452684322002_77645”开始，最后一个附件后加-SubPart_7452684322002_77645-NextPart_0_2817_24856附件内容属性说明Content-Type附件类型Content-Transfer-Encoding附件编码位数，默认采用8位编码Content-ID附件名称Content-Location附件名称彩信多媒体消息具体加密前后内容示例加密前:.:嘉讯软件-SubPart_7452684322002_77645Content-Type:app

41、lication/smilContent-Transfer-Encoding:8bitContent-ID:20080815114700048.smilContent-Location:20080815114700048.smil-SubPart_7452684322002_77645Content-Type:text/plain;charset=UTF-8Content-Transfer-Encoding:8bitContent-ID:200808151147000481.txtContent-Location:200808151147000481.txtHELLOMMS!-SubPart_

42、7452684322002_77645-NextPart_0_2817_24856加密后：LS1TdWJQYXJ0Xzc0NTI20DQzMjlwMDJfNzc2NDUNCkNvbnRIbnQtVHIwZTphcHBsaWNhdGlvbi9zbWlsDQpDb250ZW50LVRyYW5zZmVyLUVuY29kaW5nOjhiaXQNCkNvbnRIbnQtSUQ6MjAwODA4MTUxMTQ3MDAwNDguc21pbA0KQ29udGVudC1Mb2NhdGlvbjoyMDA4MDgxNTExNDcwMDA0OC5zbWlsDQoNCjxzbWlsPjxoZWFkPjxtZXRhlG5

43、hbWU9lnRpdGxIliBjb250ZW50PSIiLz48bGF5b3V0Pjxyb290LWxheW91dCB3aWR0aD0iMTAwJSIgaGVpZ2h0PSIxMDAIIiAgLz48cmVnaW9ulGlkPSJ0eHRfdG9wliB3aWR0aD0iMTAwJSIgaGVpZ2h0PSIxNiUiIGxlZnQ9ljAilHRvcD0iMCIgZml0PSJzY3JvbGwiLz48cmVnaW9uIGIkPSJ0eHRfYnV0dG9uliB3aWR0aD0iMTAwJSIgaGVpZ2h0PSIxNiUilGxlZnQ9ljAilHRvcD0iODQIIiBmaXQ

44、9lnNjcm9sbClvPjxyZWdpb24gaWQ9lmltZ190b3AilHdpZHRoPSIxMDAIIiBoZWInaHQ9ljg0JSIgbGVmdD0iMCIgdG9wPSIwIiBmaXQ9ImZpbGwiLz48cmVnaW9uIGIkPSJpbWdfYnV0dG9uliB3aWR0aD0iMTAwJSIgaGVpZ2h0PSI4NCUilGxlZnQ9ljAilHRvcD0iMTYIIiBmaXQ9lmZpbGwiLz48cmVnaW9ulGlkPSJhbGwilHdpZHRoPSIxMDAIIiBoZWInaHQ9ljEwMCUilGxlZnQ9ljAilHRvcD0

45、iMCIgZml0PSJmaWxsliAvPjwvbGF5b3V0PjwvaGVhZD48Ym9keT48cGFylGR1cj0iMTAwMDBtcyl+PHRIeHQgc3JjPSIyMDA4MDgxNTExNDcwMDA0ODEudHh0liByZWdpb249lmFs嘉讯软件19bClgLz48L3Bhcj48L2JvZHk+PC9zbWlsPg0KDQoNCi0tU3ViUGFydF83NDUyNjg0MzlyMDAyXzc3NjQ1DQpDb250ZW50LVR5cGU6dGV4dC9wbGFpbjtjaGFyc2V0PVVURi04DQpDb250ZW50LVRyYW5zZmVyL

46、UVuY29kaW5nOjhiaXQNCkNvbnRIbnQtSUQ6MjAwODA4MTUxMTQ3MDAwNDgxLnR4dA0KQ29udGVudC1Mb2NhdGlvbjoyMDA4MDgxNTExNDcwMDA0ODEudHh0DQoNCkhFTExPIE1NUyENCg0KDQotLVN1YIBhcnRfNzQ1MjY4NDMyMjAwMI83NzY0NS0tDQotLS0tTmV4dFBhcnRfMF8y0DE3Xzl00DU2LS0NCg=4434彩信开发客户端代码举例由图4-1所示，新建了API插件，API插件标识为“API插件”,API插件密码“123123”下面代码演示A

47、PI客户端发送彩信及相关方法。彩信开发客户端相关方法调用代码exampleMmsApiClientmmsApiClient=null;StringappID=API插件;/API插件标识IDStringappPwd=123123;/API插件密码longmobile;Stringxcode=222;/彩信扩展码Stringversion=”3.0”;intmasApiPort=61617;StringmasIP=38;/MmsApiClientHandlerlmpl是自己实现的MmsApiClientHandlermmsHandler=newMm

48、sApiClientHandlerlmpl();trymmsApiClient=newMmsApiClientlmpl(apilD,appPwd,version,masIP,masApiPort,mmsHandler);/设置是否自动重连到服务器(可以不需要设置)mmsApiClient.setTimingConnect(true);/设置自动重连服务器相隔时间(单位：秒),默认为30秒(可以不需要设置)mmsApiClient.setConnectTime(60);/设置与服务连接超时时长，单位：millisecond(可以不需要设置)mmsApiClient.setConnectTimeo

49、ut(100000);/设置发送超时时长，单位：millisecond(可以不需要设置)mmsApiClient.setSendTimeout(1000000);intret=mmsApiClient.getDestAddrsLimit();/获得彩信群发提交的数量限制/获取网关连接状态(Connect:连接正常，Disconnect:断连，NotConnect:没有连嘉讯软件20接,Other:其他)ConnectStatusconnectStatus=mmsApiClient.getConnStatuslAGW();if(!ConnectStatus.Connect.equals(conn

50、ectStatus)System.out.println(网关未连接)；return;/发送彩信/=构造发送彩信对象开始，下面代码演示发送彩信对象几个比较主要的属性值，其它的属性可以不设置，如果要设置可以参考sendMms方法中MmsSendRequest参数=MmsSendRequestmmsSendRequest=newMmsSendRequest();ListvStringlist=newArrayList();StringBuilderaddressStr=newStringBuilder();/每次群发数量不能超过最大限制数(inti=0;iret;i+)forvalueOf(add

51、ress);mmsSendRequest.mmsSendRequest./“彩信内容”longaddress=mobile+i;list.add(String.destAddrs=list;appID=appID;格式请参照本手册中的彩信多媒体消息内容格式定义说明mmsSendRequest.mmsSendRequest.mmsSendRequest.mmsSendRequest.mmsSendRequest.mmsSendRequest/content=/彩信内容isNeedReport=true;/是否需要状态报告subject=彩信发送标题“；彩信主题validTime=1000000;

52、/彩信存活期，单位秒priority=MessagePriority.xCode=xcode;/彩信扩展码Default;/彩信网关发送优先级构造发送彩信对象结束=：MmsSendResponsemmsSendResponse=mmsApiClient.sendMms(mmsSendRequest);System.out.println(提交成功，requestID:+mmsSendResponse.requestID);catch(Exceptione)System.out.println(API彩信客户端调用失败:+e.getMessage();return;如提交成功会收到requestID，如有网络连接、密码错误等问题，则会抛相应的异常。相关异常信息请参考444API异常错误对应常量。.:嘉讯软件MmsApiClientHandler接口类主要是对彩信服务的一些回调对象进行处理，如接收状态报告、MO彩信等，下面是对该类中一些回调方法的代码举例。彩信服务的一些回调方法调用代码example*接收状态报告paramreport状态报告列表return*/publicvoi