CommonAdapter 开源项目教程

倪姿唯Kara

于 2024-08-13 08:54:49 发布

阅读量382

点赞数 4

本文链接：https://blog.csdn.net/gitblog_01137/article/details/141153701

版权

CommonAdapter 开源项目教程

CommonAdapter通过封装BaseAdapter和RecyclerView.Adapter得到的通用的，简易的Adapter项目地址:https://gitcode.com/gh_mirrors/co/CommonAdapter

项目介绍

CommonAdapter 是一个适用于 ListView、GridView 和 RecyclerView 的 Adapter 库，旨在简化大量重复代码，支持多种布局，并允许自定义图片加载的实现。该项目通过封装 BaseAdapter 和 RecyclerView Adapter，提供了一个通用的、简易的 Adapter 解决方案，从而提高了代码的复用性和可维护性。

项目快速启动

1. 添加依赖

首先，在您的 build.gradle 文件中添加以下依赖：

implementation 'com.github.qyxxjd:CommonAdapter:latest_version'

请将 latest_version 替换为项目的最新版本号。

2. 创建 ViewHolder

创建一个继承自 CommonHolder 的 ViewHolder 类，并绑定布局和视图 ID：

@LayoutId(R.layout.item_person)
public class PersonHolder extends CommonHolder<Person> {
    @ViewId(R.id.name)
    TextView name;
    @ViewId(R.id.email)
    TextView email;

    @Override
    public void bindData(Person person) {
        name.setText(person.getName());
        email.setText(person.getEmail());
    }
}

3. 创建 Adapter

创建一个通用的 Adapter 并设置给 RecyclerView 或 ListView：

// 创建 RecyclerView Adapter
CommonAdapter<Person, PersonHolder> recyclerAdapter = new CommonAdapter<>(this, PersonHolder.class);
mRecyclerView.setAdapter(recyclerAdapter);

// 或者创建 ListView Adapter
CommonListAdapter<Person, PersonHolder> listAdapter = new CommonListAdapter<>(this, PersonHolder.class);
mListView.setAdapter(listAdapter);

4. 设置监听器

通过 Adapter 设置事件监听器：

recyclerAdapter.setOnBindListener((position, person, holder) -> {
    holder.name.setOnClickListener(v -> toast(person.getName()));
    holder.email.setOnClickListener(v -> toast(person.getEmail()));
});

应用案例和最佳实践

案例一：简单的数据绑定

假设我们有一个简单的数据模型 Person，包含姓名和电子邮件字段。我们可以使用 CommonAdapter 来绑定数据：

List<Person> personList = new ArrayList<>();
personList.add(new Person("Alice", "alice@example.com"));
personList.add(new Person("Bob", "bob@example.com"));

CommonAdapter<Person, PersonHolder> adapter = new CommonAdapter<>(this, PersonHolder.class);
adapter.setData(personList);
mRecyclerView.setAdapter(adapter);

案例二：多种 Item Type

CommonAdapter 支持多种 Item Type，只需在 ViewHolder 中处理不同类型的布局和数据绑定：

@LayoutId(R.layout.item_person)
public class PersonHolder extends CommonHolder<Person> {
    @ViewId(R.id.name)
    TextView name;
    @ViewId(R.id.email)
    TextView email;

    @Override
    public void bindData(Person person) {
        name.setText(person.getName());
        email.setText(person.getEmail());
    }
}

@LayoutId(R.layout.item_company)
public class CompanyHolder extends CommonHolder<Company> {
    @ViewId(R.id.company_name)
    TextView companyName;
    @ViewId(R.id.address)
    TextView address;

    @Override
    public void bindData(Company company) {
        companyName.setText(company.getName());
        address.setText(company.getAddress());
    }
}