上篇文章已经对Web Service及其相关知识进行了介绍(Android开发之WebService介绍 ),相信有的朋友已经忍耐不住想试试在Android应用中调用Web Service。本文将通过一个简单的示例讲解和演示Android平台的Web Service开发。

Ksoap2-android简介
      在Android平台调用Web
Service需要依赖于第三方类库ksoap2,它是一个SOAP Web
service客户端开发包,主要用于资源受限制的Java环境如Applets或J2ME应用程序(CLDC/
CDC/MIDP)。认真读完对ksoap2的介绍你会发现并没有提及它应用于Android平台开发,没错,在Android平台中我们并不会直接使用
ksoap2,而是使用ksoap2 android。KSoap2 Android
是Android平台上一个高效、轻量级的SOAP开发包,等同于Android平台上的KSoap2的移植版本。

Ksoap2-android jar包下载
      ksoap2 android当前的最新版本为2.5.4,名为ksoap2-android-assembly-2.5.4-jar-with-dependencies.jar,它的下载地址是:http://code.google.com/p/ksoap2-android/,进入页面后,点击“Downloads”标签页,如下图所示:
     
     
在“Downloads”页面的下方,找到如下图所示的紫色的链接,然后在链接上点击右键,找到相关下载项进行下载即可。右键菜单中显示的下载项依据浏览
器的不同而有所区别,比如我使用的360浏览器,在键接上点击右键,然后选择“使用360安全浏览器下载”即可弹出下载保存对话框。
     

Android平台调用Web Service示例
     下面将通过一个示例讲解如何在Android平台调用Web Service。既然要调用Web Service,那就要先有Web Service。我们还是选择使用上篇文章中介绍的查询手机号码归属地的Web service,它的WSDL为http://webservice.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl
1)新建Android工程,引入上面下载的ksoap2-android类库
      Android工程的创建就不多说了,主要想说明的是如何向Android工程中添加第三方jar包。当然,添加第3方jar的方式有多种,我个人比较喜欢用下面这种方式,即先将第三方jar包拷贝到工程某个目录下,再将其加入到工程的Build Path中
      例如,我创建的Android工程名为WSClient,在工程名上点击右键,新建一个Folder(目录或文件夹),名为libs,然后将ksoap2-android类库拷贝到libs目录中,如下图所示:
            
     
接着,在jar包ksoap2-android-assembly-2.4-jar-with-dependencies.jar上点击右键,依次选择
“Build Path”-“Add to Build Path”。再在工程名上点击右键,依次选择“Build Path”-“Config
Build Path...”,将看到如下所示界面:
     
选中ksoap2 jar包前面的选项框,点击OK,则完成了ksoap2 jar包的添加(说明:在Android工程中,添加其它jar包的方法完全一样,操作一两遍后,你会发现其实很简单的)。
2)编写布局文件res/layout/main.xml

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  3. android:orientation="vertical"
  4. android:layout_width="fill_parent"
  5. android:layout_height="fill_parent"
  6. android:paddingTop="5dip"
  7. android:paddingLeft="5dip"
  8. android:paddingRight="5dip"
  9. >
  10. <TextView
  11. android:layout_width="fill_parent"
  12. android:layout_height="wrap_content"
  13. android:text="手机号码(段):"
  14. />
  15. <EditText android:id="@+id/phone_sec"
  16. android:layout_width="fill_parent"
  17. android:layout_height="wrap_content"
  18. android:inputType="textPhonetic"
  19. android:singleLine="true"
  20. android:hint="例如:1398547"
  21. />
  22. <Button android:id="@+id/query_btn"
  23. android:layout_width="wrap_content"
  24. android:layout_height="wrap_content"
  25. android:layout_gravity="right"
  26. android:text="查询"
  27. />
  28. <TextView android:id="@+id/result_text"
  29. android:layout_width="wrap_content"
  30. android:layout_height="wrap_content"
  31. android:layout_gravity="center_horizontal|center_vertical"
  32. />
  33. </LinearLayout>

