Android DownloadManager 的使用_downloadmanagerservice-程序员宅基地

技术标签: android  下载  DownloadManager  Android  

随时随地阅读更多技术实战干货,获取项目源码、学习资料,请关注源代码社区公众号(ydmsq666)

转自:http://blog.csdn.net/carrey1989/article/details/8060155

Android 2.3(API level 9)开始android用系统服务(Service)的方式提供了Download Manager来优化处理长时间的下载操作。Download Manager处理HTTP

连接并监控连接中的状态变化以及系统重启来确保每一个下载任务顺利完成。

在大多数涉及到下载的情况中使用Download Manager都是不错的选择,特别是当用户切换不同的应用以后下载需要在后台继续进行,以及当下载任务顺利完

成非常重要的情况(DownloadManager对于断点续传功能支持很好)。

要想使用Download Manager,使用getSystemService方法请求系统的DOWNLOAD_SERVICE服务,代码片段如下:

[java] view plain copy

  1. String serviceString = Context.DOWNLOAD_SERVICE;  
  2. DownloadManager downloadManager;  
  3. downloadManager = (DownloadManager) getSystemService(serviceString);  

下载文件

要请求一个下载操作,需要创建一个DownloadManager.Request对象,将要请求下载的文件的Uri传递给Download Manager的enqueue方法,代码片段如下所示:

[java] view plain copy

  1. String serviceString = Context.DOWNLOAD_SERVICE;  
  2. DownloadManager downloadManager;  
  3. downloadManager = (DownloadManager)getSystemService(serviceString);  
  4.   
  5. Uri uri = Uri.parse("http://developer.android.com/shareables/icon_templates-v4.0.zip");  
  6. DownloadManager.Request request = new Request(uri);  
  7. long reference = downloadManager.enqueue(request);  

在这里返回的reference变量是系统为当前的下载请求分配的一个唯一的ID,我们可以通过这个ID重新获得这个下载任务,进行一些自己想要进行的操作或者查询

下载的状态以及取消下载等等。

我们可以通过addRequestHeader方法为DownloadManager.Request对象request添加HTTP头,也可以通过setMimeType方法重写从服务器返回的mime type。

我们还可以指定在什么连接状态下执行下载操作。setAllowedNetworkTypes方法可以用来限定在WiFi还是手机网络下进行下载,setAllowedOverRoaming方法

可以用来阻止手机在漫游状态下下载。

下面的代码片段用于指定一个较大的文件只能在WiFi下进行下载:

[java] view plain copy

  1. request.setAllowedNetworkTypes(Request.NETWORK_WIFI);  

Android API level 11 介绍了getRecommendedMaxBytesOverMobile类方法(静态方法),返回一个当前手机网络连接下的最大建议字节数,可以来判断下载

是否应该限定在WiFi条件下。

调用enqueue方法之后,只要数据连接可用并且Download Manager可用,下载就会开始。

要在下载完成的时候获得一个系统通知(notification),注册一个广播接受者来接收ACTION_DOWNLOAD_COMPLETE广播,这个广播会包含一个

EXTRA_DOWNLOAD_ID信息在intent中包含了已经完成的这个下载的ID,代码片段如下所示:

[java] view plain copy

  1. IntentFilter filter = new IntentFilter(DownloadManager.ACTION_DOWNLOAD_COMPLETE);  
  2.       
  3. BroadcastReceiver receiver = new BroadcastReceiver() {  
  4.   @Override  
  5.   public void onReceive(Context context, Intent intent) {  
  6.     long reference = intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, -1);  
  7.     if (myDownloadReference == reference) {  
  8.        
  9.     }  
  10.   }  
  11. };  
  12. registerReceiver(receiver, filter);  

使用Download Manager的openDownloadedFile方法可以打开一个已经下载完成的文件,返回一个ParcelFileDescriptor对象。我们可以通过Download Manager来

查询下载文件的保存地址,如果在下载时制定了路径和文件名,我们也可以直接操作文件。

我们可以为ACTION_NOTIFICATION_CLICKED action注册一个广播接受者,当用户从通知栏点击了一个下载项目或者从Downloads app点击可一个下载的项目的

时候,系统就会发出一个点击下载项的广播。

