Android平臺調用WebService詳解

上篇文章已經對Web Service及其相關知識進行了介紹（Android開發之WebService介紹），相信有的朋友已經忍耐不住想試試在Android應用中調用Web Service。本文將通過一個簡單的示例講解和演示Android平臺的Web Service開發。

Ksoap2-android簡介
在Android平臺調用Web Service需要依賴於第三方類庫ksoap2，它是一個SOAP Web service客戶端開發包，主要用於資源受限制的Java環境如Applets或J2ME應用程序（CLDC/ CDC/MIDP）。認真讀完對ksoap2的介紹你會發現並沒有提及它應用於Android平臺開發，沒錯，在Android平臺中我們並不會直接使用ksoap2，而是使用ksoap2 android。KSoap2 Android 是Android平臺上一個高效、輕量級的SOAP開發包，等同於Android平臺上的KSoap2的移植版本。

Ksoap2-android jar包下載
      ksoap2 android當前的最新版本爲2.5.4，名爲ksoap2-android-assembly-2.5.4-jar-with-dependencies.jar，它的下載地址是：http://code.google.com/p/ksoap2-android/，進入頁面後，點擊“Downloads”標籤頁，如下圖所示：

      在“Downloads”頁面的下方，找到如下圖所示的紫色的鏈接，然後在鏈接上點擊右鍵，找到相關下載項進行下載即可。右鍵菜單中顯示的下載項依據瀏覽器的不同而有所區別，比如我使用的360瀏覽器，在鍵接上點擊右鍵，然後選擇“使用360安全瀏覽器下載”即可彈出下載保存對話框。

Android平臺調用Web Service示例
     下面將通過一個示例講解如何在Android平臺調用Web Service。既然要調用Web Service，那就要先有Web Service。我們還是選擇使用上篇文章中介紹的查詢手機號碼歸屬地的Web service，它的WSDL爲http://webservice.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl。
1）新建Android工程，引入上面下載的ksoap2-android類庫
      Android工程的創建就不多說了，主要想說明的是如何向Android工程中添加第三方jar包。當然，添加第3方jar的方式有多種，我個人比較喜歡用下面這種方式，即先將第三方jar包拷貝到工程某個目錄下，再將其加入到工程的Build Path中。
      例如，我創建的Android工程名爲WSClient，在工程名上點擊右鍵，新建一個Folder（目錄或文件夾），名爲libs，然後將ksoap2-android類庫拷貝到libs目錄中，如下圖所示：

      接着，在jar包ksoap2-android-assembly-2.4-jar-with-dependencies.jar上點擊右鍵，依次選擇“Build Path”-“Add to Build Path”。再在工程名上點擊右鍵，依次選擇“Build Path”-“Config Build Path...”，將看到如下所示界面：

選中ksoap2 jar包前面的選項框，點擊OK，則完成了ksoap2 jar包的添加（說明：在Android工程中，添加其它jar包的方法完全一樣，操作一兩遍後，你會發現其實很簡單的）。
2）編寫佈局文件res/layout/main.xml

[html]view
plaincopy

<?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類

[java]view
plaincopy

package com.liufeng.ws.activity;  

import org.ksoap2.SoapEnvelope;  

import org.ksoap2.serialization.SoapObject;  

import org.ksoap2.serialization.SoapSerializationEnvelope;  

import org.ksoap2.transport.HttpTransportSE;  

import android.app.Activity;  

import android.os.Bundle;  

import android.view.View;  

import android.view.View.OnClickListener;  

import android.widget.Button;  

import android.widget.EditText;  

import android.widget.TextView;  

