互連網通訊-檔案下載

在Android 2.3引入了DownloadManager可以處理複雜的檔案下載，包括檢查使用者是否有資料聯絡（WIFI或者移動資料），當使用者從一個有資料連線的地方移動到不需連線的地方（例如離開了wifi或者3G data的access point），確保裝置在下載過程中保持awake狀態。DownloadManager可以處理HTTP URLs，但是不能處理HTTPS(SSL) URLs。

設定下載檔案條件許可

在這個例子，將學習通過DownloadManager從Internet下載檔案，並儲存在外部儲存介質SD卡上。有以下需要注意：

1. 由於不支援2.3之前的版本，需將最小版本設定為Android2.3或者以上。
2. 在模擬器，我們需確保已設定SD卡，如右圖所示。
3. 程式具有Internet以及外部儲存的存取權限，在Androidmanifest.xml中設定：

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

小程式的設計

具體的xml檔案略去。布局簡單地分為3個button，如右圖，第一個button設定android:onClick="startDownload"，即點擊後觸發startDownload()方法，用於請求下載檔案。第二個button觸發queryStatus(),並disabled，點擊觸發下載的狀態查詢。第三個button觸發viewLog()，調用系統提供的DownloadManager的Activity，用來查看曆史下載情況。

請求檔案下載

    privateDownloadManager mgr = null; 
    private long lastDownloadId = 0;  

    protected void onCreate(Bundle savedInstanceState) { 
        … …  
        // 步驟1 : 擷取系統服務，並指明是下載服務，即DownloadManager。系統的這類服務大部分這些管理沒有close() ，release()之類的由系統garbage收集來處理。我們只需擷取這些服務的對象，並發出我們的請求
        mgr = (DownloadManager)getSystemService(DOWNLOAD_SERVICE); 
    } 

    public void startDownload(View v){  
        Uri uri = Uri.parse("http://commonsware.com/misc/test.mp4");
        //檔案將存放在外部儲存的確實download檔案內，如果無此檔案夾，建立之，如果有，下面將返回false。不同的手機不同Android版本的SD卡的掛載點可能會不一樣，因此通過系統方式擷取。
        Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS).mkdir()； 

        //步驟2： 通過向下載服務發出enqueue()的請求，將放在下載隊列中，通常會觸發立即下載，並返回下載的ID號，根據這個號，可以查詢相關的下載情況。分別佈建要求的Uri，允許的資料訪問方式，是否允許漫遊，本機存放區的位置，以及為這個下載設定title和描述資訊。
        lastDownloadId = mgr.enqueue(new DownloadManager.Request(uri) 
           .setAllowedNetworkTypes(DownloadManager.Request.NETWORK_MOBILE | DownloadManager.Request.NETWORK_WIFI) 
           .setAllowedOverRoaming(false)           //預設是true，所以天價漫遊資料費的產生 
           .setTitle("MyTest")         //用於資訊查看 
           .setDescription("Something Useful")   //用於資訊查看 
           .setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, "test.mp4"));
        v.setEnabled(false); 
        findViewById(R.id.c25_query).setEnabled(true);  
    }

擷取下載狀態

通常會有一個後台運行來不斷更新下載的情況，例子目的是如何擷取，所以簡單地通過點擊第二個button觸發查詢下載狀態。

public void queryStatus(View v){
    //關鍵：通過ID向下載管理查詢下載情況，返回一個cursor 
    Cursor c = mgr.query(new DownloadManager.Query().setFilterById(lastDownloadId));
    if(c == null){ 
        Toast.makeText(this, "Download not found!", Toast.LENGTH_LONG).show(); 
    }else{  //以下是從遊標中進行資訊提取 
        c.moveToFirst(); 
        Log.d(getClass().getName(),"Column_id : " + 
                c.getLong(c.getColumnIndex(DownloadManager.COLUMN_ID))); 
        Log.d(getClass().getName(),"Column_bytes_downloaded so far : " + 
                c.getLong(c.getColumnIndex(DownloadManager.COLUMN_BYTES_DOWNLOADED_SO_FAR)));
        Log.d(getClass().getName(),"Column last modified timestamp : " + 
                c.getLong(c.getColumnIndex(DownloadManager.COLUMN_LAST_MODIFIED_TIMESTAMP)));
        Log.d(getClass().getName(),"Column local uri : " + 
                c.getString(c.getColumnIndex(DownloadManager.COLUMN_LOCAL_URI)));
        Log.d(getClass().getName(),"Column statue : " + 
                c.getInt(c.getColumnIndex(DownloadManager.COLUMN_STATUS))); 
        Log.d(getClass().getName(),"Column reason : " + 
                c.getInt(c.getColumnIndex(DownloadManager.COLUMN_REASON))); 

        Toast.makeText(this, statusMessage(c), Toast.LENGTH_LONG).show(); 
    } 
} 

