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

在现在的应用程序中。不可能不使用到网络，而且后台一定是有server作为支撑的。

现在最常见的调用方式有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;
	}

	/**
	 * 启动线程
	 */
	/**
	 * 要向server传递的四个參数各自是： （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  。欢迎大家訪问！