安卓訪問webAPI，並取回資料

標籤：

前言

　　安卓自從4.0以後，所有的網路訪問都需要非同步進程操作。其內建的非同步類有AsyncTask，Handler，以及可以聲明Thread等等。涉及到多進程，必須要提到一個問題，線程與線程之間不能直接進行資料的交流，UI線程的資料是受到保護的，不能執行在UI線程上的操作都需要藉助其他手段進行資料的傳輸，本文用的是Handler的sendMessage的方式。

本文

　　本文所用涉及Hander和Thread，首先介紹一下Hander。

　　Handler， 它直接繼承自Object，一個Handler允許發送和處理Message或者Runnable對象，並且會關聯到主線程的MessageQueue 中。每個Handler具有一個單獨的線程，並且關聯到一個訊息佇列的線程，就是說一個Handler有一個固有的訊息佇列。當執行個體化一個Handler 的時候，它就承載在一個線程和訊息佇列的線程，這個Handler可以把Message或Runnable壓入到訊息佇列，並且從訊息佇列中取出 Message或Runnable，進而操作它們。

　　Handler主要有兩個作用：

• 在背景工作執行緒中發送訊息。
• 在UI線程中擷取、處理訊息。

　　上面介紹到Handler可以把一個Message對象或者Runnable對象壓入到訊息佇列中，進而在UI線程中擷取Message或者執行Runnable對象，所以Handler把壓入訊息佇列有兩大體系，Post和sendMessage：

• Post：Post允許把一個Runnable對象入隊到訊息佇列中。它的方法有：post(Runnable)、postAtTime(Runnable,long)、postDelayed(Runnable,long)。
• sendMessage：sendMessage允許把一個包含訊息資料的Message對象壓入到訊息佇列中。它的方法 有：sendEmptyMessage(int)、sendMessage(Message)、 sendMessageAtTime(Message,long)、sendMessageDelayed(Message,long)。

　　從上面的各種方法可以看出，不管是post還是sendMessage都具有多種方法，它們可以設定Runnable對象和Message對象被入隊到訊息佇列中，是立即執行還是順延強制。

　　

Post

　　對於Handler的Post方式來說，它會傳遞一個Runnable對象到訊息佇列中，在這個Runnable對象中，重寫run()方法。一般在這個run()方法中寫入需要在UI線程上的操作。

　　在Handler中，關於Post方式的方法有：

• boolean post(Runnable r)：把一個Runnable入隊到訊息佇列中，UI線程從訊息佇列中取出這個對象後，立即執行。
• boolean postAtTime(Runnable r,long uptimeMillis)：把一個Runnable入隊到訊息佇列中，UI線程從訊息佇列中取出這個對象後，在特定的時間執行。
• boolean postDelayed(Runnable r,long delayMillis)：把一個Runnable入隊到訊息佇列中，UI線程從訊息佇列中取出這個對象後，延遲delayMills秒執行
• void removeCallbacks(Runnable r)：從訊息佇列中移除一個Runnable對象。

 　　下面通過一個Demo，講解如何通過Handler的post方式在新啟動的線程中修改UI組件的屬性：

