该库用于简化AbsListView类型与RecyclerView的Adapter构建,在ListViewAdapter和RecyclerAdapter封装了固定的业务逻辑,使得用户只需要实现变化的部分即可,简化代码,避免重复的模板代码。
该库的接口参考了base-adapter-helper,在此基础上添加了RecyclerView Adapter的支持。两种类型的Adapter之间通过桥接模式简化代码,参考ViewHolderImpl。
在项目的build.gradle中添加上如下依赖:
dependencies {
// 其他依赖
// Common Adapter的依赖
compile 'org.simple:adapter:1.0.1'
}
/**
* 初始化ListView
*/
private void initListView() {
ListView listView = (ListView) findViewById(R.id.listview);
final ListViewAdapter<String> adapter = new ListViewAdapter<String>(R.layout.list_item_type_1) {
@Override
protected void onBindData(GodViewHolder viewHolder, int position, String item) {
viewHolder
.setText(R.id.textview, item) // 设置文本内容
.setImageResource(R.id.imageview, R.drawable.big_smile) ; // 设置图片资源
}
};
// 添加数据
adapter.addItems(mockDatas());
listView.setAdapter(adapter);
// 设置ListView的点击事件
listView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
@Override
public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
Toast.makeText(MainActivity.this, "Click List : " + adapter.getItem(position), Toast.LENGTH_SHORT).show();
}
});
}
针对于AbsListView类族的组件需要使用ListViewAdapter类型的Adapter,泛型参数就是单个实体类的数据类型。在构造ListViewAdapter对象时覆写onBindData函数完成数据的绑定即可。GodViewHolder中包含了各类View属性的设置,具体请直接查看GodViewHolder中的setter函数。
对于RecyclerView则需要使用RecyclerAdapter,使用方式与ListViewAdapter类似,示例代码如下所示。
/**
* 初始化RecyclerView
*/
private void initRecyclerView() {
RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recyclerview);
// 线性
recyclerView.setLayoutManager(new LinearLayoutManager(MainActivity.this));
// 初始化adapter
final RecyclerAdapter<String> adapter = new RecyclerAdapter<String>(R.layout.list_item_type_1, mockDatas()) {
@Override
protected void onBindData(RecyclerViewHolder viewHolder, int position, String item) {
viewHolder.setText(R.id.textview, item);
ImageView imageView = viewHolder.findViewById(R.id.imageview);
Glide
.with(viewHolder.getContext())
.load("http://img4.duitang.com/uploads/blog/201402/19/20140219232639_Cda2j.thumb.600_0.jpeg")
.into(imageView);
}
// 如果有多个布局,那么覆写getItemViewType与getItemLayout即可
@Override
public int getItemViewType(int position) {
return position % 5 == 0 ? 2 : 1;
}
@Override
protected int getItemLayout(int type) {
if (type == 2) {
return R.layout.list_item_type_2;
}
return R.layout.list_item_type_1;
}
};
// 设置RecyclerView的点击事件
adapter.setOnItemClickListener(new RecyclerAdapter.OnItemClickListener() {
@Override
public void onItemClick(int position) {
Toast.makeText(MainActivity.this, "Click Recycler : "
+ adapter.getItem(position), Toast.LENGTH_SHORT).show();
}
});
recyclerView.setAdapter(adapter);
}
在使用Common Adapter时不需要担心数据源发生改变导致列表数据不更新的问题,因为Adapter基类中将数据集设置为final,所有的数据都会添加到该数据集中;在增加、减少数据时也不需要调用notifyDataSetChanged,只需要调用Adapter对应的的addItem或者remove函数即可。