private String statusMessage(Cursor c){  
    switch(c.getInt(c.getColumnIndex(DownloadManager.COLUMN_STATUS))){ 
    case DownloadManager.STATUS_FAILED:  
        return "Download failed";  
    case DownloadManager.STATUS_PAUSED:  
       return "Download paused";  
    case DownloadManager.STATUS_PENDING:  
        return "Download pending";  
    case DownloadManager.STATUS_RUNNING: 
        return "Download in progress!";  
    case DownloadManager.STATUS_SUCCESSFUL:  
        return "Download finished";  
    default: 
        return "Unknown Information";  
    } 
}

從資訊中，我們可以看到下載的存放的位置，SD卡的掛點為/mnt/sdcard/我們可以通過$adb
shell進入模擬器的控制台進行查看。另外擷取檔案的總體大小為COLUMN_TOTAL_SIZE_BYTES。

# pwd/mnt/sdcard/Download
# ls -l
----rwxr-x system sdcard_rw 6219229 2011-11-01 14:19 test.mp4

通過下載管理查看

public void viewLog(View v){ 
    startActivity(new Intent(DownloadManager.ACTION_VIEW_DOWNLOADS));
}

通過BoardReceiver擷取即時事件觸發

在上面的例子中，希望在一下載完進行觸發，將第一個button恢複為enabled狀態。在Android學習筆記（三四）：再談Intent（上）－一些知識中談到，通過BoardReceiver從伺服器中擷取事件觸發處理。

   
protected void onCreate(Bundle savedInstanceState) {
        ... ... 
       //當下載結束時進行觸發。 
        registerReceiver(onComplete, new IntentFilter(DownloadManager.ACTION_DOWNLOAD_COMPLETE));
       //當點擊一個正在下載的檔案， 
        registerReceiver(onNotification,new IntentFilter(DownloadManager.ACTION_NOTIFICATION_CLICKED));
    } 
    BroadcastReceiver onComplete =  new BroadcastReceiver() {  
        public void onReceive(Context context, Intent intent) { 
           findViewById(R.id.c25_start).setEnabled(true);
        } 
    }; 
    BroadcastReceiver onNotification = new BroadcastReceiver() {  
        public void onReceive(Context context, Intent intent) { 
            Toast.makeText(context, "..............", Toast.LENGTH_LONG).show();
        } 
    };

對於DownloadManager，如果檔案已經下載，第二次無需再下載。另外由於DownloadManager屬於系統服務，不僅是你的app可以調用，也就是上面list的內容是全域的，可能部分並非你的app在下載，這樣會使使用者迷惑，在request請求中，我們可以同setVisibleInDownloadsUi(false)，可以屏蔽之。

傳統檔案下載方式

ownloadManager服務需要Android版本2.3以上，如果不滿足條件，可採用擷取網路檔案流的方式來處理，具體步驟如下：

1. 建一個HttpURLConnection的對象，可以通過URL對象的openConnection()方法擷取，例如：HttpURLConnection urlConn = (HttpURLConnection) url.openconnection();
2. 擷取一個InputStream對象：urlConn.getInputStream()。

有了InputStream，剩下的都是Java的標準I/O操作。

注意

對於Internet的訪問，不要再應用的主線程進行，而應該在後台線程中處理HttpClient,HttpUrlConnection以及其他的Internet access API。Android學習筆記（四五）：互連網通訊-HttpClient、XML解析（W3C）的例子只是作為小例子簡單清晰說明相關的使用方式。