摘要:介绍了Android 平台的架构和Web 服务, 探讨在Android 平台上的应用程序如何使用ksOAp2-android 类库访问Web 服务,最后使用一个简单的实例实现用ksoap2-android 在Android 平台上访问Web 服务。
Android 平台是Google 于2007 年11 月推出的一种智能手机平台,由操作系统、中间件、用户界面、应用软件组成,全面整合的移动"软件栈".诚然,提到Android 就不得不说开放手机联盟(Open Handset Alliance), 它是一个由33 家手机制造商、软件商和电信业组成的推广Android 的联合会。Android 是一个开放、自由的移动终端系统,Android 平台的开放性也保证了该平台不存在任何阻碍移动产业创新的专有权障碍。随着国内3G 进入正式的应用阶段, 采用Android 系统的智能手机层出不穷。另一方面,Web Services 已经逐渐成为Internet 上一个重要组件,Web Services 天生的优点使它完全适合于为无线设备提供服务。Web Services 和移动设备的结合,将会推动移动应用的发展。
为此, 本文就将讨论在Android 平台上如何访问WebServices 的相关技术实现问题。
1 Android 平台
Android 平台的架构从下到上可分为五个部分:Linux 内核、库、Android 运行时环境、应用程序框架、应用程序。
1)Linux 内核:核心服务(包括硬件驱动程序、进程和内存管理、安全、网络和电源管理)都由一个Linux 2.6 内核处理。内核还在硬件和软件栈的其他部分之间提供了一层抽象。
2)库:运行在内核之上,Android 包含了各种C/C++核心库,例如libc 和SSL,以及用来回放音频和视频媒体的媒体库;提供管理显示的外观管理器; 包含2D 和3D 的SGL 和OpenGL 的图形库;本地数据库支持的SQLite;集成了Web 浏览器和Internet 安全的SSL 和WebKit.
3)Android 运行时:Android 运行时包含了核心库和Dalvik虚拟机,因此,它是面向应用程序提供动力的引擎,它和库一起形成了应用程序框架的基础。Android 核心库提供了Java 核心库以及Android 特定库可用的大部分功能。Dalvik 是一个基于寄存器的虚拟机, 它已经被优化从而保证一个设备可用高效地同步运行多个实例。它以Linux 内核进行线程和底层内存管理。
4)应用程序框架:应用程序框架提供了用来创建Android应用程序的类。它还对硬件访问和对用户界面及应用程序资源的管理提供了一般抽象。
5)应用层:所有的应用程序,包括本地的和第三方的,都使用相同的库来构建与应用层之上。应用层运行在Android 运行时之内,并且是调用了应用程序框架中可用的类和服务。
2 在Android 平台上访问Web Services
Web Services 是一种基于SOAP 协议的以实现远程调用的分布式计算方式。利用Web Services 可以将不同操作系统平台、不同语言、不同技术开发的应用整合到一起,具有非常广阔的应用前景。但是, 在Android SDK 中并没有提供调用Web Services 的库。因此, 为了实现在Android 平台上访问Web Services 的功能需要借助第三方类库来实现。
Android 平台上常用的用来访问Web Services 的软件包是ksoap2-android.ksoap2-adroid 是一个开源项目,为Android平台提供给了一个轻量级的而且高效的SOAP 库。
利用ksoap2-android 在Android 平台上调用Web Services的步骤如下:
1) 设定Web Services 的命名空间和调用的方法名称,关键的代码如下:
SoapObject req = new SoapObject(nameSpace,methodName);其中,nameSpace 参数表示的是要调用的Web Services的命名空间的一个STring 类型变量, 该参数开源从Web Services的WSDL 文档中获得;methodName 参数表示要调用的Web Services 的方法名称的一个String 类型变量。
2)设定方法的参数值(可选的,如果调用方法无参数,就可省略):
req.addProperty("param","value");3)生成调用方法的SOAP 请求信息。该SOAP 请求信息利用SoapSerializatiONEnvelope 对象描述:
SoapSerializationEnvelope ssEvelope =new SoapSerializationEnvelope(SoapEnvelope.VER11);
ssEvelope.bodyOut = req;
SoapSerializationEnvelope 对象的创建需要通过SoapSerializationEnvelope 类的构造方法设置SOAP 协议的版本号。SOAP 协议的版本号是根据Web Servioces 的版本号决定的。另外,创建SoapSerializationEnvelope 对象时,需要设置SoapSerializationEnvelope 类的bodyOut 属性,属性值为第一步创建的SoapObject 对象。
4)创建HttpTransportSE 对象。利用HttpTransportSE 类的构造方法设置Web Services 的WSDL 的URL,代码如下:
HttpTransportSE trans = new HttpTransportSE(URL);5)使用call 方法调用Web Services,代码如下:
trans.call(null, ssEvelope);6)使用getResponse 方法获得Web Services 的返回结果,代码如下:
SoapObject soapResult = (SoapObject)ssEvelope.getResponse();
3 访问Web Services 的实例
我们现在将用简单的例子来实现在Android 平台利用ksoap2-adroid 实现简单的Web Services 访问协议。
3.1 服务器端程序。
我们发布一个简单的Web 服务,其功能是根据用户的输入查询数书目的相关信息。这个Web 服务使用的服务器是ApacheTomcat7.0.5.实现类的源代码如下:
Book 类的代码如下:
利用Eclipse 的工具生成Web 服务的部署文件,并拷贝到Tomcat 服务器~webappsaxis2WEB-INFservices 目录下,启动服务器进行发布。其中,生成的services.xml 文件如下:
图1 Web 服务部属结果图
部署成功后, 我们在浏览器中输入http: / / localhost:8080 /axis2 / services / listServices,可以看到在服务上所部属的服务。
我们可以在http: / / localhost:8080/ axis2 / services / Seach-BookService芽wsdl 网页上看到Web 服务的WSDL 描述。
3.2 Android 客户端
下载ksoap2-android-assembly-2.5.2-jar-with-dependencies.jar 包后, 引入到我们的工程文件中, 就可以使用ksoap2 访问Web 服务了。客户端实现代码如下:
package net.blogjava.mobile.wsclient;
import org.ksoap2.SoapEnvelope;
import org.ksoap2.serialization.SoapObject;
import org.ksoap2.serialization.SoapSerializationEnvelope;
import org.ksoap2.transport.HttpTransportSE;
import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;
import android.widget.TextView;
3.3 测试客户端
在Android 模拟器上运行客户程序, 调用Web 服务后的结果如图2 所示。
图2 运行结果
4 结束语
在Android 平台上,我们可以利用ksoap2 -android 类库实现对Web 服务的访问。实现过程简单、直接,这对在Android 平台上开发更多实用的应用程序提供了很大的方便,也能推动Web 服务技术在Android平台上的发展。