Android中的文件下載——DownLoadManager

　　在android開發中，經常會使用到文件下載的功能，比如app版本更新等。在api level 9之後，android系統為我們提供了DownLoadManager類，這是android提供的系統服務，我們通過這個服務完成文件下載。整個下載過程全部交給系統負責，不需要我們過多的處理。

　　通過API文檔，可以看出DownLoadManager包含兩個內部類：

　　DownLoadManager.Query:主要用於查詢下載信息。

　　DownLoadManager.Request:主要用於發起一個下載請求。

　　首先讓我們來了解一下DownLoadManager.Request,此類封裝了一個下載請求所需要的所有信息。通過構造函數我們可以初始化一個request對象，構造對象時需要傳入下載文件的地址。

DownloadManager.Request request = new DownloadManager.Request(Uri.parse(下載地址));

　　構造完對象後，我們可以為request設置一些屬性：

addRequestHeader(String header,String value):添加網絡下載請求的http頭信息allowScanningByMediaScanner():用於設置是否允許本MediaScanner掃描。setAllowedNetworkTypes(int flags):設置用於下載時的網絡類型，默認任何網絡都可以下載，提供的網絡常量有：NETWORK_BLUETOOTH、NETWORK_MOBILE、NETWORK_WIFI。setAllowedOverRoaming(Boolean allowed):用於設置漫游狀態下是否可以下載setNotificationVisibility(int visibility):用於設置下載時時候在狀態欄顯示通知信息setTitle(CharSequence):設置Notification的title信息setDescription(CharSequence):設置Notification的message信息setDestinationInExternalFilesDir、setDestinationInExternalPublicDir、setDestinationUri等方法用於設置下載文件的存放路徑，注意如果將下載文件存放在默認路徑，那麼在空間不足的情況下系統會將文件刪除，所以使用上述方法設置文件存放目錄是十分必要的。

　　創建Request對象的代碼如下：

DownloadManager.Request request = new DownloadManager.Request(Uri.parse(http://gdown.baidu.com/data/wisegame/55dc62995fe9ba82/jinritoutiao_448.apk));
   //設置在什麼網絡情況下進行下載
   request.setAllowedNetworkTypes(Request.NETWORK_WIFI);
   //設置通知欄標題
   request.setNotificationVisibility(Request.VISIBILITY_VISIBLE);
   request.setTitle(下載);
   request.setDescription(今日頭條正在下載);
   request.setAllowedOverRoaming(false);
   //設置文件存放目錄
   request.setDestinationInExternalFilesDir(this, Environment.DIRECTORY_DOWNLOADS, mydown);

　　取得系統服務後，調用downloadmanager對象的enqueue方法進行下載，此方法返回一個編號用於標示此下載任務：

downManager = (DownloadManager)getSystemService(Context.DOWNLOAD_SERVICE);
id= downManager.enqueue(request);

　　如果想取消下載，則可以調用remove方法完成，此方法可以將下載任務和已經下載的文件同時刪除：

downManager.remove(id);

　　在文件下載完成時，我們經常需要做一下後操作，比如apk，怎需要直接顯示安裝，那麼我們如何監聽文件時候已經下載完成了呢？DownLoadManager在文件現在完成時會發送一個action為ACTION_DOWNLOAD_COMPLETE的廣播，我們只要注冊一個廣播接收器即可進行處理：

    private class DownLoadCompleteReceiver extends BroadcastReceiver{
        @Override
        public void onReceive(Context context, Intent intent) {
            if(intent.getAction().equals(DownloadManager.ACTION_DOWNLOAD_COMPLETE)){
                long id = intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, -1);
                Toast.makeText(MainActivity.this, 編號：+id+的下載任務已經完成！, Toast.LENGTH_SHORT).show();
            }else if(intent.getAction().equals(DownloadManager.ACTION_NOTIFICATION_CLICKED)){
                Toast.makeText(MainActivity.this, 別瞎點！！！, Toast.LENGTH_SHORT).show();
            }
        }
    }

　　DownManager會對所有的現在任務進行保存管理，那麼我們如何獲取這些信息呢？這個時候就要用到DownManager.Query對象，通過此對象，我們可以查詢所有下載任務信息。

　　setFilterById(long... ids)：根據任務編號查詢下載任務信息

　　setFilterByStatus(int flags)：根據下載狀態查詢下載任務

　　具體使用方法如下：

private void queryDownTask(DownloadManager downManager,int status) {
        DownloadManager.Query query = new DownloadManager.Query();
        query.setFilterByStatus(status);
        Cursor cursor= downManager.query(query);
        
        while(cursor.moveToNext()){
            String downId= cursor.getString(cursor.getColumnIndex(DownloadManager.COLUMN_ID));
            String title = cursor.getString(cursor.getColumnIndex(DownloadManager.COLUMN_TITLE));
            String address = cursor.getString(cursor.getColumnIndex(DownloadManager.COLUMN_LOCAL_URI));
            //String statuss = cursor.getString(cursor.getColumnIndex(DownloadManager.COLUMN_STATUS));
            String size= cursor.getString(cursor.getColumnIndex(DownloadManager.COLUMN_BYTES_DOWNLOADED_SO_FAR));
            String sizeTotal = cursor.getString(cursor.getColumnIndex(DownloadManager.COLUMN_TOTAL_SIZE_BYTES));
            Map map = new HashMap();
            map.put(downid, downId);
            map.put(title, title);
            map.put(address, address);
            map.put(status, sizeTotal+:+size);
            this.data.add(map);
        }
        cursor.close();
    }