/** 

 * Android平臺調用WebService（手機號碼歸屬地查詢） 

 *  

 * @author liufeng 

 * @date 2011-05-18 

 */  

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

        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：如代碼中的62-69行所示，調用Web Service之前你需要先弄清楚這4個的值分別是什麼：命名空間、調用的方法名稱、EndPoint和SOAP Action。當在瀏覽器中訪問WSDL時，很容易得知命名空間、調用的方法名稱是什麼（不明白的請看上篇文章），至於EndPoint通常是將WSDL地址末尾的"?wsdl"去除後剩餘的部分；而SOAP Action通常爲命名空間 + 調用的方法名稱。
      注意點2：75-76行是設置調用WebService接口方法需要傳入的參數。（在WSDL中能夠看到調用方法需要傳入的參數個數及參數名稱，在設置參數時最好指明每一個傳入參數的名稱，如本例中的mobileCode、userId。網上有些資料說在需要傳入多個參數時，只要多個參數的順序與WSDL中參數出現的順序一致即可，名稱並不需要和WSDL中的一致，但實際測試發現，大多數情況下並不可行！）
      例如下面圖版上顯示的WSDL片段，調用該Web Service的checkUserInfo方法就需要傳入4個參數，參數名稱分別爲：in0、in1、in2和in3。

      注意點3：也許你會對第100行代碼產生疑惑，爲什麼要用object.getProperty("getMobileCodeInfoResult")來取得調用結果？那是因爲WSDL中明確告訴了返回結果是String數組，它的名稱爲getDatabaseInfoResult，WSDL中的描述如下：
           <s:elementminOccurs="0" maxOccurs="1" name="getDatabaseInfoResult" type="tns:ArrayOfString" />
      本例中調用WebService後返回的結果如下所示：
           <?xml version="1.0" encoding="utf-8"?>
            <string xmlns="http://WebXml.com.cn/">1398547：貴州貴陽貴州移動黔中游卡</string>
咦，這裏明明返回的是xml格式的內容，爲什麼我們不需要通過解析xml來獲取我們需要的內容呢？其實如果你仔細看代碼中的96-97行並不難發現：
            // 獲取返回的數據
            SoapObject object = (SoapObject) envelope.bodyIn;
ksoap2能夠將返回的xml轉換成SoapObject對象，然後我們就可以通過操作對象的方式來獲取需要的數據了。
      注意點4：同樣還是第100行代碼。從有些WSDL中我們並不能得知返回結果的名稱（如本例中的getMobileCodeInfoResult），那又該如何調用呢？其實上面已經暗示了這個問題：當通過第97行代碼獲取返回結果並將其轉換成SoapObject對象後，如果你並不知道通過該對象的哪個屬性來取值，你完全可以調用對象的toString()方法來查看返回的內容，例如將本例中的第100行代碼替換成：
            // 獲取返回的結果
             String result = object.toString();
這樣得到的返回結果爲：

注意看括號{}裏面的內容是一個鍵-值對形式，以等號=分隔，我們正是通過=號左邊的“getMobileCodeInfoResult”來獲取右邊的查詢結果。
      其實在不知道返回結果名稱時（如本例的100行，我們並不知道返回結果中有屬性getMobileCodeInfoResult），有一種更爲簡便的方法，直接通過索引下標來獲取屬性值，也就是將第100行代碼替換爲：
            String result = object.getProperty(0).toString();
      注意點5：本例中只返回了一個值，但有些WebService會返回多個值該怎麼獲取？獲取方法與本例完全一樣，只是需要注意的是如果是返回多個值，通過第100代碼object.getProperty(0);得到的可能仍然是一個SoapObject。不斷地調用getProperty()方法；總能得到你想要的全部結果。
      注意點6：在調用某些WebService時，可能會報一些異常，但你又發現除了調用的WebService不同之外，其它地方的寫法和我的完全一樣，這又該如何解決呢？嘗試改變第79代碼中SOAP的版本號，可以分別嘗試使用SoapEnvelope.VER10、SoapEnvelope.VER11、SoapEnvelope.VER12這樣三個值。另外，在調用某些WebService時，可能在第91行代碼中，調用WebService時並不需要傳入soapAction，將其置爲null即可。
4）在AndroidManifest.xml中配置添加訪問網絡的權限（千萬別忘記!!!）

[html]view
plaincopy

<?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）運行結果

Android平臺調用WebService詳解

android 獲取路徑目錄方法以及判斷目錄是否存在，創建目錄

Android平臺的信息推送實現

Android平臺調用WebService詳解

Bundle用法說明

ListView最後一行沒有分割線

Mac下配置sublime實現LaTeX

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結