Android学习笔记（四六）：互联网通信-文件下载

在Android 2.3引入了DownloadManager可以处理复杂的文件下载，包括检查用户是否有数据联系（WIFI或者移动数据），当用户从一个有数据连接的地方移动到无连接的地方（例如离开了wifi或者3G data的access point），确保设备在下载过程中保持awake状态。DownloadManager可以处理HTTP URLs，但是不能处理HTTPS(SSL) URLs。

设置下载文件条件许可

在这个例子，将学习通过DownloadManager从Internet下载文件，并存储在外部存储介质SD卡上。有以下需要注意：

由于不支持2.3之前的版本，需将最小版本设置为Android2.3或者以上。
在模拟器，我们需确保已设置SD卡，如右图所示。
程序具有Internet以及外部存储的访问权限，在Androidmanifest.xml中设置：

<uses-permission android:name="android.permission.INTERNET"/>

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

<application>

....

</application>

小程序的设计

具体的xml文件略去。布局简单地分为3个button，如右图，第一个button设置android:onClick="startDownload"，即点击后触发startDownload()方法，用于请求下载文件。第二个button触发queryStatus(),并disabled，点击触发下载的状态查询。第三个button触发viewLog()，调用系统提供的DownloadManager的Activity，用来查看历史下载情况。

请求文件下载


privateDownloadManager mgr = null;

private long lastDownloadId = 0;

protected void onCreate(Bundle savedInstanceState) {

… …

// 步骤1 : 获取系统服务，并指明是下载服务，即DownloadManager。系统的这类服务大部分这些管理没有close() ，release()之类的由系统garbage收集来处理。我们只需获取这些服务的对象，并发出我们的请求

mgr = (DownloadManager)getSystemService(DOWNLOAD_SERVICE);

}

public void startDownload(View v){

Uri uri = Uri.parse("http://commonsware.com/misc/test.mp4");

//文件将存放在外部存储的确实download文件内，如果无此文件夹，创建之，如果有，下面将返回false。不同的手机不同Android版本的SD卡的挂载点可能会不一样，因此通过系统方式获取。

Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS).mkdir()；

//步骤2： 通过向下载服务发出enqueue()的请求，将放在下载队列中，通常会触发立即下载，并返回下载的ID号，根据这个号，可以查询相关的下载情况。分别设置请求的Uri，允许的数据访问方式，是否允许漫游，本地存储的位置，以及为这个下载设置title和描述信息。

lastDownloadId = mgr.enqueue(new DownloadManager.Request(uri)

.setAllowedNetworkTypes(DownloadManager.Request.NETWORK_MOBILE | DownloadManager.Request.NETWORK_WIFI)

.setAllowedOverRoaming(false) //缺省是true，所以天价漫游数据费的产生

.setTitle("MyTest") //用于信息查看

.setDescription("Something Useful") //用于信息查看

.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, "test.mp4"));

v.setEnabled(false);

findViewById(R.id.c25_query).setEnabled(true);

}

获取下载状态

通常会有一个后台运行来不断更新下载的情况，例子目的是如何获取，所以简单地通过点击第二个button触发查询下载状态。


public void queryStatus(View v){

//关键：通过ID向下载管理查询下载情况，返回一个cursor

Cursor c = mgr.query(new DownloadManager.Query().setFilterById(lastDownloadId));

if(c == null){

Toast.makeText(this, "Download not found!", Toast.LENGTH_LONG).show();

}else{ //以下是从游标中进行信息提取

c.moveToFirst();

Log.d(getClass().getName(),"Column_id : " +

c.getLong(c.getColumnIndex(DownloadManager.COLUMN_ID)));

Log.d(getClass().getName(),"Column_bytes_downloaded so far : " +

c.getLong(c.getColumnIndex(DownloadManager.COLUMN_BYTES_DOWNLOADED_SO_FAR)));

Log.d(getClass().getName(),"Column last modified timestamp : " +

c.getLong(c.getColumnIndex(DownloadManager.COLUMN_LAST_MODIFIED_TIMESTAMP)));

Log.d(getClass().getName(),"Column local uri : " +

c.getString(c.getColumnIndex(DownloadManager.COLUMN_LOCAL_URI)));

Log.d(getClass().getName(),"Column statue : " +

c.getInt(c.getColumnIndex(DownloadManager.COLUMN_STATUS)));

Log.d(getClass().getName(),"Column reason : " +

c.getInt(c.getColumnIndex(DownloadManager.COLUMN_REASON)));

Toast.makeText(this, statusMessage(c), Toast.LENGTH_LONG).show();

}

}

