在Android中调用C#写的WebService(附源代码)
由于项目中要使用Android调用C#写的WebService，于是便有了这篇文章。在学习的过程中，发现在C#中直接调用WebService方便得多，直接添加一个引用，便可以直接使用将WebService当做一个对象使用，利用Vs2010中的代码提示功能就能爽歪歪地把想要的东西全部点出来。在Android调用，麻烦了一点，但是也还好。主要是我们需要自己在代码中确定要调用WebService的方法名是什么，要传给WebService什么参数以及对应的参数名，另外，一些额外的信息比如soap的版本号，也需要了解了。
1.准备工作:写一个测试用的WebService
首先，让我们先准备一下WebService，WebService的代码很简单，一个是返回HelloWorld字段，另一个是原样返回用户发给WebService的字符串。
using System; using System.Collections.Generic; using System.Linq; using System.Web; using System.Web.Services; namespace testAndroidCall { /// <summary> /// WebService1 的摘要说明 /// </summary> [WebService(Namespace = "http://tempuri.org/")] [WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)] [System.ComponentModel.ToolboxItem(false)] // 若要允许使用 ASP.NET AJAX 从脚本中调用此 Web 服务，请取消对下行的注释。 // [System.Web.Script.Services.ScriptService] public class WebService1 : System.Web.Services.WebService { [WebMethod] public string HelloWorld() { return "Hello World"; } [WebMethod] public string EchoMessage(string msg) { return msg; } } }
接着，我们需要下载一个Android中调用WebService的类库
比较常用的有Ksoap2，可以从https://code.google.com/p/wsdl2ksoap/downloads/list进行下载。也可以直接点这里下载。
将下载的ksoap2-android-assembly-2.4-jar-with-dependencies.jar包复制到Eclipse工程的lib目录中，当然也可以放在其他的目录里。同时在Eclipse工程中引用这个jar包。
2、完成简单的Android布局代码的编写
(1) 在AdroidManifest.xml中加入权限,<manifest>节点里面加入下面这句话
<!-- 访问网络的权限 --> <uses-permission android:name="android.permission.INTERNET" />
(2)、我们在Android中建立两个按钮，分别对应WebService中的两个方法
private void initBtn() { View btnHelloWorld = this.findViewById(R.id.btnHelloWorld); btnHelloWorld.setOnClickListener(new OnClickListener() { @Override public void onClick(View v) { Map<String, String> values = new HashMap<String, String>(); values.put("msg", "这是Android手机发出的信息"); Request(METHOD_HELLO_WORLD); } }); View btnEchoMessage = this.findViewById(R.id.btnEchoMessage); btnEchoMessage.setOnClickListener(new OnClickListener() { @Override public void onClick(View v) { Map<String, String> values = new HashMap<String, String>(); values.put("msg", "这是Android手机发出的信息"); Request(METHOD_ECHO_MESSAGE,values); } }); }
在Request（…）方法中，我们主要是想实现将WebService中方法名和调用的参数传入WebService。在这个方法中，主要应用了AsyncTask来处理WebService的调用，因为调用WebService是网络操作，可能会比较耗时，在Android3.0以上，已经不允许在UI线程直接进行网络操作，另外，AsyncTask还可以直接更新UI上的控件。
/** * 执行异步任务 * * @param params * 方法名+参数列表（哈希表形式） */ public void Request(Object... params) { new AsyncTask<Object, Object, String>() { @Override protected String doInBackground(Object... params) { if (params != null && params.length == 2) { return CallWebService((String) params[0], (Map<String, String>) params[1]); } else if (params != null && params.length == 1) { return CallWebService((String) params[0], null); } else { return null; } } protected void onPostExecute(String result) { if (result != null) { tvMessage.setText("服务器回复的信息 : " + result); } }; }.execute(params); }
3、分析Android调用WebService的代码
我们的重点将放在CallWebService（）这个方法中。这个方法里面封装了ksoap2类库里面调用WebService的一些对象。
（1） 指定webservice的命名空间和调用的方法名，如：
SoapObject request =new SoapObject(Namespace,MethodName);
SoapObject类的第一个参数表示WebService的命名空间，可以从WSDL文档中找到WebService的命名空间。第二个参数表示要调用的WebService方法名。
（2） 设置调用方法的参数值，如果没有参数，可以省略，设置方法的参数值的代码如下：
Request.addProperty(“param1”,”value”);
Request.addProperty(“param2”,”value”);
要注意的是，addProperty方法的第1个参数表示调用方法的参数名，该参数值要与服务端的WebService类中的方法参数名一致，并且参数的顺序一致。
（3） 生成调用Webservice方法的SOAP请求信息。该信息由SoapSerializationEnvelope对象描述，代码为：
SoapSerializationEnvelope envelope=new SoapSerializationEnvelope(SoapEnvelope.VER12); Envelope.bodyOut = request;
创建SoapSerializationEnvelope对象时需要通过SoapSerializationEnvelope类的构造方法设置SOAP协议的版本号。该版本号需要根据服务端WebService的版本号设置。在创建SoapSerializationEnvelope对象后，不要忘了设置SOAPSoapSerializationEnvelope类的bodyOut属性，该属性的值就是在第一步创建的SoapObject对象。
注：
SOAP协议的版本号可以从WebService的WSDL文档（在本例中是“http://192.168.0.121/testAndroidCall/WebService1.asmx?WSDL”）
（4） 创建HttpTransportsSE对象。通过HttpTransportsSE类的构造方法可以指定WebService的WSDL文档的URL：
HttpTransportSE ht=new HttpTransportSE(WEB_SERVICE_URL);
WEB_SERVICE_URL是指WebService的地址，如"http://192.168.0.121:80/testAndroidCall/WebService1.asmx?wsdl"这样的
(5)使用call方法调用WebService方法，代码：
ht.call（null，envelope）；Call方法的第一个参数一般为null，第2个参数就是在第3步创建的SoapSerializationEnvelope对象。
(6)使用getResponse方法获得WebService方法的返回结果，代码：
SoapPrimitive result = (SoapPrimitive) envelope.getResponse();
(7)最后，附上完整的CallWebService（）方法
/** * 调用WebService * * @return WebService的返回值 * */ public String CallWebService(String MethodName, Map<String, String> Params) { // 1、指定webservice的命名空间和调用的方法名 SoapObject request = new SoapObject(Namespace, MethodName); // 2、设置调用方法的参数值，如果没有参数，可以省略， if (Params != null) { Iterator iter = Params.entrySet().iterator(); while (iter.hasNext()) { Map.Entry entry = (Map.Entry) iter.next(); request.addProperty((String) entry.getKey(), (String) entry.getValue()); } } // 3、生成调用Webservice方法的SOAP请求信息。该信息由SoapSerializationEnvelope对象描述 SoapSerializationEnvelope envelope = new SoapSerializationEnvelope( SoapEnvelope.VER12); envelope.bodyOut = request; // c#写的应用程序必须加上这句 envelope.dotNet = true; HttpTransportSE ht = new HttpTransportSE(WEB_SERVICE_URL); // 使用call方法调用WebService方法 try { ht.call(null, envelope); } catch (HttpResponseException e) { e.printStackTrace(); } catch (IOException e) { e.printStackTrace(); } catch (XmlPullParserException e) { e.printStackTrace(); } try { final SoapPrimitive result = (SoapPrimitive) envelope.getResponse(); if (result != null) { Log.d("----收到的回复----", result.toString()); return result.toString(); } } catch (SoapFault e) { Log.e("----发生错误---", e.getMessage()); e.printStackTrace(); } return null; }
4、运行代码
要运行文章中的代码，请先将WebService部署在IIS上，要保证Android手机的测试程序和WebService处在同一个局域网中。