3)编写MainActivity类

  1. package com.liufeng.ws.activity;
  2. import org.ksoap2.SoapEnvelope;
  3. import org.ksoap2.serialization.SoapObject;
  4. import org.ksoap2.serialization.SoapSerializationEnvelope;
  5. import org.ksoap2.transport.HttpTransportSE;
  6. import android.app.Activity;
  7. import android.os.Bundle;
  8. import android.view.View;
  9. import android.view.View.OnClickListener;
  10. import android.widget.Button;
  11. import android.widget.EditText;
  12. import android.widget.TextView;
  13. /**
  14. * Android平台调用WebService(手机号码归属地查询)
  15. *
  16. * @author liufeng
  17. * @date 2011-05-18
  18. */
  19. public class MainActivity extends Activity {
  20. private EditText phoneSecEditText;
  21. private TextView resultView;
  22. private Button queryButton;
  23. @Override
  24. public void onCreate(Bundle savedInstanceState) {
  25. super.onCreate(savedInstanceState);
  26. setContentView(R.layout.main);
  27. phoneSecEditText = (EditText) findViewById(R.id.phone_sec);
  28. resultView = (TextView) findViewById(R.id.result_text);
  29. queryButton = (Button) findViewById(R.id.query_btn);
  30. queryButton.setOnClickListener(new OnClickListener() {
  31. @Override
  32. public void onClick(View v) {
  33. // 手机号码(段)
  34. String phoneSec = phoneSecEditText.getText().toString().trim();
  35. // 简单判断用户输入的手机号码(段)是否合法
  36. if ("".equals(phoneSec) || phoneSec.length() < 7) {
  37. // 给出错误提示
  38. phoneSecEditText.setError("您输入的手机号码(段)有误!");
  39. phoneSecEditText.requestFocus();
  40. // 将显示查询结果的TextView清空
  41. resultView.setText("");
  42. return;
  43. }
  44. // 查询手机号码(段)信息
  45. getRemoteInfo(phoneSec);
  46. }
  47. });
  48. }
  49. /**
  50. * 手机号段归属地查询
  51. *
  52. * @param phoneSec 手机号段
  53. */
  54. public void getRemoteInfo(String phoneSec) {
  55. // 命名空间
  56. String nameSpace = "http://WebXml.com.cn/";
  57. // 调用的方法名称
  58. String methodName = "getMobileCodeInfo";
  59. // EndPoint
  60. String endPoint = "http://webservice.webxml.com.cn/WebServices/MobileCodeWS.asmx";
  61. // SOAP Action
  62. String soapAction = "http://WebXml.com.cn/getMobileCodeInfo";
  63. // 指定WebService的命名空间和调用的方法名
  64. SoapObject rpc = new SoapObject(nameSpace, methodName);
  65. // 设置需调用WebService接口需要传入的两个参数mobileCode、userId
  66. rpc.addProperty("mobileCode", phoneSec);
  67. rpc.addProperty("userId", "");
  68. // 生成调用WebService方法的SOAP请求信息,并指定SOAP的版本
  69. SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER10);
  70. envelope.bodyOut = rpc;
  71. // 设置是否调用的是dotNet开发的WebService
  72. envelope.dotNet = true;
  73. // 等价于envelope.bodyOut = rpc;
  74. envelope.setOutputSoapObject(rpc);
  75. HttpTransportSE transport = new HttpTransportSE(endPoint);
  76. try {
  77. // 调用WebService
  78. transport.call(soapAction, envelope);
  79. } catch (Exception e) {
  80. e.printStackTrace();
  81. }
  82. // 获取返回的数据
  83. SoapObject object = (SoapObject) envelope.bodyIn;
  84. // 获取返回的结果
  85. String result = object.getProperty(0).toString();
  86. // 将WebService返回的结果显示在TextView中
  87. resultView.setText(result);
  88. }
  89. }

讲解:
      注意点1:
代码中的62-69行所示,调用Web Service之前你需要先弄清楚这4个的值分别是什么:命名空间、调用的方法名称、EndPoint和SOAP