代码片段如下:

[java] view plain copy

  1. IntentFilter filter = new IntentFilter(DownloadManager.ACTION_NOTIFICATION_CLICKED);  
  2.   
  3. BroadcastReceiver receiver = new BroadcastReceiver() {  
  4.   @Override  
  5.   public void onReceive(Context context, Intent intent) {  
  6.     String extraID = DownloadManager.EXTRA_NOTIFICATION_CLICK_DOWNLOAD_IDS;  
  7.     long[] references = intent.getLongArrayExtra(extraID);  
  8.     for (long reference : references)  
  9.       if (reference == myDownloadReference) {  
  10.         // Do something with downloading file.  
  11.       }  
  12.   }  
  13. };  
  14.   
  15. registerReceiver(receiver, filter);  

定制Download Manager Notifications的样式

默认情况下,通知栏中会显示被Download Manager管理的每一个download每一个Notification会显示当前的下载进度和文件的名字,如下图所示:

通过Download Manager可以为每一个download request定制Notification的样式,包括完全隐藏Notification。下面的代码片段显示了通过setTitle和setDescription

方法来定制显示在文件下载Notification中显示的文字。

[java] view plain copy

  1. request.setTitle(“Earthquakes”);  
  2. request.setDescription(“Earthquake XML”);  

setNotificationVisibility方法可以用来控制什么时候显示Notification,甚至是隐藏该request的Notification。有以下几个参数:

Request.VISIBILITY_VISIBLE:在下载进行的过程中,通知栏中会一直显示该下载的Notification,当下载完成时,该Notification会被移除,这是默认的参数值。

Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED:在下载过程中通知栏会一直显示该下载的Notification,在下载完成后该Notification会继续显示,直到用户点击该

Notification或者消除该Notification。

Request.VISIBILITY_VISIBLE_NOTIFY_ONLY_COMPLETION:只有在下载完成后该Notification才会被显示。

Request.VISIBILITY_HIDDEN:不显示该下载请求的Notification。如果要使用这个参数,需要在应用的清单文件中加上DOWNLOAD_WITHOUT_NOTIFICATION权限。

指定下载保存地址

默认情况下,所有通过Download Manager下载的文件都保存在一个共享下载缓存中,使用系统生成的文件名每一个Request对象都可以制定一个下载

保存的地址,通常情况下,所有的下载文件都应该保存在外部存储中,所以我们需要在应用清单文件中加上WRITE_EXTERNAL_STORAGE权限:

[html] view plain copy

  1. <uses-permission android:name=”android.permission.WRITE_EXTERNAL_STORAGE”/>  

下面的代码片段是在外部存储中指定一个任意的保存位置的方法:

[java] view plain copy

  1. request.setDestinationUri(Uri.fromFile(f));  

f是一个File对象。

如果下载的这个文件是你的应用所专用的,你可能会希望把这个文件放在你的应用在外部存储中的一个专有文件夹中。注意这个文件夹不提供访问控制,

所以其他的应用也可以访问这个文件夹。在这种情况下,如果你的应用卸载了,那么在这个文件夹也会被删除。

下面的代码片段是指定存储文件的路径是应用在外部存储中的专用文件夹的方法:

[java] view plain copy

  1. request.setDestinationInExternalFilesDir(this,  
  2.   Environment.DIRECTORY_DOWNLOADS, “Bugdroid.png”);  

如果下载的文件希望被其他的应用共享,特别是那些你下载下来希望被Media Scanner扫描到的文件(比如音乐文件),那么你可以指定你的下载路径在

外部存储的公共文件夹之下,下面的代码片段是将文件存放到外部存储中的公共音乐文件夹的方法:

[java] view plain copy

  1. request.setDestinationInExternalPublicDir(Environment.DIRECTORY_MUSIC,  
  2.   "Android_Rock.mp3");  

在默认的情况下,通过Download Manager下载的文件是不能被Media Scanner扫描到的,进而这些下载的文件(音乐、视频等)就不会在Gallery和

Music Player这样的应用中看到。

为了让下载的音乐文件可以被其他应用扫描到,我们需要调用Request对象的allowScaningByMediaScanner方法。

