Android学习笔记(四六):互联网通信-文件下载

Android学习笔记(四六):互联网通信-文件下载_第1张图片

在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,用来查看历史下载情况。

请求文件下载

Android学习笔记(四六):互联网通信-文件下载_第2张图片     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学习笔记(四六):互联网通信-文件下载_第3张图片 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学习笔记(四六):互联网通信-文件下载_第4张图片Android学习笔记(四六):互联网通信-文件下载_第5张图片从信息中,我们可以看到下载的存放的位置,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从服务器中获取事件触发处理。

Android学习笔记(四六):互联网通信-文件下载_第6张图片Android学习笔记(四六):互联网通信-文件下载_第7张图片     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)的例子只是作为小例子简单清晰说明相关的使用方式。

相关链接:我的Andriod开发相关文章

你可能感兴趣的:(android,互联网,存储,download,button,internet)