Android开发——RecyclerView实现下载列表

本篇记录的是使用Jsoup框架爬取网页内容,结合Android的RecyclerView,从而实现批量下载小说的功能(也是我的APP星之小说下载器Android版的核心功能),思路仅供参考

本文使用了AsyncTask来实现下载功能,不懂使用的可以参考一下我的文章Android开发——实现子线程更新UI

RecyclerView的使用这里也略过了,详情请看Android ListView与RecycleView的对比使用

思路分析

RecyclerView相关概念

RecyclerView的使用大家都熟悉了,我们主要继承适配器,实现了适配器中的三个方法

主要流程:

适配器获得我们写的Item.xml布局,之后根据此布局,创建了一个ViewHolder,然后,就把数据源(List存储的实体类)逐一地设置到我们写的Item.xml布局文件中(找到某个控件的实例,之后进行setText等操作)

Item进度条更新

思路:
我们的item中包含有进度条,想要实现进度条更新效果,按照之前的常理,得找到这个进度条的实例对象,然后设置进度条的进度。

问题来了——

1.如何找到进度条这个实例对象呢?

View类中提供了一个方法findViewById,通过此方法就可以找到某个实例对象,所以我们要获得进度条所在的那个root View对象(也就是itemView)

2.如何获得itemView?

RecyclerView中,提供了一个方法findViewHolderForAdapterPosition用来找到某个位置的ViewHolder,找到ViewHolder,之后就可以由此ViewHolder找到itemView

//找到特定position对应的ItemView
val itemView = rv_downloading.findViewHolderForAdapterPosition(position).itemView
val progressbar = itemView.findViewById(R.id.progress)
//kotlin中特有的自动转型功能,设置进度条进度为20
if (progressbar is ProgressBar) progressbar.progress = 20

这部分更新的UI的代码,要在AsyncTask的onProgressUpdate方法中执行(子进程中更新UI)

暂停功能

思路:
在Item的那个布局中,添加一个TextView,并设置visibility属性为gone,此TextView就是一个暂停的标记,默认text属性为1,就是不暂停。

小说下载器是是按章下载的,在开始下载某一章节的时候,检测此TextView的值是否为0,不为0则下载,为0则进入到一个死循环

当点击暂停按钮的时候,修改状态TextView的text为0即可

总结

从以上的思路分析,可以总结出这样的思路:

我们通过itemView去达到更新UI功能(上述只是简单说需要更新进度条当然,实际情况,不只更新进度条,还要更新其他的控件,具体情况,具体分析),所以需要一个List或HashMap存放itemView。

这里实际项目我选用了HashMap(名字为itemViewMap),然后HashMap的key为Int(变量名为itemPosition)表示是当前任务列表的第几个任务(从0开始),value则是该任务对应的itemView

由于我们是使用findViewHolderForAdapterPosition方法得到的ViewHolder,再由ViewHolder获得itemView对象,所以需要一个position

这里,如果考虑到任务完成之后的情况,position可能会改变,因为任务完成之后,RecyclerView会将item移出

上图中的第3个任务(即是RecyclerView中position为2的那个任务),之后RecyclerView会将该item移出列表,后面的item的position就会发生改变,原本itemPosition=3对应的position也是3,之后position发生了改变,itemPosition=3的item对应的position变为了2

由上面分析,我们应该使用一个HashMap(名字为itemPositonMap)来保存itemPosition和对应的positionitemPosition作为key,position作为value),在任务完成之后需要重新计算itemPositonMap中的映射关系(也就是在AsyncTask中的onPostExecute方法中)

由上图得到的规律:

某个任务完成了,index>该任务的index,position=position-1

每添加一个任务,新的任务的itemPosition=itemPositonMap.size,对应的position=dataList.size

itemPositionMap的长度,即是记录了当前是第几个任务

dataList即是new一个适配器传到适配器中数据源,之后任务完成需要根据position移出某个数据

实现

注意点

  1. ViewHolder需要在RecyclerView填充完item之后才能获取到,否则为空
  2. 暂停功能的那个TextView也是需要在RecyclerView填充完item之后才能获取到,否则为空

代码

private val dataList = arrayListOf<DownloadingItem>()
private val itemViewMap = hashMapOf<Int?, View>()
//itemPostion(data) - > position(recyclerview)
private val itemPositonMap = hashMapOf<Int, Int>()

internal inner class DownloadingTask : AsyncTask<String, DownloadingItem, DownloadedItem>() {
	var isFirst = true
	var itemPosition = 0
	var tvStatus: TextView? = null
	override fun onPreExecute() {
		//一些初始化操作
		itemPosition = itemPositonMap.size
		//保存对应的item索引和位置
		itemPositonMap[itemPosition] = dataList.size
	}

	override fun doInBackground(vararg params: String?): DownloadedItem {

		val tool = NovelDownloadTool(params[0].toString(), itemPosition)
		val messageItem = tool.getMessage()
		publishProgress(messageItem)
		for (i in 0 until tool.chacterMap.size) {
			//下载每章节,并更新
			val item = tool.downloadChacter(this@DownloadingFragment.activity, i)
			publishProgress(item)

			//tvStatus控件可能为空(因为RecyclerView的itemView未初始化成功)
			while (tvStatus?.text.toString() != "1") {
			}
			// if (tvStatus != null) while (tvStatus!!.text.toString() != "1"){}
		}
		//合并文件,并返回一个数据类(DownloadedItem),之后添加到另外的RecyclerView中
		return tool.mergeFile(this@DownloadingFragment.activity)
	}

	override fun onProgressUpdate(vararg values: DownloadingItem?) {
		//recyclerView Item更新
		if (isFirst) {
			values[0]?.let { dataList.add(it) }

			adapter?.notifyDataSetChanged()
			isFirst = false

		} else {
			if (tvStatus == null) {
				val itemView = rv_downloading.findViewHolderForAdapterPosition(itemPositonMap[itemPosition] as Int).itemView
				tvStatus = itemView.findViewById(R.id.tv_status) as TextView?
				//存入itemView
				itemViewMap[values.last()?.itemPosition] = itemView
			}
			updateItem(values.last())
		}
	}

	override fun onPostExecute(result: DownloadedItem?) {
		showToast("下载成功")

		//移出adapter中的数据
		val position = itemPositonMap[result?.itemPosition] as Int

		adapter?.notifyItemRemoved(position)
		dataList.removeAt(position)
		//下载完成,重新计算itemPostion对应的position
		for (i in position + 1 until itemPositonMap.size) {
			itemPositonMap[i] = itemPositonMap[i] as Int - 1
		}

		val mainactivity = this@DownloadingFragment.activity as MainActivity
		mainactivity.addItemToHistory(result)
	}
}

缺点

  1. itemPositonMap和itemViewMap在任务列表存在过多任务,占用的内存会过大(可以考虑在任务列表任务全部完成之后进行一次清空操作)
  2. 暂停功能使用的是while死循环,可能会产生bug

Android开发——RecyclerView实现下载列表

全文结束