Android開發之使用HTTP訪問網路資源

Android開發之使用HTTP訪問網路資源

使用HTTP訪問網路資源

前面介紹了 URLConnection己經可以非常方便地與指定網站交換資訊，URLConnection還有一個子類：HttpURLConnection，HttpURLConnection 在 LIRLConnection的基礎上做了進一步改進，增加了一些用於操作http資源的便捷方法。

1.使用HttpURLConnection

HttpURLConnection繼承了URLConnection,因此也可用於向指定網站發送GET請求 POST請求。它在URLConnection的基礎上提供了如下便捷的方法。

1) Int getResponseCode():擷取伺服器的響應代碼。

2) String getResponseMessage():擷取伺服器的響應訊息。

3) String getRequestMethod():擷取發送請求的方法。

4) void setRequestMethod(String method):設定發送請求的方法。

下面通過個實用的樣本來示範使用HttpURLConnection實現多線程下載。

1.1執行個體：多線程下載

使用多線程下載檔案可以更快地完成檔案的下載，因為用戶端啟動多個線程進行下寒意味著伺服器也需要為該用戶端提供相應的服務。假設伺服器同時最多服務100個使用者，伺服器中一條線程對應一個使用者，100條線程在電腦內並發執行，也就是由CPU劃分史 片輪流執行，如果A應用使用了 99條線程下載檔案，那麼相當於佔用了 99個使用者的資源自然就擁有了較快的下載速度。

提示：實際上並不是用戶端並發的下載線程越多，程式的下載速度就越快，因為當用戶端開啟太多的並發線程之後，應用程式需要維護每條線程的開銷、線程同步的開銷，這些開銷反而會導致下載速度降低.

1.2為了實現多線程下載，程式可按如下步驟進行：

? 建立URL對象。

? 擷取指定URL對象所指向資源的大小（由getContentLength()方法實現），此處用了 HttpURLConnection 類。

? 在本地磁碟上建立一個與網路資源相同大小的空檔案。

? 計算每條線程應該下載網路資源的哪個部分（從哪個位元組開始，到哪個位元組結束，依次建立、啟動多條線程來下載網路資源的指定部分。

1.2該程式提供的下載工具類代碼如下。