Action。当在浏览器中访问WSDL时,很容易得知命名空间、调用的方法名称是什么(不明白的请看上篇文章),至于EndPoint通常是将WSDL
地址末尾的"?wsdl"去除后剩余的部分;而SOAP
Action通常为命名空间 + 调用的方法名称。
      注意点2:75-76行是设置调用WebService接口方法需要传入的参数。(在WSDL中能够看到调用方法需要传入的参数个数及参数名称,在设置参数时最好指明每一个传入参数的名称,如本例中的mobileCode、userId。网上有些资料说在需要传入多个参数时,只要多个参数的顺序与WSDL中参数出现的顺序一致即可,名称并不需要和WSDL中的一致,但实际测试发现,大多数情况下并不可行!
      例如下面图版上显示的WSDL片段,调用该Web Service的checkUserInfo方法就需要传入4个参数,参数名称分别为:in0、in1、in2和in3。
           
      注意点3
许你会对第100行代码产生疑惑,为什么要用object.getProperty("getMobileCodeInfoResult")来取得调用结
果?那是因为WSDL中明确告诉了返回结果是String数组,它的名称为getDatabaseInfoResult,WSDL中的描述如下:
"
maxOccurs" name="getDatabaseInfoResult"
type="tns:ArrayOfString" /> 
      本例中调用WebService后返回的结果如下所示:
           <?xml version="1.0" encoding="utf-8"?> 
            <string
xmlns="http://WebXml.com.cn/">1398547:贵州
贵阳 贵州移动黔中游卡
</string>
咦,这里明明返回的是xml格式的内容,为什么我们不需要通过解析xml来获取我们需要的内容呢?其实如果你仔细看代码中的96-97行并不难发现:
            // 获取返回的数据
            SoapObject object = (SoapObject) envelope.bodyIn;
ksoap2能够将返回的xml转换成SoapObject对象,然后我们就可以通过操作对象的方式来获取需要的数据了。
      注意点4同样还是第100行代码。从有些WSDL中我们并不能得知返回结果的名称(如本例中的getMobileCodeInfoResult),
那又该如何调用呢?其实上面已经暗示了这个问题:当通过第97行代码获取返回结果并将其转换成SoapObject对象后,如果你并不知道通过该对象的哪
个属性来取值,你完全可以调用对象的toString()方法来查看返回的内容,例如将本例中的第100行代码替换成:
            // 获取返回的结果
             String result = object.toString();
这样得到的返回结果为:
     
注意看括号{}里面的内容是一个键-值对形式,以等号=分隔,我们正是通过=号左边的“getMobileCodeInfoResult”来获取右边的查询结果。
      其实在不知道返回结果名称时(如本例的100行,我们并不知道返回结果中有属性getMobileCodeInfoResult),有一种更为简便的方法,直接通过索引下标来获取属性值,也就是将第100行代码替换为:
            String result = object.getProperty(0).toString();
      注意点5:本例中只返回了一个值,但有些WebService会返回多个值该怎么获取?获取方法与本例完全一样,只是需要注意的是如果是返回多个值,通过第100代码object.getProperty(0);得到的可能仍然是一个SoapObject。不断地调用getProperty()方法;总能得到你想要的全部结果。
      注意点6:
调用某些WebService时,可能会报一些异常,但你又发现除了调用的WebService不同之外,其它地方的写法和我的完全一样,这又该如何解决
呢?尝试改变第79代码中SOAP的版本号,可以分别尝试使用SoapEnvelope.VER10、SoapEnvelope.VER11、
SoapEnvelope.VER12这样三个值。另外,在调用某些WebService时,可能在第91行代码中,调用WebService时并不需要
传入soapAction,将其置为null即可。
4)在AndroidManifest.xml中配置添加访问网络的权限(千万别忘记!!!)

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <manifest xmlns:android="http://schemas.android.com/apk/res/android"
  3. package="com.liufeng.ws.activity"
  4. android:versionCode="1"
  5. android:versionName="1.0">
  6. <application android:icon="@drawable/icon" android:label="@string/app_name">
  7. <activity android:name=".MainActivity" android:label="@string/app_name">
  8. <intent-filter>
  9. <action android:name="android.intent.action.MAIN" />
  10. <category android:name="android.intent.category.LAUNCHER" />
  11. </intent-filter>
  12. </activity>
  13. </application>
  14. <uses-sdk android:minSdkVersion="4" />
  15. <!-- 访问网络的权限 -->
  16. <uses-permission android:name="android.permission.INTERNET" />
  17. </manifest>

5)运行结果
     

