Android程序使用SOAP调用远程WebService服务

        在如今的应用程序中，不可能不使用到网络，并且后台一定是有服务器作为支撑的。如今最常见的调用方式有HTTP的GET ，POST方式，返回JSON或者XML数据。但是也有一种常见的形式就是调用WebService。现在我们来实现一下在Android端使用SOAP简单对象访问协议来调用WebService数据。主要的需求是根据某个手机号码返回这个号码的运营商，卡类型以及归属地等信息。

（1）先从网上下载一个ksoap的jar包，放入项目的libs文件夹下，我也提供百度网盘的下载：http://pan.baidu.com/s/1o6svnC2    。

（2）推荐一个可以调用WebService的网站，上面提供了很多的服务，http://www.webxml.com.cn/zh_cn/index.aspx   。

（3）在Activity中的实现的代码如下：主要做界面显示操作，并初始化一些WebService调用的参数，如URL地址，命名空间，方法名称，参数列表等。

package com.example.testwebservice2;

import java.util.HashMap;

import android.app.Activity;
import android.content.Context;
import android.os.Bundle;
import android.os.Handler;
import android.os.Message;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;
import android.widget.TextView;

public class WebserviceActivity extends Activity {

private Context context;

private static final String URL = "http://webservice.webxml.com.cn/WebServices/MobileCodeWS.asmx";// 请求的url
private static final String NAMESPACE = "http://WebXml.com.cn/";// 请求的命名空间；
private static final String METHODNAME = "getMobileCodeInfo"; // 方法名称，获得国内手机号码归属地省份，地区和手机卡类型信息；
private EditText phoneNum;
private Button query;
private TextView showResult;

private Handler handler = new Handler() {// 刷新界面；
public void handleMessage(Message msg) {
String myData = msg.getData().getString("data");// 这里是完全解析好后的数据；用于显示；
if (myData != null || !"".equals(myData)) {
showResult.setText(myData);
}
};
};

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
this.context = this;
initView();
query.setOnClickListener(new OnClickListener() {
@Override
public void onClick(View v) {
// 手机号码（段）
String phoneSec = phoneNum.getText().toString().trim();
// 简单判断用户输入的手机号码（段）是否合法
if ("".equals(phoneSec) || phoneSec.length() < 7) {// 输入不合法；
phoneNum.setError("您输入的手机号码（段）有误！"); // 给出错误提示
phoneNum.requestFocus();
// 将显示查询结果的TextView清空
phoneNum.setText("");
return;
}
ResponseOnClick(); // 输入没问题，开始请求数据；
}
});
}

private void initView() {
phoneNum = (EditText) findViewById(R.id.phone_sec);
query = (Button) findViewById(R.id.query_btn);
showResult = (TextView) findViewById(R.id.result_text);
}

private void ResponseOnClick() {
HttpThread thread = new HttpThread(handler, context);
HashMap<String, Object> params = new HashMap<String, Object>();
String phoneSec = phoneNum.getText().toString().trim();// 电话号码；
params.put("mobileCode", phoneSec);// mobileCode：字符串，手机号码，最少前七位数字；
params.put("userId", "");// 字符串，免费用户为空字符串；
thread.doStart(URL, NAMESPACE, METHODNAME, params);
}

}

（4）新建一个线程类，继承自Thread，主要做访问WebService的网络操作。接收返回的数据并传递给Activity。

package com.example.testwebservice2;

import java.util.HashMap;
import java.util.Iterator;
import java.util.Map;
import java.util.Map.Entry;

import org.ksoap2.SoapEnvelope;
import org.ksoap2.serialization.SoapObject;
import org.ksoap2.serialization.SoapPrimitive;
import org.ksoap2.serialization.SoapSerializationEnvelope;
import org.ksoap2.transport.HttpTransportSE;

import android.app.ProgressDialog;
import android.content.Context;
import android.os.Bundle;
import android.os.Handler;
import android.os.Message;
import android.util.Log;

class HttpThread extends Thread {
private Handler handler = null;
private Context context = null;
private String url = null;
private String namespace = null;
private String methodName = null;
HashMap<String, Object> params = new HashMap<String, Object>();// 参数列表；
private ProgressDialog progressDialog = null;

// 构造函数
public HttpThread(Handler handler, Context context) {
this.handler = handler;
this.context = context;
}

/**
* 启动线程
*/
/**
* 要向服务器传递的四个参数分别是： （1）URL （2）命名空间 （3）方法名 （4）参数列表
*
* @param url
* @param namespace
* @param methodName
* @param params
*/
public void doStart(String url, String namespace, String methodName,
HashMap<String, Object> params) {
this.url = url;
this.namespace = namespace;
this.methodName = methodName;
this.params = params;
progressDialog = ProgressDialog.show(context, "提示", "正在请求请稍等...", true);
this.start();// 启动这个线程；
}

/**
* 线程运行
*/
@Override
public void run() {
try {
// web service 请求
SoapObject result = (SoapObject) CallWebService();
Log.i("HttpThread_getPropertyCount", result.getPropertyCount() + "");
Log.i("HttpThread_getProperty(0)", result.getProperty(0) + "");
// 构造数据
String value = null;
if (result != null && result.getPropertyCount() > 0) {
for (int i = 0; i < result.getPropertyCount(); i++) {
SoapPrimitive primitive = (SoapPrimitive) result
.getProperty(i);
value = primitive.toString();
}
/**
* 这里获得的value就是WebService的值： 18710498511：陕西 西安 陕西移动全球通卡
*/
// Log.i("HttpThread_value", value);
// 取消进度框
progressDialog.dismiss();
// 构造消息
Message message = handler.obtainMessage();
Bundle bundle = new Bundle();
bundle.putString("data", value);// 传递到界面进行显示；
message.setData(bundle);
handler.sendMessage(message);// 传递到到Activity的handmessage()中进行处理；
}// if
} catch (Exception e) {
e.printStackTrace();
}
}// run();

private Object CallWebService() {
String SOAP_ACTION = namespace + methodName;// 命名空间+方法名称；
SoapObject request = new SoapObject(namespace, methodName);// 创建SoapObject实例
// 生成调用web service 方法的soap请求消息
SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(
SoapEnvelope.VER11);
// 设置.net web service
envelope.dotNet = true;

// 请求参数
if (params != null && !params.isEmpty()) {
for (Iterator it = params.entrySet().iterator(); it.hasNext();) {
Map.Entry<String, Object> e = (Entry) it.next();
request.addProperty(e.getKey().toString(), e.getValue());
}
}
// 发送请求
envelope.setOutputSoapObject(request);
HttpTransportSE transport = new HttpTransportSE(url);
SoapObject result = null;
try {
// web service请求
transport.call(SOAP_ACTION, envelope);
result = (SoapObject) envelope.bodyIn;
} catch (Exception ex) {
ex.printStackTrace();
}
Log.i("result", result.toString());
return result;
}// CallWebService();
}// HttpThread类；

 （5）程序运行结果如图：


..

github主页：https://github.com/chenyufeng1991  。欢迎大家访问！