如果我们希望下载的文件可以被系统的Downloads应用扫描到并管理,我们需要调用Request对象的setVisibleInDownloadsUi方法,传递参数true。

取消和删除下载

Download Manager的remove方法可以用来取消一个准备进行的下载,中止一个正在进行的下载,或者删除一个已经完成的下载。

remove方法接受若干个download 的ID作为参数,你可以设置一个或者几个你想要取消的下载的ID,如下代码段所示:

[java] view plain copy

  1. downloadManager.remove(REFERENCE_1, REFERENCE_2, REFERENCE_3);  

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

查询Download Manager

你可以通过查询Download Manager来获得下载任务的状态,进度,以及各种细节,通过query方法返回一个包含了下载任务细节的Cursor。

query方法传递一个DownloadManager.Query对象作为参数,通过DownloadManager.Query对象的setFilterById方法可以筛选我们希望查询的下

载任务的ID。也可以使用setFilterByStatus方法筛选我们希望查询的某一种状态的下载任务,传递的参数是DownloadManager.STATUS_*常量,可以指定

正在进行、暂停、失败、完成四种状态。

Download Manager包含了一系列COLUMN_*静态String常量,可以用来查询Cursor中的结果列索引。我们可以查询到下载任务的各种细节,包括状态,

文件大小,已经下载的字节数,标题,描述,URI,本地文件名和URI,媒体类型以及Media Provider download URI。

下面的代码段是通过注册监听下载完成事件的广播接受者来查询下载完成文件的本地文件名和URI的实现方法:

[java] view plain copy

  1. @Override  
  2. public void onReceive(Context context, Intent intent) {  
  3.   long reference = intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, -1);  
  4.   if (myDownloadReference == reference) {  
  5.        
  6.     Query myDownloadQuery = new Query();  
  7.     myDownloadQuery.setFilterById(reference);  
  8.         
  9.     Cursor myDownload = downloadManager.query(myDownloadQuery);  
  10.     if (myDownload.moveToFirst()) {  
  11.       int fileNameIdx =   
  12.         myDownload.getColumnIndex(DownloadManager.COLUMN_LOCAL_FILENAME);  
  13.       int fileUriIdx =   
  14.         myDownload.getColumnIndex(DownloadManager.COLUMN_LOCAL_URI);  
  15.   
  16.       String fileName = myDownload.getString(fileNameIdx);  
  17.       String fileUri = myDownload.getString(fileUriIdx);  
  18.       
  19.       // TODO Do something with the file.  
  20.       Log.d(TAG, fileName + " : " + fileUri);  
  21.     }  
  22.     myDownload.close();  
  23.   
  24.   }  
  25. }  

对于暂停和失败的下载,我们可以通过查询COLUMN_REASON列查询出原因的整数码。

对于STATUS_PAUSED状态的下载,可以通过DownloadManager.PAUSED_*静态常量来翻译出原因的整数码,进而判断出下载是由于等待网络连接

还是等待WiFi连接还是准备重新下载三种原因而暂停。

对于STATUS_FAILED状态的下载,我们可以通过DownloadManager.ERROR_*来判断失败的原因,可能是错误码(失败原因)包括没有存储设备,

存储空间不足,重复的文件名,或者HTTP errors。

下面的代码是如何查询出当前所有的暂停的下载任务,提取出暂停的原因以及文件名称,下载标题以及当前进度的实现方法:

[java] view plain copy

  1. // Obtain the Download Manager Service.  
  2. String serviceString = Context.DOWNLOAD_SERVICE;  
  3. DownloadManager downloadManager;  
  4. downloadManager = (DownloadManager)getSystemService(serviceString);  
  5.   
  6. // Create a query for paused downloads.  
  7. Query pausedDownloadQuery = new Query();  
  8. pausedDownloadQuery.setFilterByStatus(DownloadManager.STATUS_PAUSED);  
  9.   
  10. // Query the Download Manager for paused downloads.  
  11. Cursor pausedDownloads = downloadManager.query(pausedDownloadQuery);  
  12.   
  13. // Find the column indexes for the data we require.  
  14. int reasonIdx = pausedDownloads.getColumnIndex(DownloadManager.COLUMN_REASON);  
  15. int titleIdx = pausedDownloads.getColumnIndex(DownloadManager.COLUMN_TITLE);  
  16. int fileSizeIdx =   
  17.   pausedDownloads.getColumnIndex(DownloadManager.COLUMN_TOTAL_SIZE_BYTES);      
  18. int bytesDLIdx =   
  19.   pausedDownloads.getColumnIndex(DownloadManager.COLUMN_BYTES_DOWNLOADED_SO_FAR);  
  20.   
  21. // Iterate over the result Cursor.  
  22. while (pausedDownloads.moveToNext()) {  
  23.   // Extract the data we require from the Cursor.  
  24.   String title = pausedDownloads.getString(titleIdx);  
  25.   int fileSize = pausedDownloads.getInt(fileSizeIdx);  
  26.   int bytesDL = pausedDownloads.getInt(bytesDLIdx);  
  27.   
  28.   // Translate the pause reason to friendly text.  
  29.   int reason = pausedDownloads.getInt(reasonIdx);  
  30.   String reasonString = "Unknown";  
  31.   switch (reason) {  
  32.     case DownloadManager.PAUSED_QUEUED_FOR_WIFI :   
  33.       reasonString = "Waiting for WiFi"break;  
  34.     case DownloadManager.PAUSED_WAITING_FOR_NETWORK :   
  35.       reasonString = "Waiting for connectivity"break;  
  36.     case DownloadManager.PAUSED_WAITING_TO_RETRY :  
  37.       reasonString = "Waiting to retry"break;  
  38.     default : break;  
  39.   }  
  40.   
  41.   // Construct a status summary  
  42.   StringBuilder sb = new StringBuilder();  
  43.   sb.append(title).append("\n");  
  44.   sb.append(reasonString).append("\n");  
  45.   sb.append("Downloaded ").append(bytesDL).append(" / " ).append(fileSize);  
  46.   
  47.   // Display the status   
  48.   Log.d("DOWNLOAD", sb.toString());  
  49. }  
  50.   
  51. // Close the result Cursor.  
  52. pausedDownloads.close();  

版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://blog.csdn.net/u010142437/article/details/73480953

智能推荐

Linux分布式编译环境搭建介绍_distccmon-gnome-程序员宅基地

文章浏览阅读9.4k次。1.Distcc介绍distcc是一个非常快且免费的分布式C/C++编译工具,distcc分为四个部分:distcc:distcc是一个类似客户端的程序,不过它的角色是个编译器,可以让C/C++代码在很多网络服务器上进行分布式的编译,就像本地编译一样,当然比本地编译快很多。distccd:distccd是一个守护进程,每个网络服务器上都需要安装这个守护进程,用来处理dist_distccmon-gnome

PE文件格式详解_pe文件格式的分析与构造hellope-程序员宅基地

文章浏览阅读1w次。三千风雨三千雪 三千风雪我在写流了一共三千血 你却始终不了解简介PE文件使用的是一个平面地址空间,所有的代码和数据都合并在一起,组成了一个很大的结构;文件被分为不同的区块(Section,又成为区段或节等),区块中包含代码和数据,各个区块按页边界对齐;区块没有大小限制,是一个连续结构;每一个块都有其自己的属性,如是否包含代码,是否可读可写等;PE文件的构成MS-DOS头部每个..._pe文件格式的分析与构造hellope

JavaScript中的onload详解_javascript onload-程序员宅基地

文章浏览阅读6.7k次,点赞3次,收藏14次。初心-杨瑞超个人博客诚邀您加入qq群(IT-程序猿-技术交流群):757345416下面我们先写代码:&lt;!DOCTYPE html&gt;&lt;html lang="en"&gt;&lt;head&gt; &lt;meta charset="UTF-8"&gt; &lt;title&gt;Document&lt;/title&gt_javascript onload

如何还原已经推送到远程分支的合并提交?_git revert <commit-hash>-程序员宅基地

文章浏览阅读1k次。单独使用git revert <commit_hash>无效。 -m必须被指定,对此我感到很困惑。 有人经历过吗? _git revert

leetcode4-寻找两个正序数组的中位数(困难)-程序员宅基地