package com.bgxt.datatimepickerdemo;import android.app.Activity;import android.os.Bundle;import android.os.Handler;import android.view.View;import android.widget.Button;import android.widget.TextView;public class HandlerPostActivity1 extends Activity {    private Button btnMes1,btnMes2;    private TextView tvMessage;    // 聲明一個Handler對象    private static Handler handler=new Handler();        @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.message_activity);                        btnMes1=(Button)findViewById(R.id.btnMes1);        btnMes2=(Button)findViewById(R.id.btnMes2);        tvMessage=(TextView)findViewById(R.id.tvMessage);        btnMes1.setOnClickListener(new View.OnClickListener() {                        @Override            public void onClick(View v) {                // 新啟動一個子線程                new Thread(new Runnable() {                                        @Override                    public void run() {                        // tvMessage.setText("...");                        // 以上操作會報錯，無法再子線程中訪問UI組件，UI組件的屬性必須在UI線程中訪問                        // 使用post方式修改UI組件tvMessage的Text屬性                        handler.post(new Runnable() {                                                @Override                            public void run() {                                tvMessage.setText("使用Handler.post在背景工作執行緒中發送一段執行到訊息佇列中，在主線程中執行。");                                                    }                        });                                                    }                }).start();            }        });                btnMes2.setOnClickListener(new View.OnClickListener() {                        @Override            public void onClick(View v) {                new Thread(new Runnable() {                                        @Override                    public void run() {                        // 使用postDelayed方式修改UI組件tvMessage的Text屬性值                        // 並且延遲3S執行                        handler.postDelayed(new Runnable() {                                                        @Override                            public void run() {                                tvMessage.setText("使用Handler.postDelayed在背景工作執行緒中發送一段執行到訊息佇列中，在主線程中延遲3S執行。");                                                                }                        }, 3000);                                            }                }).start();                            }        });    }}

 

效果展示：

　　有一點值得注意的是，對於Post方式而言，它其中Runnable對象的run()方法的代碼，均執行在UI線程上，所以對於這段代碼而言， 不能執行在UI線程上的操作，一樣無法使用post方式執行。

Message

　　Handler如果使用sendMessage的方式把訊息入隊到訊息佇列中，需要傳遞一個Message對象，而在Handler中，需要重 寫handleMessage()方法，用於擷取背景工作執行緒傳遞過來的訊息，此方法運行在UI線程上。下面先介紹一下Message。

　　Message是一個final類，所以不可被繼承。Message封裝了線程中傳遞的訊息，如果對於一般的資料，Message提供了getData()和setData()方法來擷取與設定資料，其中操作的資料是一個Bundle對 象，這個Bundle對象提供一系列的getXxx()和setXxx()方法用於傳遞基礎資料型別 (Elementary Data Type)的索引值對，對於基礎資料型別 (Elementary Data Type)，使用起來很簡單，這裡不 再詳細講解。而對於複雜的資料類型，如一個對象的傳遞就要相對複雜一些。在Bundle中提供了兩個方法，專門用來傳遞對象的，但是這兩個方法也有相應的 限制，需要實現特定的介面，當然，一些Android內建的類，其實已經實現了這兩個介面中的某一個，可以直接使用。方法如下：

• putParcelable(String key,Parcelable value)：需要傳遞的對象類實現Parcelable介面。
• pubSerializable(String key,Serializable value)：需要傳遞的對象類實現Serializable介面。

　　還有另外一種方式在Message中傳遞對象，那就是使用Message內建的obj屬性傳值，它是一個Object類型，所以可以傳遞任意類型的對象，Message內建的有如下幾個屬性：

• int arg1：參數一，用於傳遞不複雜的資料，複雜資料使用setData()傳遞。
• int arg2：參數二，用於傳遞不複雜的資料，複雜資料使用setData()傳遞。
• Object obj：傳遞一個任意的對象。
• int what：定義的訊息碼，一般用於設定訊息的標誌。

 　　對於Message對象，一般並不推薦直接使用它的構造方法得到，而是建議通過使用Message.obtain()這個靜態方法或者 Handler.obtainMessage()擷取。Message.obtain()會從訊息池中擷取一個Message對象，如果訊息池中是空的， 才會使用構造方法執行個體化一個新Message，這樣有利於訊息資源的利用。並不需要擔心訊息池中的訊息過多，它是有上限的，上限為10個。 Handler.obtainMessage()具有多個重載方法，如果查看源碼，會發現其實Handler.obtainMessage()在內部也是 調用的Message.obtain()。　　

　　既然Message是線上程間傳遞訊息，那麼先以一個Demo講解一下Message的使用，還是常規的從互連網上接受WEBAPI返回的資料，下載後使用listview控制項展示：

package com.example.myrixin;import java.util.ArrayList;import java.util.HashMap;import java.util.List;import java.util.Map;import org.apache.http.HttpResponse;import org.apache.http.client.HttpClient;import org.apache.http.client.methods.HttpGet;import org.apache.http.impl.client.DefaultHttpClient;import org.apache.http.util.EntityUtils;import org.json.JSONArray;import org.json.JSONException;import org.json.JSONObject;import android.os.Bundle;import android.os.Handler;import android.os.Message;import android.app.Activity;import android.app.ProgressDialog;import android.content.Intent;import android.util.Log;import android.view.Menu;import android.view.View;import android.widget.AbsListView;import android.widget.AbsListView.OnScrollListener;import android.widget.AdapterView;import android.widget.AdapterView.OnItemClickListener;import android.widget.ArrayAdapter;import android.widget.ListView;import android.widget.Toast;public class MainActivity extends Activity implements OnItemClickListener, OnScrollListener {public ListView listView;private static int IS_FINISH = 1;private ProgressDialog dialog;private static String url="http://10.185.210.173:8008/api/products";private ArrayAdapter<List<Map<String, String>>>arr_adapter;    @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.activity_main);                //執行個體化listView        listView=(ListView) findViewById(R.id.sjlb);                dialog = new ProgressDialog(this);        dialog.setTitle("提示資訊");        dialog.setMessage("正在下載，請稍後...");        dialog.setCancelable(false);                new Thread(new MyThread()).start();dialog.show();        ////適配器//arr_adapter=new ArrayAdapter(null, 0, list);////加入listview//listView.setAdapter(arr_adapter);listView.setOnItemClickListener(this);//單個條目點擊的監聽器        listView.setOnScrollListener(this);//滾動變化的監聽器            }    private Handler handler = new Handler() {Map<String, String> map = null;List<Map<String, String>> list = new ArrayList<Map<String, String>>();// 在Handler中擷取訊息，重寫handleMessage()方法@Overridepublic void handleMessage(Message msg) {// 判斷訊息碼是否為1if (msg.what == IS_FINISH) {//text.setText(msg.toString);list = jx(msg.toString());//try {////截取API返回的資料   Message傳過來的資料加了首尾資訊文//int begin=msg.toString().indexOf("[");//int end=msg.toString().indexOf("]");//String request=msg.toString().substring(begin, end+1);////JSONArray jsonArray = new JSONArray(request);//for (int i = 0; i < jsonArray.length(); i++) {//JSONObject item = jsonArray.getJSONObject(i); // 每條記錄又由幾個Object對象組成//int id = item.getInt("Id"); // 擷取對象對應的值{"Id":1,"Name":"Tomato Soup","Category":"Groceries","Price":1.0}//String name = item.getString("Name");//String categroy=item.getString("Category");//String price = item.getString("Price");////map = new HashMap<String, String>(); // 存放到MAP裡面//map.put("id", id + "");//map.put("name", name);//map.put("Category", categroy);//map.put("Price", price);//list.add(map);//}//for (Map<String, String> list2 : list) {//String id = list2.get("id");//String name = list2.get("name");//Log.i("info", "id:" + id + " | name:" + name);//}//} catch (JSONException e) {//// TODO Auto-generated catch block//e.printStackTrace();//}//適配器arr_adapter=new ArrayAdapter(MainActivity.this, android.R.layout.simple_expandable_list_item_1, list);//加入listviewlistView.setAdapter(arr_adapter);dialog.dismiss();}}};public class MyThread implements Runnable {@Overridepublic void run() {HttpClient httpClient = new DefaultHttpClient();HttpGet httpGet = new HttpGet(url);HttpResponse httpResponse = null;try {httpResponse = httpClient.execute(httpGet);if (httpResponse.getStatusLine().getStatusCode() == 200) { String temp = EntityUtils.toString(httpResponse.getEntity());// 擷取一個Message對象，設定what為1Message msg = Message.obtain();msg.obj = temp;msg.what = IS_FINISH;// 發送這個訊息到訊息佇列中handler.sendMessage(msg);}} catch (Exception e) {e.printStackTrace();}}}/* * 解析json資料 */public List<Map<String, String>> jx(String msg){Map<String, String> map = null;List<Map<String, String>> list = new ArrayList<Map<String, String>>();try {//截取API返回的資料   Message傳過來的資料加了首尾資訊文int begin=msg.toString().indexOf("[");int end=msg.toString().indexOf("]");String request=msg.toString().substring(begin, end+1);JSONArray jsonArray = new JSONArray(request);for (int i = 0; i < jsonArray.length(); i++) {JSONObject item = jsonArray.getJSONObject(i); // 每條記錄又由幾個Object對象組成int id = item.getInt("Id"); // 擷取對象對應的值{"Id":1,"Name":"Tomato Soup","Category":"Groceries","Price":1.0}String name = item.getString("Name");String categroy=item.getString("Category");String price = item.getString("Price");map = new HashMap<String, String>(); // 存放到MAP裡面map.put("id", id + "");map.put("name", name);map.put("Category", categroy);map.put("Price", price);list.add(map);}for (Map<String, String> list2 : list) {String id = list2.get("id");String name = list2.get("name");Log.i("info", "id:" + id + " | name:" + name);}} catch (JSONException e) {// TODO Auto-generated catch blocke.printStackTrace();}return list;}    /* * 自訂功能表列 * @see android.app.Activity#onCreateOptionsMenu(android.view.Menu) */    @Override    public boolean onCreateOptionsMenu(Menu menu) {        // Inflate the menu; this adds items to the action bar if it is present.        getMenuInflater().inflate(R.menu.main, menu);        return true;    }    }

 xml中的內容

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"    xmlns:tools="http://schemas.android.com/tools"    android:layout_width="match_parent"    android:layout_height="match_parent"    android:paddingBottom="@dimen/activity_vertical_margin"    android:paddingLeft="@dimen/activity_horizontal_margin"    android:paddingRight="@dimen/activity_horizontal_margin"    android:paddingTop="@dimen/activity_vertical_margin"    tools:context=".MainActivity" >    <ListView        android:id="@+id/sjlb"        android:layout_width="match_parent"        android:layout_height="wrap_content"        android:layout_centerHorizontal="true"        android:layout_centerVertical="true" >    </ListView></RelativeLayout>

 運行：

　　Message.obtain()方法具有多個重載方法，大致可以分為為兩類，一類是無需傳遞Handler對象，對於這類的方法，當填充好消 息後，需要調用Handler.sendMessage()方法來發送訊息到訊息佇列中。第二類需要傳遞一個Handler對象，這類方法可以直接使用 Message.sendToTarget()方法發送訊息到訊息佇列中，這是因為在Message對象中有一個私人的Handler類型的屬性 Target，當時obtain方法傳遞進一個Handler對象的時候，會給Target屬性賦值，當調用sendToTarget()方法的時候，實 際在它內部還是調用的Target.sendMessage()方法。

　　在Handler中，也定義了一些發送空訊息的方法，如：sendEmptyMessage(int what)、sendEmptyMessageDelayed(int what,long delayMillis)，看似這些方法沒有使用Message就可以發送一個訊息，但是如果查看源碼就會發現，其實內部也是從 Message.obtain()方法中擷取一個Message對象，然後給屬性賦值，最後使用sendMessage()發送訊息到訊息佇列中。

　　Handler中，與Message發送訊息相關的方法有：

• Message obtainMessage()：擷取一個Message對象。
• boolean sendMessage()：發送一個Message對象到訊息佇列中，並在UI線程取到訊息後，立即執行。
• boolean sendMessageDelayed()：發送一個Message對象到訊息佇列中，在UI線程取到訊息後，順延強制。
• boolean sendEmptyMessage(int what)：發送一個空的Message對象到隊列中，並在UI線程取到訊息後，立即執行。
• boolean sendEmptyMessageDelayed(int what,long delayMillis)：發送一個空Message對象到訊息佇列中，在UI線程取到訊息後，順延強制。
• void removeMessage()：從訊息佇列中移除一個未響應的訊息。

對Message感興趣的可以參考：http://www.cnblogs.com/shirley-1019/p/3557800.html

本文的很多知識都是參考的次博文，我只對自己需要的部分做了修改

 

安卓訪問webAPI，並取回資料