private String statusMessage(Cursor c){

switch(c.getInt(c.getColumnIndex(DownloadManager.COLUMN_STATUS))){

case DownloadManager.STATUS_FAILED:

return "Download failed";

case DownloadManager.STATUS_PAUSED:

return "Download paused";

case DownloadManager.STATUS_PENDING:

return "Download pending";

case DownloadManager.STATUS_RUNNING:

return "Download in progress!";

case DownloadManager.STATUS_SUCCESSFUL:

return "Download finished";

default:

return "Unknown Information";

}

}






从信息中，我们可以看到下载的存放的位置，SD卡的挂点为/mnt/sdcard/我们可以通过$adb
shell进入模拟器的控制台进行查看。另外获取文件的总体大小为COLUMN_TOTAL_SIZE_BYTES。

# pwd/mnt/sdcard/Download

# ls -l

----rwxr-x system sdcard_rw 6219229 2011-11-01 14:19 test.mp4

通过下载管理查看

public void viewLog(View v){

startActivity(new Intent(DownloadManager.ACTION_VIEW_DOWNLOADS));

}

通过BoardReceiver获取实时事件触发

在上面的例子中，希望在一下载完进行触发，将第一个button恢复为enabled状态。在Android学习笔记（三四）：再谈Intent（上）－一些知识中谈到，通过BoardReceiver从服务器中获取事件触发处理。





protected void onCreate(Bundle savedInstanceState) {

... ...

//当下载结束时进行触发。

registerReceiver(onComplete, new IntentFilter(DownloadManager.ACTION_DOWNLOAD_COMPLETE));

//当点击一个正在下载的文件，如图所示

registerReceiver(onNotification,new IntentFilter(DownloadManager.ACTION_NOTIFICATION_CLICKED));

}

BroadcastReceiver onComplete = new BroadcastReceiver() {

public void onReceive(Context context, Intent intent) {

findViewById(R.id.c25_start).setEnabled(true);

}

};

BroadcastReceiver onNotification = new BroadcastReceiver() {

public void onReceive(Context context, Intent intent) {

Toast.makeText(context, "..............", Toast.LENGTH_LONG).show();

}

};

对于DownloadManager，如果文件已经下载，第二次无需再下载。另外由于DownloadManager属于系统服务，不仅是你的app可以调用，也就是上面list的内容是全局的，可能部分并非你的app在下载，这样会使用户迷惑，在request请求中，我们可以同setVisibleInDownloadsUi(false)，可以屏蔽之。

传统文件下载方式

ownloadManager服务需要Android版本2.3以上，如果不满足条件，可采用获取网络文件流的方式来处理，具体步骤如下：

建一个HttpURLConnection的对象，可以通过URL对象的openConnection()方法获取，例如：HttpURLConnection urlConn = (HttpURLConnection) url.openconnection();
获取一个InputStream对象：urlConn.getInputStream()。

有了InputStream，剩下的都是Java的标准I/O操作。

注意

对于Internet的访问，不要再应用的主线程进行，而应该在后台线程中处理HttpClient,HttpUrlConnection以及其他的Internet access API。互联网通信-HttpClient、XML解析（W3C）的例子只是作为小例子简单清晰说明相关的使用方式。