原始完成于：2014-10-24 20:01:03
DownloadManager是一个处理HTTP下载请求的系统服务：
1. 基本用法
1 private void download() {
2 Request request = new Request(Uri.parse("http://files.cnblogs.com/wlrhnh/JeejenKnowledge-15793-release.apk"));
3 request.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, "4444.zip");
4 request.setNotificationVisibility(Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
5 long id = mDownloadMgr.enqueue(request);
6 Log.d("MMLL", "下载 id = " + id);
7 }
绿色代码指定文件下载路径，如果不指定，那么默认下载在“/data/data/com.android.providers.downloads/cache/***.apk”。代码中的id是个非常重要的属性，它表示DownloadManager给这次下载指定的ID，同时也是该文件在数据库中的column_id。默认行为，下载完成后Notification会自动消失；
红色代码表示下载完成后，Notification仍旧显示在下拉列表中，该API只能在API 11之后调用。
2. 获取下载文件的信息
API 11中新增了一个API，可以直接去到下载文件的Uri，如下：
1 Uri uri = mDownloadMgr.getUriForDownloadedFile(_id); 2 uri = file:///storage/emulated/0/Download/4444-4.zip //指定路径 3 uri = content://downloads/my_downloads/118 //默认路径
代码中红色log指的分别是指定路径和默认路径下得到的Uri，但是在API 低于11的系统中怎么使用呢？
DownloadManager提供了Query接口，代码如下：
1 int _id = -1;
2 String local_filename = null;
3 String local_uri = null;
4 Query query = new Query();
5 Cursor cursor = mDownloadMgr.query(query);
6 if (cursor != null) {
7 cursor.moveToFirst();
8 _id = cursor.getInt(cursor.getColumnIndex("_id"));
9 local_filename = cursor.getString(cursor.getColumnIndex("local_filename"));
10 local_uri = cursor.getString(cursor.getColumnIndex("local_uri"));
11 }
上面代码中得到的Cursor的数量为1，且就是自己应用程序中调用DownloadManager下载的最新一次文件信息， 可以看到query既没有设置Uri，也没有指定_id,那怎么返回这唯一的一条信息呢？其实在生成query时有一些默认值，其中Uri如下：
1 /**
2 * The content:// URI to access downloads owned by the caller‘s UID.
3 */
4 public static final Uri CONTENT_URI = Uri.parse("content://downloads/my_downloads");
而且秘密就在注释中，查询时会更据caller的UID，所以才会返回自己下载的文件的信息；
cursor的全部Column如下：
1 D/MMLL (16614): column = _id 2 D/MMLL (16614): column = local_filename 3 D/MMLL (16614): column = mediaprovider_uri 4 D/MMLL (16614): column = destination 5 D/MMLL (16614): column = title 6 D/MMLL (16614): column = description 7 D/MMLL (16614): column = uri 8 D/MMLL (16614): column = status 9 D/MMLL (16614): column = hint 10 D/MMLL (16614): column = media_type 11 D/MMLL (16614): column = total_size 12 D/MMLL (16614): column = last_modified_timestamp 13 D/MMLL (16614): column = bytes_so_far 14 D/MMLL (16614): column = local_uri 15 D/MMLL (16614): column = reason 16 D/MMLL (16614): column = bypass_recommended_size_limit 17 D/MMLL (16614): column = allowed_network_types 18 D/MMLL (16614): column = entity
对应的值如下：
1 D/MMLL (22053): cursor.getString(0) = 107 2 D/MMLL (22053): cursor.getString(0) = /data/data/com.android.providers.downloads/cache/4_lauchmode.zip 3 D/MMLL (22053): cursor.getString(0) = null 4 D/MMLL (22053): cursor.getString(0) = 2 5 D/MMLL (22053): cursor.getString(0) = 4_lauchmode.zip 6 D/MMLL (22053): cursor.getString(0) = 7 D/MMLL (22053): cursor.getString(0) = http://files.cnblogs.com/wlrhnh/4_lauchmode.zip 8 D/MMLL (22053): cursor.getString(0) = 200 9 D/MMLL (22053): cursor.getString(0) = null 10 D/MMLL (22053): cursor.getString(0) = application/zip 11 D/MMLL (22053): cursor.getString(0) = 1315681 12 D/MMLL (22053): cursor.getString(0) = 1414137592255 13 D/MMLL (22053): cursor.getString(0) = 1315681 14 D/MMLL (22053): cursor.getString(0) = content://downloads/my_downloads/107 15 D/MMLL (22053): cursor.getString(0) = placeholder 16 D/MMLL (22053): cursor.getString(0) = 0 17 D/MMLL (22053): cursor.getString(0) = -1 18 D/MMLL (22053): cursor.getString(0) = null
或者
1 D/MMLL ( 8796): cursor.getString(0) = 113 2 D/MMLL ( 8796): cursor.getString(0) = /storage/emulated/0/Download/4444.zip 3 D/MMLL ( 8796): cursor.getString(0) = content://media/external/file/34731 4 D/MMLL ( 8796): cursor.getString(0) = 4 5 D/MMLL ( 8796): cursor.getString(0) = 4444.zip 6 D/MMLL ( 8796): cursor.getString(0) = 7 D/MMLL ( 8796): cursor.getString(0) = http://files.cnblogs.com/wlrhnh/4_lauchmode.zip 8 D/MMLL ( 8796): cursor.getString(0) = 200 9 D/MMLL ( 8796): cursor.getString(0) = file:///storage/emulated/0/Download/4444.zip 10 D/MMLL ( 8796): cursor.getString(0) = application/zip 11 D/MMLL ( 8796): cursor.getString(0) = 1315681 12 D/MMLL ( 8796): cursor.getString(0) = 1414149416875 13 D/MMLL ( 8796): cursor.getString(0) = 1315681 14 D/MMLL ( 8796): cursor.getString(0) = file:///storage/emulated/0/Download/4444.zip 15 D/MMLL ( 8796): cursor.getString(0) = placeholder 16 D/MMLL ( 8796): cursor.getString(0) = 0 17 D/MMLL ( 8796): cursor.getString(0) = -1 18 D/MMLL ( 8796): cursor.getString(0) = null
3. 监听下载状态的BroadCast，代码如下：
1 private void regisiterBroadCast() {
2 IntentFilter intentFilter = new IntentFilter();
3 intentFilter.addAction(DownloadManager.ACTION_DOWNLOAD_COMPLETE);
4 intentFilter.addAction(DownloadManager.ACTION_NOTIFICATION_CLICKED);
5 intentFilter.addAction(DownloadManager.ACTION_VIEW_DOWNLOADS);
6
7 this.registerReceiver(new BroadcastReceiver() {
8 @Override
9 public void onReceive(Context context, Intent intent) {
10 if (intent != null) {
11 Log.d("MMLL", "intent.getAction = " + intent.getAction());
12 Bundle bundle = intent.getExtras();
13 if (DownloadManager.ACTION_DOWNLOAD_COMPLETE.equals(intent.getAction())) {
14 Log.d("MMLL", "ACTION_DOWNLOAD_COMPLETE");
15 } else if (DownloadManager.ACTION_NOTIFICATION_CLICKED.equals(intent.getAction())) {
16 Log.d("MMLL", "ACTION_NOTIFICATION_CLICKED");
17 } else if (DownloadManager.ACTION_VIEW_DOWNLOADS.equals(intent.getAction())) {
18 Log.d("MMLL", "ACTION_VIEW_DOWNLOADS");
19 }
20 }
21 }
22 }, intentFilter);
23 }
除了下载完成后发送的广播能接受到之外，其他的两个广播暂时还收不到，待研究；
4. 如果下载的是APK，并且药调用Installer来安装，安装的代码如下：
1 private void installApk(Uri uri) {
2 Intent intent = new Intent(Intent.ACTION_VIEW);
3 intent.setDataAndType(uri, "application/vnd.android.package-archive");
4 startActivity(intent);
5 }
可见需要传入一个Uri，在前面的分析中，我们知道设置下载路径和默认下载路径返回的Uri是不一样的，
1 uri = file:///storage/emulated/0/Download/4444-4.zip //指定路径 2 uri = content://downloads/my_downloads/118 //默认路径
此时第一个uri传进去是可以正常安装的，但是第二个uri则不行，会提示“包解析失败”神马的，因此，如果下载的是APK，那么最好还是指定一下下载路径；
5. 那么在API 11之前如何获取Uri呢？
有两种方式：
1>. 前面提到的查询数据库，字段是local_uri
2>. 有一种比较复杂的方式，仅供参考：
1 public Uri getDownloadFile() {
2 long downloadId = getDownloadId();
3 int status = queryDownloadStatus(downloadId);
4 if (DownloadManager.STATUS_SUCCESSFUL == status) {
5 if (Build.VERSION.SDK_INT >= 11) {
6 return mDownloadMgr.getUriForDownloadedFile(downloadId);
7 } else {
8 FileOutputStream outStream = null;
9 ParcelFileDescriptor.AutoCloseInputStream instream = null;
10 try {
11 ParcelFileDescriptor desc = mDownloadMgr.openDownloadedFile(downloadId);
12 instream = new ParcelFileDescriptor.AutoCloseInputStream(desc);
13
14 String fileName = Environment.getExternalStorageDirectory().getAbsolutePath().toString();
15 fileName += "/jeejen/" + Calendar.getInstance().getTimeInMillis() + "_" + downloadId + ".apk";
16 File file = new File(fileName);
17 if (!file.getParentFile().exists()) {
18 file.getParentFile().mkdirs();
19 }
20 file.createNewFile();
21 outStream = new FileOutputStream(file);
22 byte[] buffer = new byte[1024];
23 int read;
24
25 while ((read = instream.read(buffer)) != -1) {
26 outStream.write(buffer, 0, read);
27 }
28
29 return Uri.fromFile(file);
30 } catch (Exception e) {
31 e.printStackTrace();
32 return null;
33 } finally {
34 try {
35 if (outStream != null) {
36 outStream.close();
37 }
38 } catch (Exception e) {
39 }
40 try {
41 if (instream != null) {
42 instream.close();
43 }
44 } catch (Exception e) {
45 }
46 }
47 }
48 }
49 return null;
50 }
个人觉得这种方式比较复杂，但不失为一种思路。比较简单粗暴的方式是：
1 private void copyToSD(String path) {
2 FileInputStream inputStream = null;
3 FileOutputStream outputStream = null;
4 try {
5 inputStream = new FileInputStream(path);
6 outputStream = new FileOutputStream("sdcard/jeejen/大卫.zip");
7 byte[] bb = new byte[1024];
8 int count = -1;
9 while ((count = inputStream.read(bb)) != -1) {
10 outputStream.write(bb, 0, count);
11 }
12 outputStream.flush();
13 } catch (FileNotFoundException e) {
14 e.printStackTrace();
15 } catch (IOException e) {
16 e.printStackTrace();
17 } finally {
18 if (inputStream != null) {
19 try {
20 inputStream.close();
21 } catch (IOException e) {
22 e.printStackTrace();
23 }
24 }
25 if (outputStream != null) {
26 try {
27 outputStream.close();
28 } catch (IOException e) {
29 e.printStackTrace();
30 }
31 }
32 }
33 }
把local_filename字段对应的值传进去即可；
6. 如何获取当前下载进度？
获取进度的基本原理是注册一个ContentObserver，因为伴随着下载，会往数据库中写入下载文件的大小和当前下载完成的大小。代码如下：
1 private void getProgress(long id) {
2 long total_size = -1L;
3 long bytes_so_far = -1L;
4 Query query = new Query().setFilterById(id);
5 Cursor cur = mDownloadMgr.query(query);
6 if (cur != null && cur.moveToFirst()) {
7 do {
8 total_size = cur.getLong(cur.getColumnIndex("total_size"));
9 bytes_so_far = cur.getLong(cur.getColumnIndex("bytes_so_far"));
10 Log.d("MMLL", "bytes_so_far = " + bytes_so_far + ", total_size = " + total_size);
11 } while (cur.moveToNext());
12 }
13 }
14
15 private class DownloadChangeObserver extends ContentObserver {
16
17 public DownloadChangeObserver(Handler handler) {
18 super(handler);
19 }
20
21 @Override
22 public void onChange(boolean selfChange) {
23 super.onChange(selfChange);
24 getProgress(id);
25 }
26
27 /*@Override
28 public void onChange(boolean selfChange, Uri uri) {
29 super.onChange(selfChange, uri);
30 }*/
31
32 }
然后注册，如下：
1 getContentResolver().registerContentObserver(Uri.parse("content://downloads/my_downloads"), true, new DownloadChangeObserver(null));
OK，至此Over
时间： 2024-10-06 23:12:33