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();
    }
}