Android通过ksoap2调用.net(c#)的webservice
近段时间终於全面向Android平台进军，但是在进入的时候，的确遇到很多问题，即使在调用WebService也遇到了不少的问题，在一番系统的学习过後，终於明白了个大概，现将学习的心得写下，与所有跟我一样刚入门的菜菜分享。
本人开发环境为Android Studio，如用Eclipse的童鞋请参照参照。
■下载 ksoap2-android 包
去http://code.google.com/p/ksoap2-android/wiki/HowToUse?tm=2下载最新版的“ksoap2-android”，我现时使用的版本为：“ksoap2-android-assembly-3.0.0-RC.4-jar-with-dependencies.jar”
■引用包
下载後，将类库复制到“libs” 文件下。如果Eclipse的童鞋到这里引用就完事了，但於Android Studio的就还没有完，因为Android Studio使用的是gradle，故还需要对引用进行声明。找到build.gradle文件（於项目的底部），打开於dependencies节点里，添加代码：
dependencies { compile 'com.android.support:support-v4:13.0.+' //添加以下代码以声明类库的引用 compile files('libs/ksoap2-android-assembly-3.0.0-RC.4-jar-with-dependencies.jar') }
下面开始我以一个登录的例子来讲解整个webserive的调用过程
layout_login中有两个EditText控件，一个按钮，登录界面最基本的配置。
<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="match_parent" android:gravity="center|center_horizontal|center_vertical" android:orientation="vertical" android:background="#6AA7D2"> <LinearLayout android:id="@+id/Layout_Input" android:layout_width="match_parent" android:layout_height="wrap_content" android:layout_margin="15dp" android:layout_marginBottom="0dp" android:orientation="vertical"> <EditText android:id="@+id/Txt_Name" android:layout_width="match_parent" android:layout_height="wrap_content" android:inputType="text" android:hint="用户名" /> <EditText android:id="@+id/Txt_Password" android:layout_width="match_parent" android:layout_height="wrap_content" android:inputType="textPassword" android:hint="密码" /> </LinearLayout> <LinearLayout android:id="@+id/Layout_Button" android:layout_width="match_parent" android:layout_height="wrap_content" android:layout_margin="20dp"> <Button android:id="@+id/Btn_Login" android:layout_weight="1" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="登录" android:onClick="Btn_Login_OnClick" /> </LinearLayout> </LinearLayout>
当点击登录Button时，执行以下事件
public void Btn_Login_OnClick(View view) { loginName = ControlHelper.GetText(this, R.id.Txt_Name); loginPassword = ControlHelper.GetText(this, R.id.Txt_Password); if (loginName.equals("")) { MessageHelper.AlertDialog(this, "操作提示","用户名不能为空.")); findViewById(R.id.Txt_Name).requestFocus(); return; }
view.setEnabled(false); progressDialog = ProgressDialog.show(this,"Loading...","Please wait...",true,false); Thread thread = new Thread(new Runnable() { @Override public void run() { SystemClock.sleep(1000); Login(loginName, loginPassword); } }); thread.start(); }
说明：由於Android4.0以後主线程为了线程安全，访问网络不能由主线程进，只能由子线程访问，另外像.net的winform一样，子线程不能控制UI，所有的UI都必需由主线程控制，所以所有的什麽提示框，等候框都必需由主线程去操作。所以上面的代码中，Login的方法是在新开的子线程中完成的。
而Runnable就是一个Thread要实现的接口，此接口中有一个run()方法，当线程执行start()方法时，就会自动调用Thread的Runnable接口中的run()方法。所以我们要子线程执行的所有代码都在run()里完成。
顺带一提的就是，子线程读取UI上控件的值是没有限制的，所以如果想在子程线中读取UI，直接读取就可以了。
但於子线程又是怎样跟主线程沟通的呢？这就要提到另外两个东东就是Handler跟Message了。
下面先看一看Login方法里面的代码
private void Login(String name,String psw) { Message msg = new Message(); try {
//声明Service的空间命名，.net默认为 http://tempuri.org/
//第二个参数是要调用的方法 SoapObject so = new SoapObject(this.getString(R.string.webservice_namespace), "Login");
//设置调用Service需要传入的两个参数，闻说参数名可以不正确，但顺序必需要正确 so.addProperty("accountName", name); so.addProperty("password", psw);
// 设置调用WebService方法的SOAP请求信息,并指定SOAP的版本 SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER12); envelope.bodyOut = so;
// 设置是否调用的是dotNet开发的WebService envelope.dotNet = true;
// 设置Service所使用的URL String url = this.getString(R.string.webservice_domain) + this.getString(R.string.webservice_url_logic); HttpTransportSE ht = new HttpTransportSE(url); ht.call(null, envelope); if (envelope.getResponse()!=null) {
//接收返回的对象 SoapObject responseSO = (SoapObject)envelope.getResponse(); Boolean succeed = Boolean.parseBoolean(responseSO.getProperty("Succeed").toString()); if(!succeed) { msg.obj = responseSO.getProperty("Message").toString(); msg.what = 0; } else { msg.obj = responseSO.getProperty("ReturnObject"); msg.what = 1; } } } catch (Exception ex) { msg.obj = ex.getMessage(); msg.what = -1; } finally { handler.sendMessage(msg); } }
我先讲讲我们的ksoap2是如何使用，再去讲解Message与Handler。
上面的注释都写得很清楚了，在这里我提一提，在获取接收的对象时，有两种方法：
1. envelope.bodyIn
2.envelope.getResponse();
我选用的是第二种方法，因为我发现可以很好转换回一个SoapObject，可能bodyIn都可以，但我没有深入的研究，没有发言权，有兴趣又好学的同学们可以研究一下，记得研究完跟我说一声。
别外值得一提如果你的Service返回的是一个对象，在ksoap2里，你的对象依然是一个SoapObject，你必须要写代码自已转换，後面我还会有文章另外介绍。
下面再讲如何，通知主线程，我所获取得的返回结果了，大家看到，於Login方法中一开始就定义了一个Message的对象，其实这个对象就是用於线程之间通讯所使用的，姑且先这样理解。
他有一个obj的属性与一个what的属性，obj用於存放通讯的数据，what是用於存放一个标志，为什麽需要这个标志呢？因为你Message可能有好多种状态情况，what就是为了区分这些状态而存在，如果你还是有不明白的，可能看了以下的代码，或许会对你的了解有所帮助。
Handler接收Message
private Handler handler = new Handler(){ @Override public void handleMessage(Message msg){ findViewById(R.id.Btn_Login).setEnabled(true); progressDialog.dismiss(); switch (msg.what) { case -1: //exception MessageHelper.AlertDialog(Activity_Main.this, "异常提示", msg.obj.toString()); break; case 0: //fail MessageHelper.AlertDialog(Activity_Main.this, "错误提示", msg.obj.toString()); break; case 1: //login success MessageHelper.AlertDialog(Activity_Main.this, "操作提示", "登录成功。");
break;
default: break; } } };
最後是需要在activity中定义一个Handler对象，并实现handleMessage的方法就可以。这样整个调用Webservice的过程就完成了。
但是这里面还差一点小小的动作，就是由於你的程序未声明网络访问的权限，所以无法接入网络，并且有异常被抛出，声明方法是，只需要在AndroidManifest.xml中声明就可以了。
<uses-sdk android:minSdkVersion="7" android:targetSdkVersion="16" /> <!--添加以下节点声明网络使用--> <uses-permission android:name="android.permission.INTERNET" />
OK，你的调用webservice的程序就可以正常运行了。