文章浏览阅读963次。寻找两个正序数组的中位数题目描述我的解题思路代码时间复杂度官方题解-划分数组代码时间复杂度力扣链接题目描述给定两个大小分别为 m 和 n 的正序(从小到大)数组nums1 和 nums2。请你找出并返回这两个正序数组的 中位数 。示例 1:输入:nums1 = [1,3], nums2 = [2]输出:2.00000解释:合并数组 = [1,2,3] ,中位数 2示例 2:输入:nums1 = [1,2], nums2 = [3,4]输出:2.50000解释:合并数组 = [1,2,

PS的混合模式详解_什么模式可以在为底层轨道中的图像颜色-程序员宅基地

文章浏览阅读940次。混合模式是PS最强大的功能之一,它决定了当前图像中的像素如何与底层图像中的像素混合,使用混合模式可以轻松地制作出许多特殊的效果,但是要真正掌握它却不是一件容易的事。将混合模式分为六大类,即:一.组合模式(正常、溶解)二.加深混合模式(变暗、正片叠底、颜色加深、线性加深)三.减淡混合模式(变亮、滤色、颜色减淡、线性减淡)四.对比混合模式(叠加、柔光_什么模式可以在为底层轨道中的图像颜色

随便推点

合泰杯 | 合泰单片机入门 定时器详解(三)_合泰单片机定时器怎么用-程序员宅基地

文章浏览阅读1w次,点赞22次,收藏90次。说在前面:好久没有更新是因为一直在忙,想必关注这个系列博文的都是参加合泰公司比赛的小伙伴,后台有好些小伙伴给我私我什么时候更新,这里先道个歉,不好意思久等了。人啊,知道的越多就越迷茫,所以做一个“无知“”的人是多么的快乐啊!!!好的言归正传,我们今天要说的就是合泰单片机的定时器功能。一、定时器模块 – TM介绍分类控制和测量时间在任何单片机中都是一个很重要的部分。该系列单片机(注..._合泰单片机定时器怎么用

常用CSS样式_常用的css样式,你知道的有哪些,请标清序号,先用文字说明作用,再写出代码?-程序员宅基地

文章浏览阅读134次。css概述Cascading Style Sheets, 层叠样式表,又叫级联样式表,简称样式表。给HTML标签添加样式, 美化网页css 的三种引入方式2.1 行内样式或内联样式特点:在HTML标签上进行样式的声明语法:<Any style="样式声明;color:red;样式声明"></Any>样式声明:属性名:属性值缺点:结构(html)与..._常用的css样式,你知道的有哪些,请标清序号,先用文字说明作用,再写出代码?

《嵌入式程序员应该知道的16个问题》_non volatile embedded data base干嘛用的-程序员宅基地

文章浏览阅读866次。全面解析《嵌入式程序员应该知道的16个问题》 全面解析《嵌入式程序员应该知道的 16 个问题》----Sailor_forever 分析整理, [email protected]://blog.csdn.net/sailor_8318/archive/2008/03/25/2215041.aspx 1、预处理器( Preprocessor)2_non volatile embedded data base干嘛用的

九宫格-程序员宅基地

文章浏览阅读62次。九宫格对于九宫格的设置,我布置了三个xml页面和四个java类。activity_main布局:<?xml version="1.0" encoding="utf-8"?><LinearLayout ="http://schemas.android.com/apk/res/android" xmlns:tools="http://sch..._在fragment怎么应用写的九宫格

asp.net小说网系统VS开发物业sqlserver数据库web结构c#编程计算机网页源码项目_asp.net小说网站项目特色-程序员宅基地

文章浏览阅读602次。一、源码特点 asp.net小说网系统是一套完善的web设计管理系统,系统具有完整的源代码和数据库,系统主要采用B/S模式开发,开发环境为vs2010,数据库为sqlserver2008,或者以上版本都可以,使用c#语言开发。asp.net物流信息管理系统VS开发物业sqlserver数据库web结构c#编程计算机网页源码项目-管理软件文档类资源-CSDN下载、源码特点asp.net物流信息管理系统是一套完善的web设计管理系统,系统具有完更多下载资源、学习资料请访问CSDN下载频道.h..._asp.net小说网站项目特色