文档章节

android webview downloadManager文件下载管理

simpower
 simpower
发布于 2014/09/29 22:33
字数 1658
阅读 524
收藏 3

一。downloadmanager类说明:

从Android 2.3开始新增了一个下载管理类,在SDK的文档中我们查找android.app.DownloadManager可以看到。下载管理类可以长期处理多个HTTP下载任务,客户端只需要给出请求的Uri和存放目标文件的位置即可,下载管理使用了一个AIDL服务器所以可以放心的在后台执行,同时实例化的方法需要使用getSystemService(Context.DOWNLOAD_SERVICE) ,Android123再次提醒使用API Level为9的用户可以轻松的通过新增的这个API实现Android平台上的文件下载操作。

DownloadManager类提供了以下几种方法来处理,

 

Java代码    long  enqueue(DownloadManager.Request request)   //存入队列一个新的下载项 
 
ParcelFileDescriptor  openDownloadedFile(long id)  //打开一个下载后的文件用于读取,参数中的long型id是一个provider中的一条记录。 
 
Cursor  query(DownloadManager.Query query)  //查询一个下载,返回一个Cursor 
 
int  remove(long... ids)  //取消下载同时移除这些条从下载管理中。 

  我们可以看到提供的方法都比较简单,给我们操作的最终封装成为一个provider数据库的方式进行添加、查询和移除,但是对于查询和添加任务的细节,我们要看看DownloadManager.Request类和DownloadManager.Query 类了。

  一、DownloadManager.Request类的成员和定义
Java代码  DownloadManager.Request  addRequestHeader(String header, String value)  // 添加一个Http请求报头,对于这两个参数,Android开发网给大家举个小例子,比如说User-Agent值可以为Android123或 Windows XP等等了,主要是给服务器提供标识。 
DownloadManager.Request  setAllowedNetworkTypes(int flags)  //设置允许使用的网络类型,这一步Android 2.3做的很好,目前有两种定义分别为NETWORK_MOBILE和NETWORK_WIFI我们可以选择使用移动网络或Wifi方式来下载。 
DownloadManager.Request  setAllowedOverRoaming(boolean allowed)  //对于下载,考虑到流量费用,这里是否允许使用漫游。 
DownloadManager.Request  setDescription(CharSequence description)  //设置一个描述信息,主要是最终显示的notification提示,可以随便写个自己区别 
DownloadManager.Request  setDestinationInExternalFilesDir(Context context, String dirType, String subPath)  //设置目标存储在外部目录,一般位置可以用 getExternalFilesDir()方法获取。 
DownloadManager.Request  setDestinationInExternalPublicDir(String dirType, String subPath)  //设置外部存储的公共目录,一般通过getExternalStoragePublicDirectory()方法获取。 
DownloadManager.Request  setDestinationUri(Uri uri)  //设置需要下载目标的Uri,可以是http、ftp等等了。 
DownloadManager.Request  setMimeType(String mimeType)  //设置mime类型,这里看服务器配置,一般国家化的都为utf-8编码。 
DownloadManager.Request  setShowRunningNotification(boolean show)  //是否显示下载进度的提示 
DownloadManager.Request  setTitle(CharSequence title)  //设置notification的标题 
DownloadManager.Request  setVisibleInDownloadsUi(boolean isVisible)  //设置下载管理类在处理过程中的界面是否显示 

  当然了Google还提供了一个简单的方法来实例化本类,这个构造方法为DownloadManager.Request(Uri uri) ,我们直接填写一个Uri即可,上面的设置使用默认情况。

二、DownloadManager.Query类

  对于当前下载内容的状态,我们可以使用DownloadManager.Query类来获取,本类比较简单,仅仅提供了两个方法。
Java代码  DownloadManager.Query  setFilterById(long... ids)  //根据id来过滤查找。 
DownloadManager.Query  setFilterByStatus(int flags) //根据任务的状态来查找。 

  详细的状态在android.app.DownloadManager类中有定义,目前Android 2.3中的定义为:

Java代码  int STATUS_FAILED 失败 
int STATUS_PAUSED 暂停 
int STATUS_PENDING 等待将开始 
int STATUS_RUNNING 正在处理中 
int STATUS_SUCCESSFUL 已经下载成功 

最后Android开发网提醒大家要说的是因为DownloadManager类提供的query方法返回一个Cursor对象,这些状态保存在这个游标的COLUMN_STATUS 字段中。

  1. 下载的状态完成均是以广播的形式通知大家,目前API Level为9定义了下面三种Intent的action
