本節の導入:

これまでの学習で、データリクエスト、データ解析、ファイルのアップロード/ダウンロードなど、サーバーとやりとりする基本的なニーズは満たせるはずです。そして本節では、Android で WebService を呼び出す方法を紹介します。実はこれ、生のデータ API サービスを提供するデータプラットフォーム(例えば「聚合数据」のようなもの)に少し似ています。WebService は XML と SOAP を使用し、HTTP プロトコルを介してリモートマシンとのやりとりを完了できます。では、あまり多くは語らずに、本節の内容を始めましょう〜


1.WebService の概要

PS:上記の概要を読んでもまだよくわからない場合は、それで構いません。以前の会社では C# で WebService を構築していました!本節では WebService の構築方法については説明しません。WebService が提供するサービスを取得し、返された XML データを解析して、関連するデータを Android デバイスに表示する方法だけを理解すれば十分です!


2.WebService サービスはどこで取得するか

インターネットには WebService を提供するサイトがたくさんあります。まずそれらのサイトを見つけて、対応するサービスを取得すればよいのです!ここでは例として WebXml と云聚36wu を取り上げて説明します。それぞれの公式サイト:

webXml:http://www.webxml.com.cn/zh_cn/index.aspx

以前は無料でしたが、商業化されており、多くのサービスは有料ですが、試用は可能です〜 このサイトでは16個の異なる Web サービスが提供されており、自分のニーズに応じてサービスを検索し、さまざまなインターフェースを呼び出すことができます!

webXml の関連ページ:

関連する利用回数の説明:

云聚36wu:http://www.36wu.com/Service

同様に多くのサービスを提供しており、多くのスマホアプリはここの API を使用しています。例えば「彩虹公交」や「手机天气」などです。ただし、これも有料です=-=。試用は可能ですが、1時間に20回しかリクエストを送信できません。使用を申請して key を取得すればOKです!どちらでも好きな方を選んでください!


3.サードパーティ jar パッケージの準備

まず、Android プラットフォームで WebService を呼び出すには、サードパーティのライブラリ ksoap2 に依存する必要があります。Android プラットフォームでは、高効率で軽量な SOAP 開発パッケージである ksoap2 Android を使用します。

jar パッケージのダウンロードアドレス:https://code.google.com/p/ksoap2-android/wiki/HowToUse?tm=2

中国からはアクセスできないかもしれません。ここではダウンロード用に百度云のリンクを2つ提供します:

2.54 バージョン:

3.30 バージョン:

幸運にも jar パッケージのダウンロードアドレスに入れたなら、以下の画面が表示されるでしょう:


4.関連するパラメータの取得

まず、取得する必要があるサービスを見つけて、関連するパラメータを記録します:NameSpace(ネームスペース)、およびSoapActionは言うまでもなく、他のパラメータは次のように探します:URL例えば、ここでは天気の照会パラメータを探しています。クリックすると、このようなパラメータドキュメントが表示されます:

例えば、ここで必要なのは天気照会部分の機能です:

まず、四角で囲んだ SoapAction と NameSpace をコピーしましょう!もちろん、このページでテストすることもできます。また、無料ユーザーなので、id は入力しなくてもスキップできます。入力後に「呼び出し」ボタンをクリックすると、次のようなページが開きます:

へへ、ここが返される XML です。私たちが行うのはこのような XML を解析することです。また、ここの .gif は天気アイコンを表しています!

同様に、番号の所属地域照会についても、SoapAction、NameSpace、および関連パラメータをマークしておきましょう!

および返された後の XML データ

5.関連する WEB サービスの登録と有効化:


5.関連する WEB サービスの登録と有効化

はい、自分の key をマークしておくことを忘れないでくださいね〜

6.WebService を呼び出すコード例


6.WebService を呼び出すコード例

実行結果図

PS:この番号は以前の番号です=-=。かけないでください。もう別人に変わっています〜 また、天気サービスにはいくつか問題があるようで、取得できないことがあります。おそらく WebXml による制限でしょう。何せ試用ですから...:

実装コード

また、パッケージのインポートと Internet 権限を忘れないでください!:

public class MainActivity extends AppCompatActivity implements View.OnClickListener {

    private EditText edit_param;
    private Button btn_attribution;
    private Button btn_weather;
    private TextView txt_result;

    private String city;
    private String number;
    private String result;


