本節の導入:
これまでの学習で、データリクエスト、データ解析、ファイルのアップロード/ダウンロードなど、サーバーとやりとりする基本的なニーズは満たせるはずです。そして本節では、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)