Java代码  ACTION_DOWNLOAD_COMPLETE下载完成的动作。 
ACTION_NOTIFICATION_CLICKED 当用户单击notification中下载管理的某项时触发。 
ACTION_VIEW_DOWNLOADS 查看下载项 

  2. 对于一个尚未完成的项,在Cursor中我们查找COLUMN_REASON字段,可能有以下定义:
Java代码  int ERROR_CANNOT_RESUME 不能够继续,由于一些其他原因。 
int ERROR_DEVICE_NOT_FOUND 外部存储设备没有找到,比如SD卡没有插入。 
int ERROR_FILE_ALREADY_EXISTS 要下载的文件已经存在了,Android123提示下载管理类是不会覆盖已经存在的文件,所以如果需要重新下载,请先删除以前的文件。 
 
int ERROR_FILE_ERROR 可能由于SD卡原因导致了文件错误。 
int ERROR_HTTP_DATA_ERROR 在Http传输过程中出现了问题。 
int ERROR_INSUFFICIENT_SPACE 由于SD卡空间不足造成的  
 
int ERROR_TOO_MANY_REDIRECTS 这个Http有太多的重定向,导致无法正常下载 
int ERROR_UNHANDLED_HTTP_CODE 无法获取http出错的原因,比如说远程服务器没有响应。 
int ERROR_UNKNOWN 未知的错误类型. 

3. 有关暂停的一些状态,同样COLUMN_REASON字段的值可能是以下定义
Java代码  int PAUSED_QUEUED_FOR_WIFI 由于移动网络数据问题,等待WiFi连接能用后再重新进入下载队列。 
int PAUSED_UNKNOWN 未知原因导致了任务下载的暂停. 
int PAUSED_WAITING_FOR_NETWORK 可能由于没有网络连接而无法下载,等待有可用的网络连接恢复。. 
int PAUSED_WAITING_TO_RETRY 由于重重原因导致下载暂停,等待重试。 

  有关Android 2.3中新增的下载管理DownloadManager的介绍基本上已经完全讲完,如果你对Cursor、Provider这些基础概念了解的话,可以看到这个下载管理类可以帮我们减少很多不必要的代码编写

 


二。用downloadManager 下载:


    public void onDownloadStart(String url, String userAgent,
            String contentDisposition, String mimetype, long contentLength) {

        AppUtils.LogD(mimetype);

        // download file
        DownloadManager downloadManager = ((DownloadManager) activity
                .getSystemService(Activity.DOWNLOAD_SERVICE));
        Request request = new Request(Uri.parse(url));


        // set request header, 如session等 www.2cto.com
            request.addRequestHeader("Accept",
                    "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8");
            request.addRequestHeader("Accept-Language", "en-us,en;q=0.5");
            request.addRequestHeader("Accept-Encoding", "gzip, deflate");
            request.addRequestHeader("Accept-Charset",
                    "ISO-8859-1,utf-8;q=0.7,*;q=0.7");
            request.addRequestHeader("Cache-Control", "max-age=0");

            String host = "";
            try {
                host = new URL(url).getHost();
            } catch (MalformedURLException e) {
                e.printStackTrace();
            }

            String cookieStr = CookieManager.getInstance().getCookie(host);
            if (!AppUtils.isEmpty(cookieStr)) {
                request.addRequestHeader("Cookie", cookieStr + "; AcSe=0");
            }

            // generate filename dynamically
            String fileName = contentDisposition.replaceFirst(
                    "attachment; filename=", "");
            request.setDestinationInExternalPublicDir(
                    Environment.DIRECTORY_DOWNLOADS, fileName);

        downloadManager.enqueue(request);
    }

 


三。判断download finished:


        BroadcastReceiver receiver = new BroadcastReceiver() {
            @Override
            public void onReceive(Context context, Intent intent) {
                String action = intent.getAction();
                if (DownloadManager.ACTION_DOWNLOAD_COMPLETE.equals(action)) {
                    long downloadId = intent.getLongExtra(
                            DownloadManager.EXTRA_DOWNLOAD_ID, 0);
                    Query query = new Query();
                    query.setFilterById(enqueue);
                    Cursor c = dm.query(query);
                    if (c.moveToFirst()) {
                        int columnIndex = c
                                .getColumnIndex(DownloadManager.COLUMN_STATUS);
                        if (DownloadManager.STATUS_SUCCESSFUL == c
                                .getInt(columnIndex)) {
 
                            ImageView view = (ImageView) findViewById(R.id.imageView1);
                            String uriString = c
                                    .getString(c
                                            .getColumnIndex(DownloadManager.COLUMN_LOCAL_URI));
                            view.setImageURI(Uri.parse(uriString));
                        }
                    }
                }
            }
        };
 
        registerReceiver(receiver, new IntentFilter(
                DownloadManager.ACTION_DOWNLOAD_COMPLETE));

