SP短信及ISAG的五个接口.docVIP

SP 短信和订购关系同步程序实例说明 一 概述 程序用JAVA语言开发，JDK版本为JDK1.5，WEB服务器为TOMCAT，TOMCAT版本为Tomcat5.5。主要完成功能为下发短信，接收回执状态报告，接收短信上行信息， 接收订购/使用通知消息。源代码为WEB程序，需要发布到WEB服务器（TOMCAT）中才能完成功能和发布webservice服务。启动TOMCAT，在IE地址栏输入“http://IP地址:端口号/SendSMSTest/services”可以看见发布服务的名字和里面的方法。程序定时查询sendSms表中信息进行下发，SP直接在sendSms表中添加记录，程序可以自动完成下发。当服务发布成功后，SmsNotification服务会接收短信上行消息和回执状态报告， 接收到的短信上行消息保存在notifMessage表中，回执状态报告信息保存到deliveryStatus表中。IsmpSpEngine服务会接收订购关系更新消息，业务执行通知消息， 管理信息通知消息。订购关系更新消息保存在orderUpdateNotify表中，业务执行通知消息保存到serviceConsume表中，管理信息通知消息保存在notifyManagementInfo表中。 二 API使用 1 短信下行（发送短信WebSerice客户端） 在源代码test.sms 包中SMSSendSmsStub.java 类是发送短信类 类名：SMSSendSmsStub 方法名：sendSms（发送短信） 输入 参数名 参数类型 描述 addresses org.apache.axis.types.URI[] 短消息要被发送到的地址 senderName String 指示短消息发送者信息 charging ChargingInformation 应用与本消息的计费 message String 短消息内容 receiptRequest SimpleReference 是否状态报告soapHeader RequestSOAPHeader 消息头对象 输出 参数名 参数类型 描述 _resp String 返回码sendSms 方法发送短信要先设置好输入参数，具体内容参考SMSTest.java 中 main方法调用中对输入参数的配置。 2 短信上行（接收短信WebSerice服务端，服务地址） 在源代码test.sms 包中NotifySMS.java 类是接收短信类 类名：NotifySMS 方法名：notifySmsReception （接收短信类） 输入 参数名 参数类型 描述 registrationIdentifier String 标识预先约定的准则，根据该准则，应用可收到短消息通知 message SmsMessage 接收到的短信 Header NotifySOAPHeader 接收到的消息头对象 输出 无 NotifySMS方法是WebSerice服务端方法，服务成功发布后，方法会接收到上行短信。 Message对象包含接收到短信的主题 Header对象包含接收到短信的消息头信息，比如 （header.getLinkId();header.getProductId();header.getSAN();header.getSpId();）等信息。 方法名：notifySmsDeliveryReceipt（接收状态报告） 输入 参数名 参数类型 描述 correlator String 标识一个特定的短消息状态报告，最大长度50 deliveryStatus DeliveryInformation 接收到的短信 Header NotifySOAPHeader 接收到的消息头对象 输出 无 notifySmsDeliveryReceipt方法是WebSerice服务端方法，服务成功发布后，方法会接收到下行短信是返回的状态报告。 3 订购/使用通知接口 在源代码test.ismp包中IsmpSpEngineSoapBindingImpl.java 类是接收订购/使用通知消息 方法名：orderRelationUpdateNotify （订购关系更新消息） 输入 参数名 参数类型 描述 StreamingNo String 流水号，可用于调用/提供双方比较接口调用情况，60位，从0开始，用满归零 ProductID String 产品标识 PackageID String 套餐标识 UserID String 用户号码 UserIDType Integer 0：MSISDN 1：PHS 2：PSTN OPTy