    //定义获取手机信息的SoapAction与命名空间,作为常量
    private static final String AddressnameSpace = "http://WebXml.com.cn/";
    //天气查询相关参数
    private static final String Weatherurl = "http://webservice.webxml.com.cn/WebServices/WeatherWS.asmx";
    private static final String Weathermethod = "getWeather";
    private static final String WeathersoapAction = "http://WebXml.com.cn/getWeather";
    //归属地查询相关参数
    private static final String Addressurl = "http://webservice.webxml.com.cn/WebServices/MobileCodeWS.asmx";
    private static final String Addressmethod = "getMobileCodeInfo";
    private static final String AddresssoapAction = "http://WebXml.com.cn/getMobileCodeInfo";


    //定义一个Handler用来更新页面:
    private Handler handler = new Handler() {
        public void handleMessage(Message msg) {
            switch (msg.what) {
                case 0x001:
                    txt_result.setText("结果显示:\n" + result);
                    Toast.makeText(MainActivity.this, "获取天气信息成功", Toast.LENGTH_SHORT).show();
                    break;
                case 0x002:
                    txt_result.setText("结果显示:\n" + result);
                    Toast.makeText(MainActivity.this, "号码归属地查询成功", Toast.LENGTH_SHORT).show();
                    break;
            }

        }
    };

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        bindViews();
    }

    private void bindViews() {
        edit_param = (EditText) findViewById(R.id.edit_param);
        btn_attribution = (Button) findViewById(R.id.btn_attribution);
        btn_weather = (Button) findViewById(R.id.btn_weather);
        txt_result = (TextView) findViewById(R.id.txt_result);
        btn_attribution.setOnClickListener(this);
        btn_weather.setOnClickListener(this);
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()) {
            case R.id.btn_weather:
                new Thread() {
                    @Override
                    public void run() {
                        getWether();
                    }
                }.start();
                break;
            case R.id.btn_attribution:
                new Thread(new Runnable() {
                    public void run() {
                        getland();
                    }
                }).start();
                break;
        }
    }


    //定义一个获取某城市天气信息的方法:
    public void getWether() {
        result = "";
        SoapObject soapObject = new SoapObject(AddressnameSpace, Weathermethod);
        soapObject.addProperty("theCityCode:", edit_param.getText().toString());
        soapObject.addProperty("theUserID", "dbdf1580476240458784992289892b87");
        SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER11);
        envelope.bodyOut = soapObject;
        envelope.dotNet = true;
        envelope.setOutputSoapObject(soapObject);
        HttpTransportSE httpTransportSE = new HttpTransportSE(Weatherurl);
        System.out.println("天气服务设置完毕,准备开启服务");
        try {
            httpTransportSE.call(WeathersoapAction, envelope);
//            System.out.println("调用WebService服务成功");
        } catch (Exception e) {
            e.printStackTrace();
//            System.out.println("调用WebService服务失败");
        }

        //获得服务返回的数据,并且开始解析
        SoapObject object = (SoapObject) envelope.bodyIn;
        System.out.println("获得服务数据");
        result = object.getProperty(1).toString();
        handler.sendEmptyMessage(0x001);
        System.out.println("发送完毕,textview显示天气信息");
    }


    //定义一个获取号码归属地的方法:
    public void getland() {
        result = "";
        SoapObject soapObject = new SoapObject(AddressnameSpace, Addressmethod);
        soapObject.addProperty("mobileCode", edit_param.getText().toString());
        soapObject.addProperty("userid", "dbdf1580476240458784992289892b87");
        SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER11);
        envelope.bodyOut = soapObject;
        envelope.dotNet = true;
        envelope.setOutputSoapObject(soapObject);
        HttpTransportSE httpTransportSE = new HttpTransportSE(Addressurl);
        //    System.out.println("号码信息设置完毕,准备开启服务");
        try {
            httpTransportSE.call(AddresssoapAction, envelope);
            //System.out.println("调用WebService服务成功");
        } catch (Exception e) {
            e.printStackTrace();
            //System.out.println("调用WebService服务失败");
        }

        //获得服务返回的数据,并且开始解析
        SoapObject object = (SoapObject) envelope.bodyIn;//System.out.println("获得服务数据");
        result = object.getProperty(0).toString();//System.out.println("获取信息完毕,向主线程发信息");
        handler.sendEmptyMessage(0x001);
        //System.out.println("发送完毕,textview显示天气信息");
    }


}

参考コードのダウンロード:

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

参考コードのダウンロード:

WebServiceDemo.zip:本節のまとめ:


本節のまとめ:

7.3.3 Android ファイルダウンロード(2)