为方便大家使用,我们还提供了部分常用函数供大家调用,这些函数作为接口类的基类函数在WEB-INF/lib/smsapi.jar文件下的已经写好,用以实现“短信操作”的接口组件:SMS.class (com.todaynic.client.mobile 包),这个组件由JAVA写并编译而成,操作组件除了现有的以外,其它的将会陆续发布,请留意我们的最新发布信息。 |
下面以注册短信的返回信息(XML格式)来具体说明这些函数的用法。
<?xml version="1.0" encoding="UTF-8"?>
<scp xmlns:contact="urn:todaynic.com:contact" xmlns:host="urn:todaynic.
com:host" xmlns:domain="urn:todaynic.com:domain" xmlns:registrant="urn:todaynic.com:registrant">
<response>
<result code="2000">
<msg>Command complateted successfully</msg>
</result>
<resdata>
<id>42683</id>
<prod>100</prod>
<password>111111</password>
<space>100</space>
<dtcreate>2008-1-7 15:33:11</dtcreate>
<dtexp>2008-1-7</dtexp>
</resdata>
</response>
<security>
<sltrid>1112859191704</sltrid>
</security>
</scp> |
|
一、getCode()方法 继承于 SendInfoXML |
说明: 在执行SMS的'短信操作'方法后调用该方法
如: String code = sms.getCode();
使用该方法可以得到四位数的code信息。不同的数字代表不同不同的含义,具体如下:
2000 "Command complateted successfully"
3000 "Datebase error"//数据库错误(插入\删除等)
4000 "Client error"//客户未知错误
4001 "Xml parse error"//xml错误
4002 "Authorization error"//授权错误(用户不存在、密码错误、权限不足等)
4003 "No data post to server"
4004 "Object does not exist"//函数不存在
4300 "Account error"//财务错误
4400 "Parameter error"//参数错误
5000 "Server error"
5001 "Unable connet to remote server"
5002 "Server no data return"
5003 "Server other error"
6000 "optation error"//操作错误,如不能添加、删除文件等 |
|
二、getMsg()方法 继承于 SendInfoXML |
说明:在执行SMS的'短信操作'方法后调用该方法
如: String code = sms.getMsg();
使用该方法可以得到<msg>******</msg>中*****的内容。
|
三、getRespData() 方法继承于SendInfoXML |
说明:在执行SMS的'短信操作'方法后调用该方法
如: Hashtable result = sms.getRespData();
使用该方法可以成功返回'短信操作'后返回的结果包。
|
四、getRecieveXml()和 getSendXml() 方法继承于 SendInfoXML |
说明:在执行SMS的'短信操作'方法后调用该方法
如:
<%
......
String sms.getSendXml();
String sms.getRecieveXml();
.....
%>
getSendXML()
该成员保存的是完整的发送xml信息。
getRecieveXml()
该成员保存的是完整的返回XML信息。
|
五、SMS 类的'短信操作'方法: |
构造函数public SMS(Hashtable cfg)
参数说明:
Hashtable cfg 用来传入服务器地址、服务器端口号、用户名、帐号
构造时请按如下顺序将键值对放入Hashtable中去:
键名:
VCPSERVER 服务器地址
VCPSVPORT 服务器端口号
VCPUSERID 用户帐号
VCPPASSWD 密码 |
public boolean sendSMS(String mobile, String message, String time)
功能:发送短信
参数:
String mobile 要发送的手机号码(多个手机用","分隔。一次最多99个号码)
String message -短信内容,一条短信最大长度,视所选择的通道而不同。(通道二:64个字;即时通道:50个字)
String time - 短信发送的时间(值为空或比当前时间小即是即时发送)。
String apitype (通道选择 0:默认通道; 2:通道2; 3:即时通道)
返回值:是否成功 |
public boolean infoSMSAccount()
功能:查询余额
返回值:是否成功 |
回复短信查询
public boolean readSMS()
返回XML变量:
id - 回复短信ID,大于0表示有回复短信,小于等于0表示失败
src - 回复手机
dst - 接收对象,参考值
time - 回复时间,格式如0000-00-00 00:00:00
message - 回复内容,为base64加密后的字符串,需解码
err - 错误信息,成功则为空,参考值
|
|