Android平台调用WebService详解的更多相关文章

  1. [019] Android平台调用WebService详解

    http://blog.csdn.net/lyq8479/article/details/6428288/ http://www.cnblogs.com/gzggyy/archive/2011/06/ ...

  2. 基础拾遗------webservice详解

    基础拾遗 基础拾遗------特性详解 基础拾遗------webservice详解 基础拾遗------redis详解 基础拾遗------反射详解 基础拾遗------委托详解 基础拾遗----- ...

  3. android:ToolBar详解

    android:ToolBar详解(手把手教程) 泡在网上的日子 发表于 2014-11-18 12:49 第 124857 次阅读 ToolBar 42 来源 http://blog.mosil.b ...

  4. Android之canvas详解

    首先说一下canvas类: Class Overview The Canvas class holds the "draw" calls. To draw something, y ...

  5. 【转】Android Canvas绘图详解(图文)

    转自:http://www.jcodecraeer.com/a/anzhuokaifa/androidkaifa/2012/1212/703.html Android Canvas绘图详解(图文) 泡 ...

  6. Android 核心分析 之八Android 启动过程详解

    Android 启动过程详解 Android从Linux系统启动有4个步骤: (1) init进程启动 (2) Native服务启动 (3) System Server,Android服务启动 (4) ...

  7. Android GLSurfaceView用法详解(二)

    输入如何处理       若是开发一个交互型的应用(如游戏),通常需要子类化 GLSurfaceView,由此可以获取输入事件.下面有个例子: java代码: package eoe.ClearTes ...

  8. Android编译过程详解(一)

    Android编译过程详解(一) 注:本文转载自Android编译过程详解(一):http://www.cnblogs.com/mr-raptor/archive/2012/06/07/2540359 ...

  9. android屏幕适配详解

    android屏幕适配详解 官方地址:http://developer.android.com/guide/practices/screens_support.html 一.关于布局适配建议 1.不要 ...

随机推荐

  1. C#WinForm中在dataGridView中添加中文表头

    第一步: 注意事项:(1)如果使用数据库,那么第三步的名称可以是任意的,但是不能和数据库中的列名一样,否则会报错:    (2)第四步的页眉文本就是你想用的中文列名,自己定: (3)第六步尤其重要,不 ...

  2. C/C++ 快速排序 quickSort

    下面的动画展示了快速排序算法的工作原理. 快速排序图示:可以图中在每次的比较选取的key元素为序列最后的元素. #include <stdio.h> #include <stdlib ...

  3. c# 与 Unity3d 中的序列化

    圣典中对于Unity3D的序列化介绍很容易和C#的序列化介绍搞混,做个笔记,方便以后查找. 很多资料算是拾人牙慧. 一.Serializable 序列化 Inherits from Attribute ...

  4. 实战案例--Grunt构建Web程序

    GruntJS构建Web程序.使用Gruntjs来搭建一个前端项目,然后使用grunt合并,压缩JS文件,熟练了node.js安装和grunt.js安装后,接下来来实战一个案例,案例是根据snandy ...

  5. Test Markdown Editor

    Last night, I just saw a cute blogger's homepage. Then I want to write something. But anyway, I use ...

  6. Mysql 1030 Got error -1 from storage engine 错误解决

    检查你的my.cnf或my.ini,里面会有一个参数innodb_force_recovery,你看看他的值,默认是没有这个参数,没有的话,他的默认值是0,这个参数的值如果大于0,innodb会被禁止 ...

  7. 教育行业SaaS选型 需要注意的三点问题

    2008年经济危机席卷全球,造成世界范围内的金融动荡,国内各行业虽然都面临了不小的冲击,但是在危机面前,中国的教育行业却逆势而上,硕果累累.据统计,2008年教育行业的投资案例达18起,投资金额18. ...

  8. OPenGL中三维图形的矩阵变换

    对于二维的图形开发,拿简单的图片显示来说,我们主要的目的:就是在一块显示buffer中,不停的把每个像素进行着色,然后就可以绘制出来了.为了速度,很多其他的加速方法,但原理基本上就是这样了. 很直观, ...

  9. 一起学Maven

    转载自:http://blog.csdn.net/songdeitao/article/details/18452459 一. 初识Maven 开场白 在现在的项目开发过程中,越来越重视项目的管理,而 ...

  10. Ios 弹框 MJPopup,KxMenu

    IOS 弹框 如果直接弹出一个自定义的视图 可以选用第三方: MJPopup 弹出: if(!bandview) { bandview=[[[NSBundle mainBundle]loadNibNa ...