系统自带DownloadManager详解

前言:

还在自己写DownloadUtils吗？有了DownloadManger.你只需将UI画好，其他的事情，交给他来做就好了。

简介：

DownloadManager是android2.3以后，系统下载的方法，是处理长期运行的HTTP下载的系统服务。客户端可以请求的URI被下载到一个特定的目标文件。客户端将会在后台与http交互进行下载，或者在下载失败，或者连接改变，重新启动系统后重新下载。还可以进入系统的下载管理界面查看进度。DownloadManger有两个内部类，Request 和Query。Request类可设置下载的一些属性。Query类可查询当前下载的进度，下载地址，文件存放目录等数据。

DownloadManager

1、所需权限

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

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

2、获得对象，开始下载

DownloadManager downloadManager = (DownloadManager)getSystemService(DOWNLOAD_SERVICE);
DownloadManager.Request request = new DownloadManager.Request(Uri.parse(apkUrl));
long id = downloadManager.enqueue(request);
//每下载的一个文件对应一个id，通过此id可以查询数据。

3、取消下载

downloadManager.remove(REFERENCE_1, REFERENCE_2, REFERENCE_3);  

该方法返回成功取消的下载的个数，如果一个下载被取消了，所有相关联的文件，部分下载的文件和完全下载的文件都会被删除.

Request类

1.指定下载位置，及文件名称

        /**
         * 方法1: 
         * 目录: Android -> data -> com.app -> files -> Download -> dxtj.apk
         * 这个文件是你的应用所专用的,软件卸载后，下载的文件将随着卸载全部被删除
         */
request.setDestinationInExternalFilesDir( this , Environment.DIRECTORY_DOWNLOADS ,  "dxtj.apk" );  

        /**
         * 方法2:
         * 下载的文件存放地址  SD卡 download文件夹，dxtj.apk
         * 软件卸载后，下载的文件会保留
         */
        //在SD卡上创建一个文件夹
        request.setDestinationInExternalPublicDir(  "/epmyg/"  , "dxtj.apk" ) ;  


        /**
         * 方法3:
         * 如果下载的文件希望被其他的应用共享
         * 特别是那些你下载下来希望被Media Scanner扫描到的文件（比如音乐文件）
         */
        request.setDestinationInExternalPublicDir( Environment.DIRECTORY_MUSIC,  "告白气球.mp3" );  

        /**
         * 方法4
         * 文件将存放在外部存储的确实download文件内，如果无此文件夹，创建之，如果有，下面将返回false。
         * 系统有个下载文件夹，比如小米手机系统下载文件夹  SD卡--> Download文件夹
         */
        //创建目录
        Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS).mkdir() ; 

        //设置文件存放路径
        request.setDestinationInExternalPublicDir(  Environment.DIRECTORY_DOWNLOADS  , "dxtj.apk" ) ;
    }

2、指定下载的网络类型

//指定在WIFI状态下，执行下载操作。
request.setAllowedNetworkTypes(DownloadManager.Request.NETWORK_WIFI);
//指定在MOBILE状态下，执行下载操作
request.setAllowedNetworkTypes(DownloadManager.Request.NETWORK_MOBILE);
//是否允许漫游状态下，执行下载操作
request.setAllowedOverRoaming(boolean);
//是否允许“计量式的网络连接”执行下载操作
request.setAllowedOverMetered(boolean); //默认是允许的。

3、定制Notification样式

//设置Notification的标题和描述
request.setTitle("标题");  
request.setDescription("描述"); 
//设置Notification的显示，和隐藏。
request.setNotificationVisibility(visibility);

VISIBILTY_HIDDEN: Notification:将不会显示，如果设置该属性的话，必须要添加权限
android.permission.DOWNLOAD_WITHOUT_NOTIFICATION.
VISIBILITY_VISIBLE： Notification显示，但是只是在下载任务执行的过程中显示，下载完成自动消失。（默认值）
VISIBILITY_VISIBLE_NOTIFY_COMPLETED : Notification显示，下载进行时，和完成之后都会显示。
VISIBILITY_VISIBLE_NOTIFY_ONLY_COMPLETION ：只有当任务完成时，Notification才会显示。
对Notification的设定方法相对较少。

4、设置下载文件类型：

request.setMimeType("application/vnd.android.package-archive");

这是安卓.apk文件的类型。有些机型必须设置此方法，才能在下载完成后，点击通知栏的Notification时，才能正确的打开安装界面。不然会弹出一个Toast（can not open file）.其他文件类型的MimeType ,自行百度吧 。

5、添加请求下载的网络链接的http头，比如User-Agent，gzip压缩等：

request.addRequestHeader(String header, String value)；

Query 类

我们的需求，可能不只是在Notification 中显示进度就好了，也许，在app中也需要获取实时下载进度。所以Query类就是提供查询的一些方法。
但API中就只有两个方法，原来，他把数据保存在数据库中去了。我们需要获得一个Cursor 结果集，通过结果集获得我们想要的数据。