四。获取系统download history list:

            Intent i = new Intent(DownloadManager.ACTION_VIEW_DOWNLOADS);
            startActivity(i);

 


五。 获得刚下载的文件 和 打开该文件:

    protected String getDownloadedFileName() {

        String fileName = "";

        DownloadManager downloadManager = (DownloadManager) activity
                .getSystemService(Activity.DOWNLOAD_SERVICE);
        DownloadManager.Query query = new DownloadManager.Query();
        query.setFilterByStatus(DownloadManager.STATUS_SUCCESSFUL);

        Cursor c = downloadManager.query(query);
        if (c.moveToFirst()) {
            fileName = c.getString(c
                    .getColumnIndex(DownloadManager.COLUMN_TITLE));
        }

        return fileName;
    }

 

    public void openFileFromSDCard(String fileStr, String mimeType) {
        Intent intent = new Intent();
        intent.setAction(android.content.Intent.ACTION_VIEW);
        File file = new File(fileStr);
        intent.setDataAndType(Uri.fromFile(file), mimeType);
        activity.startActivity(intent);
    }

 

 

摘自 fhy_2008的专栏


本文转载自:http://www.2cto.com/kf/201205/132327.html

共有 人打赏支持
simpower
粉丝 25
博文 539
码字总数 38749
作品 0
海淀
程序员
android 默认浏览器 无法下载,此手机不支持此内容(自定义文件or APK文件看过了)

如果你是apk或者android系统可以识别的问题,那么一定是服务器MIME文件类型没有配置正确 APK文件配置如下: <mime-mapping> </mime-mapping> 其他文件请参考MIME配置对照表 下面是android不能...

补全
2014/01/19
0
0
调用android自带的下载功能,进度在消息通知栏上显示

public class CompleteReceiver extends BroadcastReceiver { private DownloadManager downloadManager = null; @Override public void onReceive(Context context, Intent intent) { try {......

jeremy_C
2014/03/11
0
0
总结的一些android公共库

最新最准确内容建议直接访问原文:Android公共库(缓存 下拉ListView 下载管理Pro 静默安装 root运行 Java公共类) 介绍总结的一些android公共库,包含缓存(图片缓存、预取缓存)、公共View(下拉...

Trinea
2012/07/16
0
1
Unknown URL content://downloads/my_downloads

在使用Android系统下载管理DownloadManager时,部分手机会报如下错误: W/System.err﹕ java.lang.IllegalArgumentException: Unknown URL content://downloads/my_downloads 而抛出此异常的...

chuxuezhe_
2015/10/30
0
0
Android app 在线更新那点事儿(适配Android6.0、7.0、8.0)

一、前言 app在线更新是一个比较常见需求,新版本发布时,用户进入我们的app,就会弹出更新提示框,第一时间更新新版本app。在线更新分为以下几个步骤: 在线更新就上面几个步骤,前2步比较简...

codeGoogle
04/28
0
0

没有更多内容

加载失败,请刷新页面

加载更多

ERC1155实践|区块链游戏的平行宇宙和为此而生的Enjin钱包

1 摘要 恩金(Enjin)花了大半年的时间一直在完善ERC-1155这个通证协议,毫不夸张地说,该标准是现有以太坊上最适用于游戏资产的通证标准,将主流游戏中道具涉及到的一切操作经过高度抽象之后...

HiBlock
29分钟前
1
0
Oracle发布开源的轻量级 Java 微服务框架 Helidon

近日,Oracle推出了一个新的开源框架Helidon,该项目是一个用于创建基于微服务的应用程序的Java库集合。和Payara Micro、Thorntail(之前的WildFly Swarm)、OpenLiberty、TomEE等项目一样,...

关注公众号_搜云库_每天更新
35分钟前
1
0
启动线程以及安全终止线程

启动 使用start()方法可以启动线程。 start()方法的含义是告知线程规划器线程已初始化完毕,可以分给这个线程时间片了(执行run()方法)。 安全终止线程 示例代码 import java.util.concurr...

karma123
41分钟前
1
0
Python+OpenCV 图像风格迁移(模仿名画)

现在很多人都喜欢拍照(自拍)。有限的滤镜和装饰玩多了也会腻,所以就有 APP 提供了模仿名画风格的功能,比如 prisma、versa 等,可以把你的照片变成 梵高、毕加索、蒙克 等大师的风格。 这...

crossin
46分钟前
1
0
karabiner json语法

karabiner json语法 to_if_alone 如果同时制定了to, 那么to对应的key必须是非可见字符,例如control,shift或者command, 为什么呢? If to events are specified, to events are released befo...

黄威
47分钟前
1
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部