Android使用ksoap2调用webservice

1.使用免费的webservice接口

这里我们使用的是http://ws.webxml.com.cn/WebServices/WeatherWS.asmx这个接口作测试，如下图所示



这里列出了许多方法，我们这里选用getRegionProvince这个方法。它可以获得中国的所有省份信息。

这里我们点击getRegionProvince进去看一看



这个页面便是这个方法的详细描述，我们点击一下“调用”按钮，就可以测试一下这个接口，我这里就不截图了，它会返回一个XML文档，列出省份的信息。

2.下载ksoap2

我使用的是Android Studio这款软件开发，但是我没找到如何直接用Gradle下载这个库，所以就直接下载jar包好啦^_^

http://simpligility.github.io/ksoap2-android/getting-started.html



在这里下载最新的jar包就可以了，然后把它放到这里，注意蓝色框框的地方要选择project哦



在app下的 build.gradle 中加上这一句，然后重新构建gradle就可以啦~

compile files('libs/ksoap2-android-assembly-3.6.2-jar-with-dependencies.jar')

3.使用ksoap2调用webserivce

大致分为以下几步

1. 设置参数

这里我们需要设置4个参数，分别是SOAP_ACTION、NAMESPACE、METHOD_NAME和URL，让我们再来看一下webservice的页面。



图片中标明了这几个参数，还有一个URL参数，就是WSDL文件的地址了

http://ws.webxml.com.cn/WebServices/WeatherWS.asmx?WSDL

WSDL文件就是描述这个web服务的XML文件

我这里在界面中放了一个按钮，在Click事件中请求这个webservice。

下面是定义这几个参数的代码：

private static String SOAP_ACTION="http://WebXml.com.cn/getRegionProvince";
private static String NAMESPACE="http://WebXml.com.cn/";
private static String METHOD_NAME="getRegionProvince";
private static String URL="http://ws.webxml.com.cn/WebServices/WeatherWS.asmx?WSDL";

2.从webservice上获取数据

我们写一个函数getInformation() 用来获取从webservice上返回的数据。

private SoapObject getInformation(){
SoapObject request=new SoapObject(NAMESPACE,METHOD_NAME);
SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER11);
envelope.setOutputSoapObject(request);
try{
HttpTransportSE transportSE=new HttpTransportSE(URL);
transportSE.call(SOAP_ACTION,envelope);
SoapObject result=(SoapObject)envelope.bodyIn; //获取到返回的结果，并强制转换成SoapObject对象
SoapObject test = (SoapObject)result.getProperty(0); //该对象中还嵌套了一个SoapObject对象，需要使用getProperty(0)把这个对象提取出来
return test;
}catch (Exception e){
e.printStackTrace();
}
return null;
}

3.从主线程上显示数据

由于这是一个网络请求，必须在子线程上进行，我们这里使用AsyncTask类。

class DownloadTask extends AsyncTask<Void,Integer,Boolean>{

@Override
protected Boolean doInBackground(Void... voids) {
result =  getInformation(); //在子线程中请求webservice
return null;
}

@Override
protected void onPostExecute(Boolean aBoolean) {
StringBuilder builder = new StringBuilder();
//解析返回的数据
for(int i=0;i<result.getPropertyCount();i++){
builder.append(result.getProperty(i));
}
Toast.makeText(MainActivity.this, builder.toString(), Toast.LENGTH_SHORT).show();
}
}

最后在按钮点击事件中执行这个AsyncTask就可以啦！

new DownloadTask().execute();

看一下最后的效果吧^_^



点击“请求WEBSERVICE接口”，就可以显示数据啦！

4.小结

这个算是最最简单的功能了，但是有了这个做基础，想做基于webservice的复杂Android应用也不在话下啦！学习新的技术，都要从一个最简单的DEMO开始，就像Hello World!一样，有了它作为敲门砖，后面的路就越来越轻松了=￣ω￣=