DownloadManager实现文件下载

前言

    关于文件下载，或许不是一个多么陌生的内容，在网络操作中下载只是其中一个方面，但是关于文件下载还是有不少东西要说，今天我就拿下载的方式来说吧。
    文件下载有许多方式，比如什么多线程下载，单线程下载等等，我刚开始接触文件下载的时候是看了一个《关于文件多线程下载原理》的一个视频，里面讲了什么是多线程下载，然后就是自己写一个下载类，实现文件下载，虽然最后也是能够实现下载，但是效果并不是多么的好，有时候文件无法下载成功，那时候我就想应该有封装好的工具来帮助实现下载。确实，后来百度了一下，我找到许多的第三方jar包来实现下载，其中Afinal框架是我一直在用的，还不错。不想每一次都是用第三方的东西，android系统应该自己拥有下载的工具类，然后就是我们今天要讲的 DownloadManager了。
    接触DownloadManager是因为我前一段时间在写自己的一个音乐播放器，需要从网络获取歌曲并下载，这个时候我就想找一个简单是用的下载方式然后就认识了它，关于它的使用我还没做具体的深究，只是把它用在了自己的应用里面，现在写出来分享一下当时是怎么做的。

实现

    下载我主要关心三个方面的内容：

• 从哪来
• 到哪去
• 完成之后的操作

    这三方面的内容就是最重要的，下面我就下载一首歌来进行说明：
    我们首先需要得到DownloadManager的一个实例，它既然是系统提供的服务，自然需要用getSystemService来得到了。
    DownloadManager manager = (DownloadManager) getSystemService(Context.DOWNLOAD_SERVICE);
    得到manager对象之后我们就需要一个下载请求，把下载的信息（也即“从哪来”，“到哪去”）设置进去。下载请求是DownloadManager的一个内部类Request，我们先生成Request的对象：DownloadManager.Request request = new DownloadManager.Request(Uri.parse(url));可以看到Request的一个构造函数传入的是一个Uri对象，我们调用Uri的静态方法来根据下载的Url得到一个Uri对象，这也就是我们说的”从哪来“。
    下面还有三个Request的三个方法需要我们调用：

• setTitle(String title)
• setDescription(String desc)
• setNotificationVisibility(int flag)

    其中setTitle是设置下载的标题，setDescription设置下载描述，示例图如下：

    其中”Nobody“是标题，“WonderGirls”是描述。
    setNotificationVisibility方法就需要好好说说了，它的参数有四种情况：

• 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权限。

    我们根据需要选择合适的参数，如果我们不希望下载的时候显示进度，那么我们就可以设置Request.VISIBILITY_HIDDEN，这样在下载的时候我们就看不到通知了，不过这样的坏处是我们就无法知道下载是否成功了。

    ”从哪来“的问题解决了，现在我们来看”到哪去“的问题：setDestinationUri这个函数用来设置下载路径，参数是一个Uri对象，使用如下：

    String path = "/storage/sdcard1/music/许嵩 - 幻听.mp3";
    File file = new File(path);
    Uri uri = Uri.fromFile(file);
    request.setDestinationUri(uri);

这样我们就设置好了下载的路径。
    Request设置好了之后我们就可以调用manager的方法开始下载了：
    manager.enqueue(request);这个方法就是把下载请求放到一个队列里面然后就开始下载，它有一个返回值，这个返回值是一个下载id，用来唯一标示这一次的下载，在下面我们会用到这个id，我们把它记为mDownloadID；

    最后就剩下载完成之后的情况了，下载完成之后我们可能还会有操作，比如下载完成之后打开文件等等，就像我们看到了一些软件进行升级，下载完成apk文件之后就直接打开安装，这都是下载完成之后的操作，那么该如何实现呢？

    原来DownloadManager在下载完成之后会发送一个广播，我们只需要注册一个广播接收器得到广播就可以进行我们自己的操作了。

IntentFilter filter = new IntentFilter(DownloadManager.ACTION_DOWNLOAD_COMPLETE);
    BroadcastReceiver receiver = new BroadcastReceiver() {
        @Override
        public void onReceive(Context context, Intent intent) {
            long reference = intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, -1);
            if (mDownloadID == reference){
                Intent i = new Intent();
                i.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
                i.setAction(Intent.ACTION_VIEW);
                String type = "application/vnd.android.package-archive";
                i.setDataAndType(Uri.fromFile(file),type);
                mContext.startActivity(i);
            }
        }
    };
    mContext.registerReceiver(receiver, filter);

    这样我们就自己注册了一个广播接收器，用来接收下载完成之后发送的广播，接收到之后我们就直接打开文件，在代码中，我设置的是打开apk文件，即设置文件类型为”application/vnd.android.package-archive“，其中mDownloadID就是我们得到的那个下载ID，这样我们实现了文件的下载和打开。

小结

    这样看来文件下载并不是多么的复杂，当然我们只是站在用代码的角度，如果让我们自己去写下载源码，呵呵，无能为力了。