Android平台调用Web Service：演示样例

近期在学习Android，随着移动设备的流行，当软件走上商业化的道路，为了争夺市场，肯定须要支持Android的，所以開始接触了Android，只是仅仅了解皮毛就好，由于我们要做管理者嘛，懂点Android，管理起来easy些。

Android学起来也简单，封装的更好了，一个个的控件，像是又回到了VB的赶脚。

以下将通过一个演示样例解说怎样在Android平台调用Web Service。我们使用互联网现成的Webservice，供查询手机号码归属地的Web
service，它的WSDL为http://webservice.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl。

1）新建Androidproject，引入上面下载的ksoap2-android类库

在Android平台调用WebService须要依赖于第三方类库ksoap2，它是一个SOAP Webserviceclient开发包，主要用于资源受限制的Java环境如Applets或J2ME应用程序（CLDC/ CDC/MIDP）。

而在Android平台中我们并不会直接使用ksoap2，而是使用ksoap2android。KSoap2 Android 是Android平台上一个高效、轻量级的SOAP开发包

2）编写布局文件res/layout/main.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:paddingTop="5dip"
    android:paddingLeft="5dip"
    android:paddingRight="5dip"
    >
    <TextView
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="手机号码(段)："
    />
    <EditText android:id="@+id/phone_sec"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:inputType="textPhonetic"
        android:singleLine="true"
        android:hint="比如：1398547"
    />
    <Button android:id="@+id/query_btn"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="right"
        android:text="查询"
    />
    <TextView android:id="@+id/result_text"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center_horizontal|center_vertical"
    />
</LinearLayout>  

3）编写MainActivity类

/**
 * Android平台调用WebService（手机号码归属地查询）
 *
 */
public class MainActivity extends Activity {
    private EditText phoneSecEditText;
    private TextView resultView;
    private Button queryButton;  

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);  

 // 强制在UI线程中操作
           StrictMode.setThreadPolicy(newStrictMode.ThreadPolicy.Builder()
       .detectDiskReads().detectDiskWrites().detectNetwork()
        .penaltyLog().build());

        StrictMode.setVmPolicy(newStrictMode.VmPolicy.Builder()
       .detectLeakedSqlLiteObjects().penaltyLog().penaltyDeath()
        .build());

        phoneSecEditText = (EditText) findViewById(R.id.phone_sec);
        resultView = (TextView) findViewById(R.id.result_text);
        queryButton = (Button) findViewById(R.id.query_btn);  

        queryButton.setOnClickListener(new OnClickListener() {
            @Override
            public void onClick(View v) {
                // 手机号码（段）
                String phoneSec = phoneSecEditText.getText().toString().trim();
                // 简单推断用户输入的手机号码（段）是否合法
                if ("".equals(phoneSec) || phoneSec.length() < 7) {
                    // 给出错误提示
                    phoneSecEditText.setError("您输入的手机号码（段）有误！");
                    phoneSecEditText.requestFocus();
                    // 将显示查询结果的TextView清空
                    resultView.setText("");
                    return;
                }
                // 查询手机号码（段）信息
                getRemoteInfo(phoneSec);
            }
        });
    }  

    /**
     * 手机号段归属地查询
     *
     * @param phoneSec 手机号段
     */
    public void getRemoteInfo(String phoneSec) {
        // 命名空间
        String nameSpace = "http://WebXml.com.cn/";
        // 调用的方法名称
        String methodName = "getMobileCodeInfo";
        // EndPoint
        String endPoint = "http://webservice.webxml.com.cn/WebServices/MobileCodeWS.asmx";
        // SOAP Action
        String soapAction = "http://WebXml.com.cn/getMobileCodeInfo";  

        // 指定WebService的命名空间和调用的方法名
        SoapObject rpc = new SoapObject(nameSpace, methodName);  

        // 设置需调用WebService接口须要传入的两个參数mobileCode、userId
        rpc.addProperty("mobileCode", phoneSec);
        rpc.addProperty("userId", "");  

        // 生成调用WebService方法的SOAP请求信息,并指定SOAP的版本号
        SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER10);  

        envelope.bodyOut = rpc;
        // 设置是否调用的是dotNet开发的WebService
        envelope.dotNet = true;
        // 等价于envelope.bodyOut = rpc;
        envelope.setOutputSoapObject(rpc);  

        HttpTransportSE transport = new HttpTransportSE(endPoint);
        try {
            // 调用WebService
            transport.call(soapAction, envelope);
        } catch (Exception e) {
            e.printStackTrace();
        }  

        // 获取返回的数据
        SoapObject object = (SoapObject) envelope.bodyIn;
        // 获取返回的结果
        String result = object.getProperty(0).toString();  

        // 将WebService返回的结果显示在TextView中
        resultView.setText(result);
    }
}  

注意点1：nameSpace、methodName 、EndPoint和SOAP
Action
信息，都能够在WSDL中得到。

注意点2：调用WebService接口方法须要传入的參数时，參数名称要和WSDL中描写叙述的一致。（网上有些资料说在须要传入多个參数时，仅仅要多个參数的顺序与WSDL中參数出现的顺序一致就可以，名称并不须要和WSDL中的一致，但实际測试发现，大多数情况下并不可行！）

注意点3： 本例中调用WebService后返回的结果例如以下所看到的：

<?xml version="1.0"encoding="utf-8"?>

<string xmlns="http://WebXml.com.cn/">1398547：贵州贵阳贵州移动黔中游卡</string>

这里明明返回的是xml格式的内容，为什么我们不须要通过解析xml来获取我们须要的内容呢？事实上：

//获取返回的数据

SoapObject object = (SoapObject) envelope.bodyIn;

ksoap2可以将返回的xml转换成SoapObject对象，然后我们就行通过操作对象的方式来获取须要的数据了。

注意点4：本例中仅仅返回了一个值，但有些WebService会返回多个值该怎么获取？获取方法与本例全然一样，仅仅是须要注意的是假设是返回多个值，通过第100代码object.getProperty(0);得到的可能仍然是一个SoapObject。不断地调用getProperty()方法；总能得到你想要的所有结果。

4）在AndroidManifest.xml中配置加入訪问网络的权限

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="com.liufeng.ws.activity"
      android:versionCode="1"
      android:versionName="1.0">
    <application android:icon="@drawable/icon" android:label="@string/app_name">
        <activity android:name=".MainActivity" android:label="@string/app_name">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>  

    <uses-sdk android:minSdkVersion="4" />  

    <!-- 訪问网络的权限 -->
    <uses-permission android:name="android.permission.INTERNET" />
</manifest>  

5）执行结果

源代码下载

http://download.csdn.net/detail/tcl_6666/7365311