Android调用Web服务
现在大部分应用程序都把业务逻辑处理,数据调用等功能封装成了服务的形式,应用程序只需要调用这些web服务就好了,在这里就不赘述web服务的优点了。本文总结如何在android中调用Web服务,通过传递基类型和复杂类型对比调用.NET平台发布的WCF服务和WebService服务之间的区别。
0写在前面
以前都是在.NET平台上conding,使用.NET平台发布服务,然后再在.NET的客户端进行调用,非常的方便,最简单的方式就是添加web服务引用,通过添加web服务引用实现像本地调用那样调用web服务,当然我们也可以采用http-post、http-get和基于soap协议的方式去调用服务。
最近在弄andriod的程序,需要调用web服务器上的数据,服务采用C#写的,并部署在iis服务器上。我们可以像.NET那样调用服务那,利用andriod库自带的HttpPost和HttpGet类来调用Web服务。但是wcf服务发布的一些没有添加WebGet或者WebInvoke特性的服务,都只提供基于Soap协议的服务调用方式。虽然soap协议也是基于Http协议,也可以使用HttpPost类来进行调用,但拼凑soap结构体是比较麻烦,好在Ksoap2包提供了调用web服务的方法,而且还比较好的兼容了.NET平台发布的服务。因此本文总结在Andriod中如何使用Ksoap2来调用.NET平台的服务,通过传递基类型和复杂类型对比调用.NET服务发布的WCF服务和WebService服务之间的区别。本文的末尾提供Ksoap2包的下载。
1WCF服务
我们在服务中提供两个方法,一个计算整数加法,另一个接受People对象并且返回People信息(string)。
1.1People的数据契约
[DataContract]
publicclassPeople
{
[DataMember]
publicintAge;
[DataMember]
publicstringName;
}
2.2WCF服务契约
[ServiceContract(Name="JuameService",Namespace="http://www.juame.edu")]
publicinterfaceITest
{
[OperationContract]
intAdd(intop1,intop2);
[OperationContract]
stringPostPeopleInfo(Peoplepeople);
}
上面的服务契约设置了Namespace特性,该特性重要。在后面的wb服务调用中需要用到。
2.3WCF服务实现
publicclassTestService:ITest
{
publicintAdd(intop1,intop2)
{
returnop1+op2;
}
publicstringPostPeopleInfo(Peoplepeople)
{
return"姓名:"+people.Name+"/"+"年龄"+people.Age;
}
}
我们需要把服务部署到IIS中去,因此需要添加一个svc文件,把服务实现的代码写在svc文件中,发布后,服务调用的地址就是svc文件的地址。
2.4服务配置
binding="basicHttpBinding"
contract="Juame.Service.ITest">
主要是配置好Service节点和serviceBehaviors就行,服务采用BasicHttpBinding类型。在这里多提一点。BasicHttpBinding是针对于SoapWebService协议,而webHttpBinding支持webservice协议,因此在wcf服务上加上WebGet或WebInvoke特性的必须要使用webHttpBinding类型。
在iis中发布web服务非常简单和部署asp.net网站一样,服务发布成功之后,能访问到svc的地址。
我们提供的服务,一个是传递基类型(string,int,float等),另外一个是传递对象(复杂类型)。
2Android调用WCF服务
2.1android布局
界面布局非常简单,两个Button,一个TextView,按钮分别用来调用两个服务,而TextView用来显示服务调用的结果。
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
tools:context="com.example.soapprousage.MainActivity">
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="基类型调用"/>
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="对象调用"/>
android:layout_width="match_parent"
android:layout_height="match_parent"
android:textAlignment="viewStart"/>"
2.2利用Ksoap2调用wcf服务
首先把下载下来的Jar格式的Ksoap包复制到libs(自己创建)文件夹下。
声明服务调用需要的地址和方法
privateStringnameSpace="http://www.juame.edu";//和wcf服务契约特性的Namespace是一样的
privateStringurl="http://172.21.212.54:8888/TestService.svc";//svc服务地址
privateStringsoapAction="http://www.juame.edu/JuameService/Add";//操作地址
privateStringmethodName="Add";//方法名称
上面声明的服务地址、命名空间、操作地址和方法名称都可以从服务的wsdl文档中查看,
下面利用ksoap2对服务进行调用的代码如下。
protectedSoapObjectgetSoapResult(intop1,intop2){
SoapObjectoutObject=newSoapObject(nameSpace,methodName);
//添加输出参数
outObject.addProperty("op1",op1);
outObject.addProperty("op2",op2);
SoapSerializationEnvelopeserializationEnvelope=newSoapSerializationEnvelope(SoapEnvelope.VER11);//设置soap版本
serializationEnvelope.bodyOut=outObject;
serializationEnvelope.dotNet=true;//调用.NET的服务
HttpTransportSEtransportSE=newHttpTransportSE(url);
transportSE.debug=true;//采用调试
try{
transportSE.call(soapAction,serializationEnvelope);//调用服务
SoapObjectresult=(SoapObject)serializationEnvelope.bodyIn;//获取调用结果
Log.v("happy1","服务调用成功");
//把结果封送到消息中去,让ui线程显示
Bundlebundle=newBundle();
bundle.putString("result",result.getProperty(0).toString());//获取结果中的值
Messagemessage=newMessage();
message.setData(bundle);
message.what=12;
hander.sendMessage(message);
returnresult;
}catch(IOExceptionex){
Log.v("sad","IO异常");
ex.printStackTrace();
}catch(XmlPullParserExceptionex){
Log.v("sad","xml解析异常");
ex.printStackTrace();
}catch(Exceptionex){
Log.v("sad","服务调用异常异常");
}
returnnull;
}
按钮事件代码,采用多线程。在android3.0后,有关网络资源的调用代码都不能直接在主UI线程中调用,否则会出现android.os.NetworkOnMainThreadException异常。关于android中的多线程机制有时间再进行总结。
//绑定按钮事件
btnJlx.setOnClickListener(newOnClickListener(){
@Override
publicvoidonClick(Viewarg0){
//TODOAuto-generatedmethodstub
Threadthread=newThread(getSoapRequest);
thread.start();
}
});
//线程
RunnablegetSoapRequest=newRunnable(){
@Override
publicvoidrun(){
//TODOAuto-generatedmethodstub
getSoapResult(10,20);
}
};
//消息处理
Handlerhander=newHandler(){
@Override
publicvoidhandleMessage(Messagemsg){
if(msg.what=12){
lblResult.append(msg.getData().getString("result")+"\r\n");
}
}
};
到目前为止,我们已经调用了wcf服务第一个服务,就说明传递基类型是没有问题。但是很遗憾的是,对于传递复杂类型和数组集合参数进行调用,在服务那边总是提示无法对传递进来的数据进行反序列化的错误(希望高手指点)。还好我们可以把所以的服务类型都转为json数据,通过json数据进行传递调用,就可以解决复杂类型传递的问题。
对于有强迫症的我来说,不甘心,因为在网上看了许多的教程,利用Ksoap2是可以直接传递复杂类型的来调用.NET平台的服务的。不过网上大部分教程调用的都是传统的webservice服务(asmx文件),于是我就在wcf服务项目中新建一个传统的asmx文件,提供的服务与wcf服务一样的。结果发现,果然能够利用ksoap2传递一个复杂类型来调用服务。下一节总结利用ksoap2传递复杂对象来调用传统的webservice服务。
3传统的WebService服务
为了和wcf服务进行对比,webservice提供的服务和wcf一致,代码如下:
[WebService(Namespace="http://tempuri.org/")]
[WebServiceBinding(ConformsTo=WsiProfiles.BasicProfile1_1)]
[System.ComponentModel.ToolboxItem(false)]
//若要允许使用ASP.NETAJAX从脚本中调用此Web服务,请取消注释以下行。
//[System.Web.Script.Services.ScriptService]
publicclassWebService:System.Web.Services.WebService
{
[WebMethod]
publicintAdd(intop1,intop2)
{
returnop1+op2;
}
[WebMethod]
publicstringPostPeopleInfo(Peoplepeople)
{
return"姓名:"+people.Name+"/"+"年龄:"+people.Age;
}
}
其中WebService特性中的Namespace属性和wcf的Namespace的作用一样的。
同样的也在iis中进行发布。发布成功之后,能够访问到asmx文件。
4Android调用WebService服务
不管是调用WCF的服务还是WebService的服务,传递基类型去调用,代码都是一样的,且能够正确的调用。下面利用复杂的People类型来调用WebService的服务。
我们需要传递复杂类型,首先我们要在android中建立一个复杂类型,并且复杂类型包含字段名称和个数一定要与服务上的复杂类型保持一致,对于服务的复杂类型具有哪些字段,我们可以通过查看服务调用的示例得知。如下图所示。
根据上面复杂类型的字段说明,我们在android中建立复杂类型(类型名可以随意),包含两个字段且字段名称必须是Age和Name,数据类型也要一致,上面的这个people代表该复杂类型形参名为people(服务调用的时候必须要保持一样)。需要注意的是,这个复杂类型必须要继承KvmSerializable,这样ksoap2进行服务调用的时候,能够把people对象序列化为服务端能够接受的格式。代码如下:
publicclassPeopleimplementsKvmSerializable{
publicintAge;
publicStringName;
@Override
publicObjectgetProperty(intarg0){
switch(arg0){
case0:
returnAge;
case1:
returnName;
default:
returnnull;
}
}
@Override
publicintgetPropertyCount(){
return2;
}
@Override
publicvoidgetPropertyInfo(intarg0,Hashtablearg1,PropertyInfoarg2){
switch(arg0){
case0:{
arg2.type=PropertyInfo.INTEGER_CLASS;
arg2.name="Age";
break;
}
case1:{
arg2.type=PropertyInfo.STRING_CLASS;
arg2.name="Name";
break;
}
}
}
@Override
publicvoidsetProperty(intarg0,Objectarg1){
switch(arg0){
case0:{
Age=Integer.parseInt(arg1.toString());
break;
}
case1:{
Name=arg1.toString();
break;
}
}
}
}
下面是传递复杂对象调用web服务,其中服务地址、操作地址、方法名以及命名空间和前面一样,只需要在服务说明wsdl文档中找operationname节点和operationsoapAction节点的值即可,其他地方也类似,只是在封装soapobject的时候有一些区别,代码如下:
//地址声明
privateStringnameSpace="http://tempuri.org/";
privateStringurl="http://172.21.212.54:8888/WebService.asmx";
privateStringsoapAction="http://tempuri.org/PostPeopleInfo";
privateStringmethodwww.tt951.comName="PostPeopleInfo";
//服务调用
protectedSoapObjectgetSoapResult(){
SoapObjectoutObject=newSoapObject(nameSpace,methodName);
Peoplepeople=newPeople();
//设置字段值
people.setProperty(0,23);
people.setProperty(1,"Juame");
//设置SoapObject对象
outObject.addProperty("people",people);
//也可以这样设置SoapObject
/PropertyInfopeoInfo=newPropertyInfo();
peoInfo.setName("people");
peoInfo.setValue(people);
peoInfo.setType(People.class);
outObject.addProperty(peoInfo);/
SoapSerializationEnvelopeserializationEnvelope=newSoapSerializationEnvelope(
SoapEnvelope.VER11);//设置soap版本
//这一步添加映射非常关键
//第一个参数为命名空间,第二参数为服务器中复杂类型的名称,第三参数是安卓的复杂类型
serializationEnvelope.addMapping(nameSpace,"People",People.class);
serializationEnvelope.bodyOut=outObject;
serializationEnvelope.dotNet=true;//调用.NET的服务
HttpTransportSEtransportSE=newHttpTransportSE(url);
Transwww.baiyuewang.netportSE.debug=true;//采用调试
try{
transportSE.call(soapAction,serializationEnvelope);//调用服务
Log.v("happy1","服务调用成功");
SoapObjectresult=(SoapObject)serializationEnvelope.bodyIn;
//把结果封送到消息中去,让ui线程显示
Bundlebundle=newBundle();
bundle.putString("result",result.getProperty(0).toString());
Messagemessage=newMessage();
message.setData(bundle);
message.what=11;
hander.sendMessage(message);
returnresult;
}catch(IOExceptionex){
Log.v("sad","IO异常");
ex.printStackTrace();
}catch(XmlPullParserExceptionex){
Log.v("sad","xml解析异常");
ex.printStackTrace();
}catch(Exceptionex){
Log.v("sad","服务调用异常异常");
}
returnnull;
}
//按钮事件
btnObj.setOnClickListener(newOnClickListener(){
@Override
publicvoidonClick(Viewarg0){
//TODOAuto-generatedmethodstub
Threadthread=newThread(getSoapRequest);
thread.start();
}
});
//线程
RunnablegetSoapRequest=newRunnable(){
@Override
publicvoidrun(){
//TODOAuto-generatedmethodstub
getSoapResult();
}
};
//消息处理
Handlerhander=newHandler(){
@Override
publicvoidhandleMessage(Messagemsg){
if(msg.what=11){
lblResult.append(msg.getData().getString("result")+"\r\n");
}
}
};
上面的代码就能够传递复杂类型去调用WebService的服务,返回结果如下:
姓名:Juame/年龄:23
5简述Wcf与WebServic的区别
WebService是一个行业标准,也是WebService的规范,既不是框架,也不是技术,它使用xml扩展标记语言来表示数据,这正是WebService能够跨语言和平台的关键,而微软的Web服务实现称为ASP.NETWebService.它使用Soap简单对象访问协议来实现分布式环境里应用程序之间的数据交互。
WCF是一个分布式应用的开发框架,属于特定的技术,或者平台。既不是标准也不是规范。在一定程度上就是WebService,不得不说WCF确实非常方便,提供非常多且好用的特性,可以用来创建各种服务,而且自定义性也高,以后项目的服务搭建都会基于WCF来实现。
6小结
本文总结了如何使用android调用web服务。在传递复杂类型调用服务的时候纠结的了半天,最后实现了传递复杂类型调用WebService服务,但没有实现对WCF服务的调用,而传递基类型调用服务,两者都可以。在第5小节中还简述了wcf和webservice之间的区别,其实在项目大都是采用wcf框架来发布自己的服务。下面会继续总结如何用javascript来调用wcf发布的服务。
|
|