webService网络服务调用总结

网络服务调用总结

jacking

2013年10月29日

目录

快递通网络服务调用总结 ............................................................................................................... 1 WebServices简介 ............................................................................................................................. 2 Webservices调用需要注意的问题(附案例) ................................................................................... 2

准备工作 ................................................................................................................................... 2

相关jar包导入 ................................................................................................................ 2 相关权限添加 ................................................................................................................... 3 调用webService服务步骤 ...................................................................................................... 3

对调用过程的分析 ........................................................................................................... 3 自定义数据类型参数问题 ............................................................................................... 5 带有自定义类型属性的自定义类型参数 ....................................................................... 6 自定义类型参数集合 ....................................................................................................... 6

由于项目涉及到网络通信(客户端与服务器端的数据交互)，故此将之前学习到的关于网络通信的知识总结并分享给大家，如对文档中某些内容有异议，请及时沟通讨论。

通过学习了解到android的网络通信方式有含很多种，例如：基于TCP协议的网络通信、使用URL访问网络资源、使用HTTP访问网络、使用WebServices进行网络编程等等。本文档主要针对使用WebServices进行网络编程方式给以详细说明。

WebServices简介

Web services是一种部署在Web上的对象或者组件，能够通过Internet进行调用的应用程序。Web services 建立在以XML为主的开放的web规范技术基础上，其业务逻辑对调用者来说是透明的。

Webservices调用需要注意的问题(附案例)

接下来我们结合一个案例来理解整个调用过程，针对当时开发时遇到的问题，进行详细说明。 附：表达能力有限，有很多东西讲的不是很清楚，请结合附带案例看此文档，希望能帮到你

准备工作 相关jar包导入

新建android项目，将ksoap2-android-assembly-3.0.0-jar-with-dependencies.jar放在android项目的lib目录下，检查jar包是否如下图所示：

如果不同，选中jar包右键->build path->add to build path即可。

相关权限添加

既然是访问网络操作，就需要添加访问网络的权限： 对AndroidManifest.xml文件进行修改，添加网络权限

否则Log日志会打印缺少权限，如图：

注意：这里只添加了网络权限，如果你的项目中还涉及到其他权限，请添加相应权限

调用webService服务步骤

第一步，指定WebServices的命名空间和调用的方法名 SoapObjectrpc = new SoapObject(NameSpace,methodName); 第二步，设置需要调用的webServices接口需要传入的参数 rpc.addProperty(proPertyName,proPertyValue);

第三步，生成调用WebServices方法的SOAP请求信息，并制定SOAP的版本

SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER10); envelope.bodyOUt = rpc;

第四步，生成调用WebServices方法的HttpTransportSE实体对象 HttpTransportSE transport = new HttpTransportSE(ServiceURL); 第五步，调用call方法请求服务 Transport.call(soapAction,envelope); 第六步，获取服务端返回的数据

SoapObject object = (SoapObject)envelope.bodyIn; 第七步，解析返回的soapObject并获取需要的数据结果 String result = object.getProPerty(0).toString();

对调用过程的分析

注意1：第一步、第四步、第五步中，涉及到调用WebServices之前需要弄清楚”NameSpace”、”methodName”、”serviceURL”、”soapAction”。这些值需要从wsdl文档中寻找，如果想对wsdl文档深入学习，请参考wsdl学习文档，本文档只说明如何从wsdl文档中找到相应的值。

将服务端提供的url地址浏览器地址栏可以看到如下界面:

通过链接访问wsdl文档，可以看到当前wsdl文档应用的所得有命名空间，内容界面如下：

在此文档中，我们也可以找到我们需要的四个重要的属性值：

命名空间：找到wsdl:definitions节点，即wsdl的根节点，找到属性targetNamespace的值，即为我们所需的命名空间nameSpace的值，如图：

服务地址：找到wsdl:service节点，找到其子节点soap:address的属性location的值，即为我们所需的服务地址serviceURL的值，如图：

方法名和SoapAction：找到wsdl:operation节点，其属性name的值即为我们所需的方法名methodName的值，其子节点soap:operation的属性SoapAction的值即为当前我们所需方法所对应的soapAction的值，如图：

至此，调用webService服务所需的最基本的四个属性值获取完成。但调用的过程中一定要保证methodName与soapAction的一一对应关系。

注意2：第二步中，涉及到设置参数。通过wsdl文件中wsdl:types节点的子节点xsd:import 通过第一个URL获取到当前服务的所有方法、每个方法的所有参数及参数类型

通过第二个URL获取到当前服务所有能直接传递的数据类型，即基本数据类型

通过第三个URL获取到当前服务所有自定义类型的参数、参数的所有属性及属性类型

通过第一个URL访问到如下界面：

针对参数类型，如何判断参数是不是自定义参数类型呢？可以通过第二个URL跳转查看服务描述的所有基本数据类型，如下图：

若没有，通过第三个URL跳转查看服务描述的所有自定义类型，一一对应的关系，如果没有在当前链接里找到你所要了解的数据类型，那么这种数据类型即为复杂类型，或称自定义类型。需要对自定义类型的属性加以进一步了解，如下图：

若没有，可以询问服务端负责人员

自定义数据类型参数问题

针对这种自定义类型的参数，通过第二步中设置参数是达不到我们想要的效果的，服务端返回的信息为”服务器内部错误”等。那么这种情况我们该怎么解决呢？ 下面拿上述TransferParams讲解一下：

第一步、在本地新建TransferParams.java文件，实现KvmSerializable序列化接口。

第二步、将上图中TransferParams参数包含的所有属性按顺序声明，注意：一定要按顺序 第三步、实现getProperty(int arg0)、getPropertyCount()、getPropertyInfo(int arg0,Hashtable arg1,PropertyInfo arg2)、setProperty(int arg0,Object arg1)方法。

getProperty(int arg0) 通过索引获取指定属性 getPropertyCount() 获取属性集合的大小

getPropertyInfo(int arg0,Hashtable arg1,PropertyInfo arg2)

获取指定索引的属性的名称和类型，注意：方法中第一件事是为参数设置命名空间 setProperty(int arg0,Object arg1) 为指定的属性赋值