android 使用Ksoap2工具類實現WebService網絡編程

1.下載Ksoap2，將jar包拷貝到libs目錄下。而後右鍵點擊拷貝進來的jar，在彈出菜單中點擊Add As Library.

2.在AndroidManifest.xml中添加訪問網絡的權限

<uses-permission android:name="android.permission.INTERNET"/>

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.company.webservicedemo">
    <uses-permission android:name="android.permission.INTERNET"/>
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity
            android:name=".MainActivity"
            android:label="@string/app_name"
            android:theme="@style/AppTheme.NoActionBar">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

3.簡單實現的佈局

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    app:layout_behavior="@string/appbar_scrolling_view_behavior"
    tools:context="com.company.webservicedemo.MainActivity"
    tools:showIn="@layout/activity_main">
    <EditText
        android:id="@+id/orgCode_txt"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="請輸入要查詢的組織編碼" />
    <Button
        android:id="@+id/get_btn"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="獲取組織信息" />
    <TextView
        android:id="@+id/show_txt"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />
</LinearLayout>

4.本身實現的一個簡單的接口。

5.點擊獲取按鈕，調用接口，將返回的結果顯示在TextView空間中。

package com.company.webservicedemo;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.TextView;

public class MainActivity extends AppCompatActivity {

    Button button;
    TextView textView;
    EditText orgCodeTxt;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        button = (Button) findViewById(R.id.get_btn);
        textView = (TextView) findViewById(R.id.show_txt);
        orgCodeTxt = (EditText) findViewById(R.id.orgCode_txt);

        button.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                WebServiceUtils.getOrgInfo(orgCodeTxt.getText().toString(), new WebServiceUtils.CallBack() {
                    @Override
                    public void result(String result) {
                        textView.setText(result);
                    }
                });
            }
        });
    }
}

6.調用WebService接口的具體實現，UI主線程中不能直接進行網絡通訊，須要在子線程中完成。返回的信息是在子線程中，須要利用Handler來實現子線程與主線程信息的傳遞。

package com.company.webservicedemo;
import android.os.Handler;
import android.os.Message;
import org.ksoap2.SoapEnvelope;
import org.ksoap2.SoapFault;
import org.ksoap2.serialization.SoapObject;
import org.ksoap2.serialization.SoapSerializationEnvelope;
import org.ksoap2.transport.HttpTransportSE;

public class WebServiceUtils {
    public interface CallBack {
        void result(String result);
    }
    public static void getOrgInfo(final String orgCode, final CallBack callBack) {
        // 用於子線程與主線程通訊的Handler
        final Handler mHandler = new Handler() {
            @Override
            public void handleMessage(Message msg) {
                super.handleMessage(msg);
                // 將返回值回調到callBack的參數中
                callBack.result((String) msg.obj);
            }
        };
        new Thread(new Runnable() {
            @Override
            public void run() {
                // 命名空間
                String nameSpace = "http://tempuri.org/";
                // 調用的方法名稱
                String methodName = "GetOrgInfo";
                // EndPoint
                String endPoint = "http://192.168.1.12:8037/IWMSService.asmx?wsdl";
                // SOAP Action
                final String soapAction = "http://tempuri.org/GetOrgInfo";//nameSpace+methodName
                // 創建webservice鏈接對象
                final HttpTransportSE transport = new HttpTransportSE(endPoint);
                //transport.debug = true;// 是不是調試模式
                // 設置鏈接參數
                SoapObject soapObject = new SoapObject(nameSpace, methodName);
                soapObject.addProperty("orgCode", orgCode);
                // 設置返回參數
                final SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(
                        SoapEnvelope.VER11);// soap協議版本必須用SoapEnvelope.VER11（Soap V1.1）
                envelope.dotNet = true;// 注意：這個屬性是對dotnetwebservice協議的支持,若是dotnet的webservice須要設置成true
                envelope.bodyOut = soapObject;//千萬注意！！
                envelope.setOutputSoapObject(soapObject);// 設置請求參數
                try {
                    transport.call(soapAction, envelope);// 調用WebService
                } catch (Exception e) {
                    mHandler.sendMessage(mHandler.obtainMessage(-1, e.getMessage()));
                }
                if (envelope.bodyIn instanceof SoapFault) {
                    SoapFault error = (SoapFault) envelope.bodyIn;
                    // 將異常的消息利用Handler發送到主線程
                    mHandler.sendMessage(mHandler.obtainMessage(0, error.toString()));
                } else {
                    SoapObject object = (SoapObject) envelope.bodyIn;// 獲取返回的數據
                    // 將結果利用Handler發送到主線程
                    mHandler.sendMessage(mHandler.obtainMessage(1, object.getProperty(0).toString()));
                }
            }
        }).start();
    }
}