本文主要介绍在OPhone中如何实现文件的下载、暂停、恢复、重试以及清除。我们仅仅使用ContentResolver的insert、query、update、delete就可以完成上述功能。对于上层的开发者来说,下载的启动、进行、完成、出错仅仅体现在数据库中对应下载记录的这一行数据的变化。下面我们分别看一下。
1、 下载
- UricontentUri=getContentResolver().insert(
- Uri.parse("content://downloads/download"),values);
这里,
Uri.parse("content://downloads/download")就是对应的数据库表,它实际的位置在
什么地方呢,让我们看看:
..
如上黑体字,
downloads这个表对外的接口就是这个uri,稍后我们会在不同的状态时看看表里数据有什么变化。
我们继续看第二个参数,
values是一个ContentValues对象,这里面存放着我们本次下载的信息也就是downloads表中该行的输入数据。
- ContentValuesvalues=@H_301_130@newContentValues();
- values.put(Downloads.COLUMN_TITLE,filename);
- values.put(Downloads.COLUMN_URI,url);
- values.put(Downloads.COLUMN_FILE_NAME_HINT,filename);
- values.put(Downloads.COLUMN_NOTIFICATION_PACKAGE,getPackageName());
- values.put(Downloads.COLUMN_NOTIFICATION_CLASS,
- TestDownload.DownloadReceiver.@H_301_130@class.getName());
- values.put(Downloads.COLUMN_VISIBILITY,
- Downloads.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
- values.put(Downloads.COLUMN_DESCRIPTION,Uri.parse(url).getHost());
- values.put(Downloads.COLUMN_STOREPATH,Constant.STORE_DOWNLOAD);
顾名思义,
Downloads.COLUMN_URI即为该文件的url,它完全可以像这样:
http://192.168.2.50/share/Dell/Mini_3v/configuration.zip,还有一项比较重要的数据是Downloads.COLUMN_STOREPATH,这是下载存储路径,不设置的话默认是/sdcard/download。
另外
insert方法返回的是一个Uri,它就是这条记录的主键键值。
当我们执行完
insert后,我们会发现downloads表中多出一条数据:
这里需要留意一下粗体字的两列
control与status,后面我们会讲到。
2、 暂停/恢复/重试
我们通过更新这条记录的
control列来控制下载的状态。
1)暂停:
这里
contentUri就是刚才insert返回的Uri。values存放的是要更改的信息。我们仅仅把control这一列的值修改为Downloads.
CONTROL_PAUSE_BY_USER即为
10,就能暂停本次下载,执行上面的语句再查看一下数据库:
状态已经自动改为
194。
2)恢复:
是不是非常简单,我们把
control这一列的值修改为Downloads.
CONTROL_RUN,就可以继续本次下载,而这条下载记录变化为:
control与
status已经恢复为insert时的值。
3)重试:
在一些情况下,下载会失败,这时的数据库状态是什么呢?
与恢复时比较不难理解,
control的方式在下载失败时并没有改变,只不过状态变化了。看看如何重试:
这与暂停后恢复的处理有一点点区别,我们除了把
control修改为Downloads.
CONTROL_RUN,还需要把
status置成Downloads.
STATUS_RETRY。执行该代码,继续查看数据库:
又变成下载进行中的状态的了。
3、 清除
下载的过程中我们希望取消本次操作,怎么办?也很简单:
下载目录中的数据没有被删除:
- #pwd
- /data/dm
- #ls
- degrade.zip
- #
4、 监听
如果想在下载的不同状态时做一些处理,就需要注册一个ContentObserver来监听下载的状态。
- DownloadObserverobserver=@H_301_130@newDownloadObserver();
- getContentResolver().registerContentObserver(contentUri,@H_301_130@true,observer);
- 仍然,contentUri是我们下载对应的这条记录,而DownloadObserver继承于ContentObserver,我们用它覆盖ContentObserver的onChange方法,加上自己的逻辑,比如下载完成后弹出一个对话框通知用户等等。
- @H_301_130@private@H_301_130@classDownloadObserver@H_301_130@extendsContentObserver{
- @H_301_130@publicDownloadObserver(){
- @H_301_130@super(@H_301_130@newHandler());
- }
- @Override
- @H_301_130@public@H_301_130@voidonChange(@H_301_130@booleanflag){
- //dosomething
- }
- }
5、 其他一些下载方法
比如利用
java.net.URL与java.net.URLConnection:
- URLurl=@H_301_130@newURL(xmlURL);
- URLConnectioncon=url.openConnection();
- InputStreamin=con.getInputStream();
- ...
还可以利用
org.apache.http包的一些类:
由于篇幅关系,这里就不一一介绍了。文后将附上利用
DownloadManager下载的代码与AndroidManifest.xml。
附录:
- TestDownload.java
- @H_301_130@packagecom.OPhone.test;
- @H_301_130@importandroid.app.Activity;
- @H_301_130@importandroid.content.ContentUris;
- @H_301_130@importandroid.content.ContentValues;
- @H_301_130@importandroid.database.ContentObserver;
- @H_301_130@importandroid.database.Cursor;
- @H_301_130@importandroid.net.Uri;
- @H_301_130@importandroid.os.Bundle;
- @H_301_130@importandroid.os.Handler;
- @H_301_130@importandroid.view.View;
- @H_301_130@importandroid.view.View.OnClickListener;
- @H_301_130@importandroid.widget.Button;
- @H_301_130@importandroid.widget.TextView;
- @H_301_130@public@H_301_130@classTestDownload@H_301_130@extendsActivity{
- @H_301_130@private@H_301_130@finalStringURL="http://192.168.2.172/share/test/apologize.mp3";
- @H_301_130@privateCursormDownloadCursor;
- @H_301_130@privateUricontentUri;
- @H_301_130@privateButtonbtn_start;
- @H_301_130@privateButtonbtn_pause;
- @H_301_130@privateButtonbtn_resume;
- @H_301_130@privateButtonbtn_cancel;
- @H_301_130@privateButtonbtn_retry;
- @H_301_130@privateTextViewtxt_process;
- @Override
- @H_301_130@public@H_301_130@voidonCreate(BundlesavedInstanceState){
- @H_301_130@super.onCreate(savedInstanceState);
- setContentView(R.layout.main);
- txt_process=(TextView)findViewById(R.id.txt_process);
- btn_start=(Button)findViewById(R.id.btn_start);
- btn_pause=(Button)findViewById(R.id.btn_pause);
- btn_resume=(Button)findViewById(R.id.btn_resume);
- btn_cancel=(Button)findViewById(R.id.btn_cancel);
- btn_retry=(Button)findViewById(R.id.btn_retry);
- btn_start.setOnClickListener(@H_301_130@newOnClickListener(){
- @H_301_130@public@H_301_130@voidonClick(Viewv){
- start();
- }
- });
- btn_pause.setOnClickListener(@H_301_130@newOnClickListener(){
- @H_301_130@public@H_301_130@voidonClick(Viewv){
- pause();
- }
- });
- btn_resume.setOnClickListener(@H_301_130@newOnClickListener(){
- @H_301_130@public@H_301_130@voidonClick(Viewv){
- resume();
- }
- });
- btn_cancel.setOnClickListener(@H_301_130@newOnClickListener(){
- @H_301_130@public@H_301_130@voidonClick(Viewv){
- cancel();
- }
- });
- btn_retry.setOnClickListener(@H_301_130@newOnClickListener(){
- @H_301_130@public@H_301_130@voidonClick(Viewv){
- retry();
- }
- });
- }
- @H_301_130@private@H_301_130@voidstart(){
- ContentValuesvalues=@H_301_130@newContentValues();
- values.put("title","apologize.mp3");
- values.put("uri",URL);
- values.put("notificationpackage",getPackageName());
- values.put("notificationclass",TestDownload.@H_301_130@class.getName());
- values.put("visibility",1);
- values.put("description",Uri.parse(URL).getHost());
- values.put("storepath","/sdcard/download/");
- contentUri=getContentResolver().insert(
- Uri.parse("content://downloads/download"),values);
- mDownloadCursor=query();
- DownloadObserverobserver=@H_301_130@newDownloadObserver();
- getContentResolver()
- .registerContentObserver(contentUri,observer);
- };
- @H_301_130@private@H_301_130@voidresume(){
- ContentValuesvalues=@H_301_130@newContentValues();
- values.put("control",0);
- getContentResolver().update(contentUri,@H_301_130@null);
- };
- @H_301_130@private@H_301_130@voidpause(){
- ContentValuesvalues=@H_301_130@newContentValues();
- values.put("control",10);
- getContentResolver().update(contentUri,@H_301_130@null);
- };
- @H_301_130@private@H_301_130@voidcancel(){
- getContentResolver().delete(contentUri,@H_301_130@null);
- };
- @H_301_130@private@H_301_130@voidretry(){
- ContentValuesvalues=@H_301_130@newContentValues();
- values.put("control",10);
- values.put("status",195);
- getContentResolver().update(contentUri,@H_301_130@null);
- };
- @H_301_130@privateCursorquery(){
- Stringselection="_id='"+ContentUris.parseId(contentUri)+"'";
- @H_301_130@returnmanagedQuery(Uri.parse("content://downloads/download"),
- @H_301_130@newString[]{"total_bytes","current_bytes"},selection,
- @H_301_130@null,@H_301_130@null);
- }
- @H_301_130@private@H_301_130@intpoint=0;
- @H_301_130@private@H_301_130@classDownloadObserver@H_301_130@extendsContentObserver{
- @H_301_130@publicDownloadObserver(){
- @H_301_130@super(@H_301_130@newHandler());
- }
- @Override
- @H_301_130@public@H_301_130@voidonChange(@H_301_130@booleanflag){
- @H_301_130@if(mDownloadCursor.getCount()<=0){
- @H_301_130@return;
- }
- Stringpoints="";
- point=(point+1)%7;
- @H_301_130@for(@H_301_130@inti=0;i<point;i++){
- points+=".";
- }
- txt_process.setText(points);
- }
- }
- }
- AndroidManifest.xml
- <?xmlversion="1.0"encoding="utf-8"?>
- <manifestxmlns:android="http://schemas.android.com/apk/res/android"
- @H_301_130@package="com.OPhone.test"
- android:versionCode="1"
- android:versionName="1.0">
- <uses-permissionandroid:name="android.permission.ACCESS_DOWNLOAD_MANAGER"/>
- <applicationandroid:icon="@drawable/icon"android:label="@string/app_name">
- <activityandroid:name=".TestDownload"
- android:label="@string/app_name">
- <intent-filter>
- <actionandroid:name="android.intent.action.MAIN"/>
- <categoryandroid:name="android.intent.category.LAUNCHER"/>
- </intent-filter>
- </activity>
- </application>
- </manifest>
作者:
黄鹏——播思通讯
(声明:本网的新闻及文章版权均属OPhone SDN网站所有,如需转载请与我们编辑团队联系。任何媒体、网站或个人未经本网书面协议授权,不得进行任何形式的转载。已经取得本网协议授权的媒体、网站,在转载使用时请注明稿件来源。)