快速开发SMS应用的程序接口
随着手机和SMS在使用者中的日益普及,很多IT应用系统的建设者、使用者都希望能够在自己的应用系统中增加SMS的功能。为了增加SMS的功能,开发者需要获得稳定、可靠、开发简单的短消息接口。
本文主要讲述如何一步步进行开发,如何开通部分见网站的具体说明:http://www.wsms.cn/。
我们提供了两种方式的发送短消息的调用接口供调用,我们同时提供接收短消息的接口:
第一步:开通发送和接收的账户:
进入 www.wsms.cn,注册用户名/密码/手机号, 设置计费手机号码。具体的流程参见网站的说明。
第二步:利用最简单的方式:URL来收发短消息:
发送部分:
1.在程序中调用URL,并把调用参数通过URL传递给服务器即可。
如:http://www.wsms.cn/ws/sms.aspx?msg=hello&phone=1370181****&sender=sungz&password=****&tag=hello&encoding=gb2312
encoding 是编码方式 ,可以是 gb2312 / utf8 / big5 。缺省是gb2312。
可以在IE的地址栏中直接敲入该URL进行测试。
C#示例:
private void button1_Click(object sender, System.EventArgs e)
{
System.Net.WebProxy proxy = new System.Net.WebProxy("ws-isa-01:8080");
proxy.Credentials = System.Net.CredentialCache.DefaultCredentials;
System.Net.GlobalProxySelection.Select = proxy;
System.Net.HttpWebRequest wr =(HttpWebRequest)WebRequest.Create( new Uri("http://www.wsms.cn/ws/sms.aspx?msg=您好&phone=1370181****&sender=sungz&password=****&tag=hello码" ));
WebResponse ws = wr.GetResponse();
}
2、服务器如果成功处理将返回:
<?xml version="1.0" ?>
<MessageStatus status="OK" />
3、服务器如果不能成功处理将返回错误信息,例如:
<?xml version="1.0" ?>
<MessageStatus status="错误: 号码不正确 1370181" />
接收部分:
本模块采用最简单的轮询的方式。
客户端软件不断调用函数查询是否有新的SMS,返回XML数据集。同时如果填写了邮件地址,也会发邮件通知。
调用方式是:
http://www.wsms.cn/ws/getsms.aspx?sender=xxx&password=xxx&lastid=xxx&encoding=gb2312
sender=用户名
password=密码
lastid=xxx ( lastid是上次系统返回短消息的最大的id. 系统返回大于lastid的短消息的XML)
encoding 是编码方式 ,可以是 gb2312/ utf8 / big5 。 缺省是gb2312。
可以在IE的地址栏中直接敲入该URL进行测试。
Java的XML分析如例子:
package testsms;
import javax.xml.parsers.*;
import javax.xml.transform.*;
import javax.xml.transform.dom.DOMSource;
import javax.xml.transform.stream.StreamResult;
import org.w3c.dom.*;
import java.util.*;
class MySMS{
public String id,smsid,sender,carrierid,serviceid,destination,txt,tm,status;
public MySMS(){
}
}
public class MyXML {
public MyXML() {
}
public MySMS[] parseXML()
{
try {
DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
DocumentBuilder db = dbf.newDocumentBuilder();
//Document doc = db.parse("http://www.wsms.cn/ws/getsms.aspx?sender=sungz&password=***&lastid=5");
Document doc = db.parse("E:\\x.xml");
//获得Root元素
Element element = doc.getDocumentElement();
//获得Root元素的子节点列表
NodeList nodelist = element.getElementsByTagName("Table");
if(nodelist.getLength() <=0) return null;
MySMS [] sms = new MySMS[ nodelist.getLength()];
for (int i=0;i<nodelist.getLength();i++){
sms[i] = new MySMS();
Element link=(Element) nodelist.item(i);
try{
sms[i].id= link.getElementsByTagName("id").item(0).getFirstChild().getNodeValue() ;
}catch(Exception e){
e.printStackTrace();
}
try{
sms[i].smsid= link.getElementsByTagName("smsid").item(0).getFirstChild().getNodeValue() ;
}catch(Exception e){
e.printStackTrace();
}
try{
sms[i].carrierid= link.getElementsByTagName("carrierid").item(0).getFirstChild().getNodeValue() ;
}catch(Exception e){
e.printStackTrace();
}
try{
sms[i].serviceid= link.getElementsByTagName("serviceid").item(0).getFirstChild().getNodeValue() ;
}catch(Exception e){
e.printStackTrace();
}
try{
sms[i].destination= link.getElementsByTagName("destination").item(0).getFirstChild().getNodeValue() ;
}catch(Exception e){
e.printStackTrace();
}
try{
sms[i].txt= link.getElementsByTagName("txt").item(0).getFirstChild().getNodeValue() ;
}catch(Exception e){
e.printStackTrace();
}
try{
sms[i].tm= link.getElementsByTagName("tm").item(0).getFirstChild().getNodeValue() ;
}catch(Exception e){
e.printStackTrace();
}
try{
sms[i].status= link.getElementsByTagName("status").item(0).getFirstChild().getNodeValue() ;
}catch(Exception e){
e.printStackTrace();
}
}
return sms;
}
catch ( Exception r){
r.printStackTrace();
return null;
}
}
}
第二步: 使用WeService调用来收发短消息:
将介绍如何利用VisualStudio.NET和短消息接口就快速开发出一个发送SMS的Web应用程序。 下载例子代码 下载WinRar
程序设计:
第一步: 打开VS.NET,创建一个ASP.NET WebApplication : smsweb。
第二步: 在Solution Explorer的Reference上按鼠标右键,添加一个Web Reference)
第三步: 在Solution Explorer的Reference上按鼠标右键,添加一个Web Reference,地址是: http://www.wsms.cn/ws/sms.asmx 。并按“Add Reference”增加到项目中。
在VS.NET的Solution Explorer中会增加一个cn.wsms.www的Web Reference。你可以点击右键将它改名成 wsms 。
第四步: 发送编码
在一个Button的事件处理函数中增加:
private void button1_Click(object sender, System.EventArgs e)
{
wsms.sms sms = new wsms.sms();
string str = sms.SendSMS("你好","137-181XXXX","username","password","test");
if ( str =="" ) str ="成功" ;
MessageBox.Show ("发送结果:"+str);
}
SendSMS ( string msg, string phone, string sender, string password, string tag) 是系统提供的发送的函数接口。
msg :消息内容
phone: 电话号码,可以有多个号码组成,中间用半角符号; 隔开。
sender: 注册用户名
password: 密码
tag: 标签,可对发送的SMS进行分类,也可不用。
第四步: 接收编码
本模块采用最简单的轮询的方式。
客户端软件不断调用函数查询是否有新的SMS,返回XML。同时如果填写了邮件地址,也会发邮件通知。
利用接口提供的GetSMS的函数接口就能获得一个数据集DataSet ,也可以选择使用GetSMSXML获得XML数据,进行分析。
其它: 通过Proxy访问WebService
见代码中的例子。