Android 如何使用 GET & POST 取得資料

Get & Post

對於寫網頁程式的人來說應該是不陌生，在網頁表單中，要送出資料時就會選擇要用Get的方式還是Post的方式。常見的Get方式是在網址後面加上查詢字串，像是

http://www.myweb.com/product?p=1&a=1&b=2

之類的，第一個用問號(?)，之後每個都用(&)。

在Android中一樣可以用Get及Post去取得伺服器給予的資料。

在 Android 中使用 Get 及 Post 的幾個提示

• 使用 org.apache.http 套件(也可以用別的)
• Androidmanifest.xml 中要加入存取網路的授權
• 清楚知道要使用 Get 還是 Post
• 如果抓網路資料時間太久，建議把它放到背景執行並加上 Loading 提示

Get 的使用步驟

首先你要建立一個 HttpClient 物件：

HttpClient client = new DefaultHttpClient();

接著建立 HttpGet 物件並傳入網址：

HttpGet get = new HttpGet(_url);

當 HttpClient 執行 Get 任務後，會傳回 HttpResponse：

HttpResponse response = client.execute(get);

接下來就可以取得資料實體：

HttpEntity resEntity = response.getEntity();

你可以把它轉成字串來使用：

result = EntityUtils.toString(resEntity);

以上就是Get的基本操作。

Post 的使用步驟

一樣先建立 HttpClient 物件：

HttpClient client = new DefaultHttpClient();

接著建立 HttpPost 物件並傳入網址：

HttpPost post = new HttpPost(_url);

如果有參數的話，可以這樣加入：

List<NameValuePair> params = new ArrayList<NameValuePair>();
params.add(new BasicNameValuePair(_queryKey, _queryValue));
UrlEncodedFormEntity ent = new UrlEncodedFormEntity(params, HTTP.UTF_8);
post.setEntity(ent);

執行後一樣會傳回 HttpResponse：

HttpResponse responsePOST = client.execute(post);

取得資料實體後可以轉成字串來用：

HttpEntity resEntity = responsePOST.getEntity();
result = EntityUtils.toString(resEntity);

以上是 Post 的操作方式。在參數的部份，接下來的範例只能加入一對(key-value)，若有需要多組參數的話，要改成陣列的方式。

範例程式碼

package com.tonycube.demo;

import java.util.ArrayList;
import java.util.List;

import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.NameValuePair;
import org.apache.http.client.HttpClient;
import org.apache.http.client.entity.UrlEncodedFormEntity;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.impl.client.DefaultHttpClient;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.protocol.HTTP;
import org.apache.http.util.EntityUtils;

import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.TextView;

public class GetPostDemoActivity extends Activity {
    
    private TextView txtResult = null;
    private Button btnLoad = null;
    
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        
        initView();
    }
    
    
    private void loadPage() {
        String html = getHtmlByGet("http://zh.wikipedia.org/wiki/Wiki");
        txtResult.setText(html);
    }


    private void initView() {
        txtResult = (TextView) findViewById(R.id.txtResult);
        btnLoad = (Button) findViewById(R.id.btnLoad);
        btnLoad.setOnClickListener(new OnClickListener(){

            @Override
            public void onClick(View v) {
                loadPage();
            }
            
        });
    }




    public String getHtmlByPost(String _url, String _queryKey, String _queryValue){    
        
        String result = "";
        
        try {
            HttpClient client = new DefaultHttpClient();
                        
            HttpPost post = new HttpPost(_url);
            
            //參數
            if (_queryKey != ""){
                List<NameValuePair> params = new ArrayList<NameValuePair>();
                params.add(new BasicNameValuePair(_queryKey, _queryValue));
                UrlEncodedFormEntity ent = new UrlEncodedFormEntity(params, HTTP.UTF_8);
                post.setEntity(ent);
            }
            
            HttpResponse responsePOST = client.execute(post); 
            
            HttpEntity resEntity = responsePOST.getEntity();
            
            if (resEntity != null) {    
                result = EntityUtils.toString(resEntity);
            }
            
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
     client.getConnectionManager().shutdown();
 }
    
            
        return result;
    }
    

    public String getHtmlByGet(String _url){    
        
        String result = "";
        
        try {
            HttpClient client = new DefaultHttpClient();
                        
            HttpGet get = new HttpGet(_url);
            
            HttpResponse response = client.execute(get); 

            HttpEntity resEntity = response.getEntity();
            
            if (resEntity != null) {    
                result = EntityUtils.toString(resEntity);
            }

        } catch (Exception e) {
            e.printStackTrace();
        } finally {
     client.getConnectionManager().shutdown();
 }
    
            
        return result;
        
    }
}

在 Androidmanifest.xml 加入網路存取權限

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

-- (2012/10/19 補充) --
在連線結束後要斷線，在 try..catch 最後增加 finally 來斷線。

finally {
   client.getConnectionManager().shutdown();
}

---

-- (2013/7/1 補充) --
Android 在 API 11 (3.0.x) 之後增加了一個 NetworkOnMainThreadException 網路在主執行緒的例外。這個例外是當程式試圖在主執行緒執行網路功能時丟出，意思就是在 SDK 3.0.x 之後的應用程式，不能把含有網路的相關功能寫在主執行緒，用意是，當執行網路功能時，例如下載資料，可能會發生不能預期的情況，導致下載時間過長，這時整個應用程式會被 HOLD 住，當超過一定時間後就會當掉閃退(ANR - Application Not Responding, 應用程式無回應)，為了避免這種情況發生，Android 就強制不能再這麼做了。

解法很簡單，就是將網路功能從主執行緒中移開，我們可以另開一條新的執行緒讓它跑，怎麼做？可以自己寫 Thread，你可以參考這篇教學，或是使用 Android 提供的非同步功能 AsyncTask，我有寫一篇教學在這，用法很簡單，建立一個內隱類別去繼承 AsyncTask，然後將含有網路功能(或可能長時間執行)的程式放在 doInBackground 方法內就好了。例如這邊就可以把 loadPage() 放進去，這樣就可以達成非同步執行，並且不會讓主執行緒被卡住。

感謝 laject 的建議。

---

-- (2013/10/10 補充2) --
StrictMode (嚴格模式) 在 API 中的說明是，只能用來測試程式的哪個部份會造成長時間的執行，所以並不能用在要發佈的程式上，只能用來測試時使用。

本文網址：http://blog.tonycube.com/2011/11/androidget-post.html
由 Tony Blog 撰寫，請勿全文複製，轉載時請註明出處及連結，謝謝 😀