快速开发SMS应用的程序接口

来源:岁月联盟 编辑:zhu 时间:2004-10-11
随着手机和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



见代码中的例子。