package com.jph.net;import java.io.InputStream;import java.io.RandomAccessFile;import java.net.HttpURLConnection;import java.net.URL;/** * Description: * 建立ServerSocket監聽的主類 * @author  jph * Date：2014.08.27 */public class DownUtil{/**下載資源的路徑**/ private String path;/**下載的檔案的儲存位置**/ private String targetFile;/**需要使用多少線程下載資源**/  private int threadNum;/**下載的線程對象**/  private DownThread[] threads;/**下載的檔案的總大小**/ private int fileSize;public DownUtil(String path, String targetFile, int threadNum){this.path = path;this.threadNum = threadNum;// 初始化threads數組threads = new DownThread[threadNum];this.targetFile = targetFile;}public void download() throws Exception{URL url = new URL(path);HttpURLConnection conn = (HttpURLConnection) url.openConnection();conn.setConnectTimeout(5 * 1000);conn.setRequestMethod("GET");conn.setRequestProperty("Accept","image/gif, image/jpeg, image/pjpeg, image/pjpeg, "+ "application/x-shockwave-flash, application/xaml+xml, "+ "application/vnd.ms-xpsdocument, application/x-ms-xbap, "+ "application/x-ms-application, application/vnd.ms-excel, "+ "application/vnd.ms-powerpoint, application/msword, */*");conn.setRequestProperty("Accept-Language", "zh-CN");conn.setRequestProperty("Charset", "UTF-8");conn.setRequestProperty("Connection", "Keep-Alive");// 得到檔案大小fileSize = conn.getContentLength();conn.disconnect();int currentPartSize = fileSize / threadNum + 1;RandomAccessFile file = new RandomAccessFile(targetFile, "rw");// 設定本地檔案的大小file.setLength(fileSize);file.close();for (int i = 0; i < threadNum; i++){// 計算每條線程的下載的開始位置int startPos = i * currentPartSize;// 每個線程使用一個RandomAccessFile進行下載RandomAccessFile currentPart = new RandomAccessFile(targetFile,"rw");// 定位該線程的下載位置currentPart.seek(startPos);// 建立下載線程threads[i] = new DownThread(startPos, currentPartSize,currentPart);// 啟動下載線程threads[i].start();}}// 擷取下載的完成百分比public double getCompleteRate(){// 統計多條線程已經下載的總大小int sumSize = 0;for (int i = 0; i < threadNum; i++){sumSize += threads[i].length;}// 返回已經完成的百分比return sumSize * 1.0 / fileSize;}private class DownThread extends Thread{/**當前線程的下載位置**/ private int startPos;/**定義當前線程負責下載的檔案大小**/ private int currentPartSize;/**當前線程需要下載的檔案塊**/ private RandomAccessFile currentPart;/**定義該線程已下載的位元組數**/ public int length;public DownThread(int startPos, int currentPartSize,RandomAccessFile currentPart){this.startPos = startPos;this.currentPartSize = currentPartSize;this.currentPart = currentPart;}@Overridepublic void run(){try{URL url = new URL(path);HttpURLConnection conn = (HttpURLConnection)url.openConnection();conn.setConnectTimeout(5 * 1000);conn.setRequestMethod("GET");conn.setRequestProperty("Accept","image/gif, image/jpeg, image/pjpeg, image/pjpeg, "+ "application/x-shockwave-flash, application/xaml+xml, "+ "application/vnd.ms-xpsdocument, application/x-ms-xbap, "+ "application/x-ms-application, application/vnd.ms-excel, "+ "application/vnd.ms-powerpoint, application/msword, */*");conn.setRequestProperty("Accept-Language", "zh-CN");conn.setRequestProperty("Charset", "UTF-8");InputStream inStream = conn.getInputStream();// 跳過startPos個位元組，表明該線程只下載自己負責哪部分檔案。inStream.skip(this.startPos);byte[] buffer = new byte[1024];int hasRead = 0;// 讀取網路資料，並寫入本地檔案while (length < currentPartSize&& (hasRead = inStream.read(buffer)) > 0){currentPart.write(buffer, 0, hasRead);// 累計該線程下載的總大小length += hasRead;}currentPart.close();inStream.close();}catch (Exception e){e.printStackTrace();}}}}

上而的DownUtil工具類中包括一個DownloadThread內部類，該內部類的run()方法中負責開啟遠端資源的輸入資料流，並調用inputStream的skip(int)方法跳過指定數量的位元組，這樣就讓該線程讀取由它自己負責下載的部分。

提供了上面的DownUtil工具類之後，接下來就可以在Activity中調用該DownUtil類來執行下載任務，該程式介面中包含兩個文字框，一個用於輸入網路檔案的源路徑，另一個用於指定下載到本地的檔案的檔案名稱，該程式的介面比較簡單，故此處不再給出介面布局代碼。該程式的Activity代碼如下。

package com.jph.net;import java.util.Timer;import java.util.TimerTask;import android.app.Activity;import android.content.Context;import android.os.Bundle;import android.os.Handler;import android.os.Looper;import android.os.Message;import android.view.View;import android.view.View.OnClickListener;import android.widget.Button;import android.widget.EditText;import android.widget.ProgressBar;import android.widget.Toast;/** * Description: * 多線程下載 * @author  jph * Date：2014.08.27 */public class MultiThreadDown extends Activity{EditText url;EditText target;Button downBn;ProgressBar bar;DownUtil downUtil;private int mDownStatus;@Overridepublic void onCreate(Bundle savedInstanceState){super.onCreate(savedInstanceState);setContentView(R.layout.main);// 擷取程式介面中的三個介面控制項url = (EditText) findViewById(R.id.url);target = (EditText) findViewById(R.id.target);downBn = (Button) findViewById(R.id.down);bar = (ProgressBar) findViewById(R.id.bar);// 建立一個Handler對象final Handler handler = new Handler(){@Overridepublic void handleMessage(Message msg){if (msg.what == 0x123){bar.setProgress(mDownStatus);}}};downBn.setOnClickListener(new OnClickListener(){@Overridepublic void onClick(View v){// 初始化DownUtil對象（最後一個參數指定線程數）downUtil = new DownUtil(url.getText().toString(),target.getText().toString(), 6);new Thread(){@Overridepublic void run(){try{// 開始下載downUtil.download();}catch (Exception e){e.printStackTrace();}// 定義每秒調度擷取一次系統的完成進度final Timer timer = new Timer();timer.schedule(new TimerTask(){@Overridepublic void run(){// 擷取下載任務的完成比率double completeRate = downUtil.getCompleteRate();mDownStatus = (int) (completeRate * 100);// 發送訊息通知介面更新進度條handler.sendEmptyMessage(0x123);// 下載完全後取消任務調度if (mDownStatus >= 100){showToastByRunnable(MultiThreadDown.this, "下載完成", 2000);timer.cancel();}}}, 0, 100);}}.start();}});}/** * 在非UI線程中使用Toast * @param context 上下文 * @param text 用以顯示的訊息內容 * @param duration 訊息顯示的時間 * */private void showToastByRunnable(final Context context, final CharSequence text, final int duration) {    Handler handler = new Handler(Looper.getMainLooper());    handler.post(new Runnable() {        @Override        public void run() {            Toast.makeText(context, text, duration).show();        }    });}}

上面的Activity不僅使用了 DownUtil來控製程序下載，而且程式還啟動了一個定時器，該定時器控制每隔0.1秒査詢一次下載進度，並通過程式中的進度條來顯示任務的下載進度。

該程式不僅需要訪問網路，還需要訪問系統SD卡，在SD卡中建立檔案，因此必須授予該程式訪問網路、訪問SD卡檔案的許可權：

程式運行：

提示：上面的程式已經實現了多線程下載的核心代碼，如果要實現斷點下載，則還需要額外增加一個設定檔（大家可以發現所有斷點下載工具都會在下載開始產生兩個檔案：一個是與網路資源相同大小的空檔案，一個是設定檔），該設定檔分別記錄每個線程已經下載到了哪個位元組，當網路斷開後再次開始下載時，每個線程根據設定檔裡記錄的位置向後下載即可。

2 使用ApacheHttpClient

在一般情況下，如果只是需要向Web網站的某個簡單頁面提交請求並擷取伺服器響應， 完全可以使用前面所介紹的HttpURLConnection來完成。但在絕大部分情況下，Web網站的網頁可能沒這麼簡單，這些頁面並不是通過一個簡單的URL就可訪問的，可能需要使用者登入而且具有相應的許可權才可訪問該頁面。在這種情況下，就需要涉及Session、Cookie的處理了，如果打算使用HttpURLConnection來處理這些細節，當然也是可能實現的，只是處理起來難度就大了。

為了更好地處理向Web網站請求，包括處理Session、Cookie等細節問題，Apache開源組織提供了一個HttpClient項目，看它的名稱就知道，它是一個簡單的HTTP用戶端（並不是瀏覽器），可以用於發送HTTP請求，接收HTTP響應。但不會快取服務器的響應，不能執行HTML頁面中嵌入的JavaScript代碼；也不會對頁面內容進行任何解析、處理。

提示：簡單來說，HttpClient就是一個增強版的HttpURLConnection ,HttpURLConnection可以做的事情 HttpClient全部可以做；HttpURLConnection沒有提供的有些功能，HttpClient也提供了，但它只是關注於如何發送請求、接收響應，以及管理HTTP串連。|

Android整合了HttpClient，開發人員可以直接在Android應用中使用HttpCHent來訪問提交請求、接收響應。

2.1使用HttpClient發送清求、接收響應很簡單，只要如下幾步即可：

1) 建立HttpClient對象。

2) 如果需要發送GET請求，建立HttpGet對象；如果需要發送POST 求，建立HttpPost對象。

3) 如果需要發送請求參數，可調用HttpGet、HttpPost共同的setParams(HttpParams params)方法來添加請求參數；對於HttpPost對象而言，也可調用setEntity(HttpEntityentity)方法來佈建要求參數。

4) 調用HttpClient對象的execute(HttpUriRequestrequest)發送請求，執行該方法返回一 個 HttpResponse。

