Android中的文件下载——DownLoadManager

1、问题概述

　　在android开发中，常常会使用到文件下载的功能，好比app版本更新等。在api level 9以后，android系统为咱们提供了DownLoadManager类，这是android提供的系统服务，咱们经过这个服务完成文件下载。整个下载过程所有交给系统负责，不须要咱们过多的处理。

　　经过API文档，能够看出DownLoadManager包含两个内部类：

 

　　DownLoadManager.Query:主要用于查询下载信息。

　　DownLoadManager.Request:主要用于发起一个下载请求。

2、功能实现

　　首先让咱们来了解一下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<String, String> map = new HashMap<String, String>();
            map.put("downid", downId);
            map.put("title", title);
            map.put("address", address);
            map.put("status", sizeTotal+":"+size);
            this.data.add(map);
        }
        cursor.close();
    }

　　具体能够查看哪些信息，能够查看DownLoadManger下的Column_*常量信息。

3、源码下载

　　想要亲自体验效果的同窗，能够下载原工程，直接运行查看！

 

做者： 杰瑞教育
出处： http://www.cnblogs.com/jerehedu/ 
本文版权归烟台杰瑞教育科技有限公司和博客园共有，欢迎转载，但未经做者赞成必须保留此段声明，且在文章页面明显位置给出原文链接，不然保留追究法律责任的权利。