天天看點

android 檔案下載下傳

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

設定下載下傳檔案條件許可

在這個例子,将學習通過DownloadManager從Internet下載下傳檔案,并存儲在外部存儲媒體SD卡上。有以下需要注意:

由于不支援2.3之前的版本,需将最小版本設定為Android2.3或者以上。

在模拟器,我們需確定已設定SD卡,如右圖所示。

程式具有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,用來檢視曆史下載下傳情況。

請求檔案下載下傳

android 檔案下載下傳

    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觸發查詢下載下傳狀态。

android 檔案下載下傳

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";  

}

android 檔案下載下傳
android 檔案下載下傳
android 檔案下載下傳

從資訊中,我們可以看到下載下傳的存放的位置,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擷取實時事件觸發

android 檔案下載下傳
android 檔案下載下傳

    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() {  

            Toast.makeText(context, "..............", Toast.LENGTH_LONG).show();

    };

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

傳統檔案下載下傳方式

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

建一個HttpURLConnection的對象,可以通過URL對象的openConnection()方法擷取,例如:HttpURLConnection urlConn = (HttpURLConnection) url.openconnection();

擷取一個InputStream對象:urlConn.getInputStream()。

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

注意