5) 調用HttpResponse的getAllHeaders()、getHeaders(String name)等方法可擷取伺服器的回應標頭；調用HttpResponse的getEntity()方法可擷取HttpEntity對象，該對象封裝了伺服器的響應內容。程式可通過該對象擷取伺服器的響應內容。

2.2執行個體：訪問被保護資源

下面的Android應用需要向指定頁面發送請求，但該頁面並不是一個簡單的頁面，只有 當使用者已經登入，而且登入使用者的使用者名稱是jph時才可訪問該頁面。如果使用HttpUrlConnection來訪問該頁面，那麼需要處理的細節就太複雜了。下面將會藉助於 HttpClient來訪問被保護的頁面。

訪問Web應用中被保護的頁面，如果使用瀏覽器則十分簡單，使用者通過系統提供的登入頁面登入系統，瀏覽器會負責維護與伺服器之間的Session,如果使用者登入的使用者名稱、密碼符合要求，就可以訪問被保護資源了。

為了通過HttpClient來訪問被保護頁面，程式同樣需要使用HttpClient來登入系統，只要應用程式使用同一個HttpClient發送請求，HttpClient會自動維護與伺服器之間的Session狀態，也就是說程式第一次使用HttpCHent登入系統後，接下來使用HttpCHent即可訪問被保護頁面了。

提示:雖然此處給出的執行個體只是訪問被保護的頁面，但訪問其他被保護的資源也與此類似，程式只要第一次通過HttpClient登入系統，接下來即可通過該HttpClient訪問被保護資源了。

2.3程式碼：

package com.jph.net;import java.io.BufferedReader;import java.io.InputStreamReader;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.app.AlertDialog;import android.content.DialogInterface;import android.os.Bundle;import android.os.Handler;import android.os.Looper;import android.os.Message;import android.text.Html;import android.view.View;import android.widget.EditText;import android.widget.TextView;import android.widget.Toast;/** * Description: * 使用HttpClient訪問受保護的網路資源 * @author  jph * Date：2014.08.28 */public class HttpClientDemo extends Activity{TextView response;HttpClient httpClient;Handler handler = new Handler(){public void handleMessage(Message msg){if(msg.what == 0x123){// 使用response文字框顯示伺服器響應response.append(Html.fromHtml(msg.obj.toString()) + "\n");}}};@Overridepublic void onCreate(Bundle savedInstanceState){super.onCreate(savedInstanceState);setContentView(R.layout.main);// 建立DefaultHttpClient對象httpClient = new DefaultHttpClient();response = (TextView) findViewById(R.id.response);}/** * 此方法用於響應“訪問頁面”按鈕 * */public void accessSecret(View v){response.setText("");new Thread(){@Overridepublic void run(){// 建立一個HttpGet對象HttpGet get = new HttpGet("http://10.201.1.32:8080/HttpClientTest_Web/secret.jsp");  //①try{// 發送GET請求HttpResponse httpResponse = httpClient.execute(get);//②HttpEntity entity = httpResponse.getEntity();if (entity != null){// 讀取伺服器響應BufferedReader br = new BufferedReader(new InputStreamReader(entity.getContent()));String line = null;while ((line = br.readLine()) != null){Message msg = new Message();msg.what = 0x123;msg.obj = line;handler.sendMessage(msg);}}}catch (Exception e){e.printStackTrace();}}}.start();}/** * 此方法用於響應“登陸系統”按鈕 * */public void showLogin(View v){// 載入登入介面final View loginDialog = getLayoutInflater().inflate(R.layout.login, null);// 使用對話方塊供使用者登入系統new AlertDialog.Builder(HttpClientDemo.this).setTitle("登入系統").setView(loginDialog).setPositiveButton("登入",new DialogInterface.OnClickListener(){@Overridepublic void onClick(DialogInterface dialog,int which){// 擷取使用者輸入的使用者名稱、密碼final String name = ((EditText) loginDialog.findViewById(R.id.name)).getText().toString();final String pass = ((EditText) loginDialog.findViewById(R.id.pass)).getText().toString();new Thread(){@Overridepublic void run(){try{HttpPost post = new HttpPost("http://10.201.1.32:8080/" +"HttpClientTest_Web/login.jsp");//③// 如果傳遞參數個數比較多的話可以對傳遞的參數進行封裝List params = newArrayList();params.add(new BasicNameValuePair("name", name));params.add(new BasicNameValuePair("pass", pass));// 佈建要求參數post.setEntity(new UrlEncodedFormEntity(params, HTTP.UTF_8));// 發送POST請求HttpResponse response = httpClient.execute(post);  //④// 如果伺服器成功地返迴響應if (response.getStatusLine().getStatusCode() == 200){String msg = EntityUtils.toString(response.getEntity());Looper.prepare();// 提示登入成功Toast.makeText(HttpClientDemo.this,msg, Toast.LENGTH_SHORT).show();Looper.loop();}}catch (Exception e){e.printStackTrace();}}}.start();}}).setNegativeButton("取消", null).show();}}

上面的程式中①、②號粗體字代碼先建立了一個HttpGet對象，接下來程式調用HttpClient的execute()方法發送GET請求；程式中③、④號粗體字代碼先建立了一個HttpPost對象，接下來程式調用了HttpClient的execute()方法發送POST請求。上面的GET請求用於擷取伺服器上的被保護頁面，POST請求用於登入系統。

運行該程式，單擊“訪問頁面”按鈕將可看到如所示的頁面。

從可以看出，程式直接向指定Web應用的被保護頁面secret.jsp發送請求，程式將無法訪問被保護頁面，於是看到所示的頁面。單擊所示頁面中的“登入”按鈕，系統將會顯示如所示的登入對話方塊。

在所示對話方塊的兩個輸入框中分別輸入“jph”、“123”，然後單擊“登入”按鈕，系統將會向Web網站的login.jsp頁面發送POST請求，並將使用者輸入的使用者名稱、密碼作為請求參數。如果使用者名稱、密碼正確，即可看到登入成功的提示。

登入成功後，HttpClient將會自動維護與伺服器之間的串連，並維護與伺服器之間的Session狀態，再次單擊程式中的“訪問頁面”按鈕，即可看到如所示的輸出。

從可以看出，此時使用HttpClient發送GET請求即可正常訪問被保護資源，這就是因為前面使用了HttpClient登入了系統，而且HttpClient可以維護與伺服器之間的Session串連。

從上面的編程過程不難看出，使用Apache的HttpClient更加簡單，而且它比HttpURLConnection提供了更多的功能。