android--使用RecyclerView及相关架构组件实现列表数据展示

最新推荐文章于 2024-04-26 13:21:31 发布

0522

最新推荐文章于 2024-04-26 13:21:31 发布

阅读量626

点赞数

分类专栏： Android开发功能示例文章标签： android 移动开发 java

本文链接：https://blog.csdn.net/lishen1990/article/details/110916477

版权

Android开发功能示例专栏收录该内容

4 篇文章 0 订阅

订阅专栏

使用RecyclerView及相关架构组件实现列表数据展示

参考资料
IDE
相关组件概述
声明依赖项
搭建列表显示模块代码框架
额外说明

参考资料

安卓开发官方文档:

架构组件（包括分页库、ViewModel、LiveData等相关组件）

IDE

AndroidStudio

声明依赖项

使用以上架构组件的功能之前，需要在项目中添加其引用声明。包括生命周期组件、Paging组件，如果数据来源为数据库还可以添加Room组件。具体参考官方文档–声明依赖项

搭建列表显示模块代码框架

创建列表项的视图布局文件

创建一个Fragment视图作为列表项的Layout布局资源，并在RecyclerView中声明其为列表项布局文件。

     <androidx.recyclerview.widget.RecyclerView
     	   android:id="@+id/myRecyclerview"
     	   <!--其他属性-->
           tools:listitem="@layout/fragment_list_item" />

构建适配器PagedListAdapter

首先需要以PagedListAdapter为基类，自定义列表数据显示的适配器类。并重写以下方法：

onCreateViewHolder----以列表项fragment_list_item为模板，返回列表项的一个新的视图对象
onBindViewHolder—为列表中每一个视图对象绑定数据并显示

并自定义一个扩展自RecyclerView.ViewHolder的ViewHolder类，该类是与列表项布局fragment_list_item对应的。在ViewHolder中对列表项中的每一个视图控件做出声明并获取控件对象。
另外每一个ViewHolder中的视图组件的数据来自于一个自定义数据对象ItemInfo

public class ItemInfo
{
    //字符串，用于在textView中显示
	public String str;
	//图片链接，用于显示图片
	public String imgUrl;
	//一个唯一标识，可以作为列表项的键
	public String key;
}

整体代码大致如下：

public class MyListAdapter extends PagedListAdapter<ItemInfo,MyListAdapter.ViewHolder> {
    public MyListAdapter()
   {
       super(DIFF_CALLBACK);
   }

    private static DiffUtil.ItemCallback<ItemInfo> DIFF_CALLBACK =
            new DiffUtil.ItemCallback<ItemInfo>() {

                @Override
                public boolean areItemsTheSame(@NonNull ItemInfo oldItem, @NonNull ItemInfo newItem) {
                    // The ID property identifies when items are the same.
                    return oldItem.key == newItem.key;
                }

                @Override
                public boolean areContentsTheSame(@NonNull ItemInfo oldItem, @NonNull ItemInfo newItem) {
                    // Don't use the "==" operator here. Either implement and use .equals(),
                    // or write custom data comparison logic here.
                    return oldItem.key.equals(newItem.key);
                }
            };

    @NonNull
    @Override
    public MyListAdapter.ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
        View view= LayoutInflater.from(parent.getContext()).inflate(R.layout.fragment_list_item,parent,false);
        
        return new ViewHolder(view);
    }

    @Override
    public void onBindViewHolder(@NonNull MyListAdapter.ViewHolder holder, int position) {
        try {
            ItemInfo _itemInfo=getItem(position);
            holder._textView.setText(_itemInfo.str);
            Glide.with(holder.mView).load(_itemInfo.imgUrl).into(holder._imageView);
        }
        catch (Exception e)
        {
            e.printStackTrace();
        }
     }

    public class ViewHolder extends RecyclerView.ViewHolder
    {
        public final ImageView _imageView;
        public final TextView _textView;
  

        public final View mView;
        public ViewHolder(@NonNull View itemView)
        {
            super(itemView);
            _textView=(TextView)itemView.findViewById(R.id.idOfTextView);
            _imageView=(ImageView)itemView.findViewById(R.id.idOfImageView);

            mView=itemView;
        }
    }
}

通过以上代码，可以构建一个自定义的RecyclerView的适配器类，将列表视图的每一项进行数据适配

构建数据源DataSource

DataSource类是提供分页数据快照功能的一个基类。它的子类有以下三个

关于以上三种子类的详细区分可以查看链接内容。

下面以ItemKeyedDataSource为基类扩展一个自定义数据源类MyDataSource。

public class MyDataSource extends ItemKeyedDataSource<String, ItemInfo> {

	private int pageIndex=1;
	
	@Override
    public void loadInitial(@NonNull LoadInitialParams<String> params, @NonNull LoadInitialCallback<ItemInfo> callback) {
        fetchItems(params.requestedInitialKey,params.requestedLoadSize,pageIndex,callback);
    }

    private void fetchItems(String requestedInitialKey, int requestedLoadSize,int pageIndex,LoadCallback<ItemInfo> callback)
    {
        try
        {
            //在此处写入获取当前页列表数据的代码，可以从数据库中获取，或者从后端服务器API获取
            //List<ItemInfo> itemInfoList=*******
            //callback.onResult(itemInfoList);//通过回调返回列表数据
        }
        catch (Exception e)
        {
            e.printStackTrace();
        }
    }

    @Override
    public void loadAfter(@NonNull LoadParams<String> params, @NonNull LoadCallback<ItemInfo> callback) {
        try {
            pageIndex=pageIndex+1;
            fetchItems(params.key, params.requestedLoadSize,pageIndex,callback);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    @Override
    public void loadBefore(@NonNull LoadParams<String> params, @NonNull LoadCallback<ItemInfo> callback) {

    }

    @NonNull
    @Override
    public String getKey(@NonNull ItemInfo item) {
        return item.key;
    }
}

通过以上代码可以构建一个自定义的数据源类，用于获取某一页的数据快照。

创建完MyDataSource之后，可以进一步创建一个工厂类MyDataSourceFactory，通过工厂类获得MyDataSource的对象。

public class MyDataSourceFactory extends MyDataSource.Factory<String, ItemInfo> {
    private MutableLiveData<MyDataSource> sourceLiveData=new MutableLiveData<>();
    private MyDataSource myDataSource;

    @NonNull
    @Override
    public DataSource<String, ItemInfo> create() {
        myDataSource=new MyDataSource();
        sourceLiveData.postValue(myDataSource);
        return myDataSource;
    }
}

构建ViewModel

自定义一个MyViewModel类，扩展自ViewModel基类。

public class MyViewModel extends ViewModel {
    public final LiveData currentItemInfoList;
    public MyViewModel()
    {
        PagedList.Config config=new PagedList.Config.Builder().setPageSize(20).setInitialLoadSizeHint(20).setPrefetchDistance(5).build();
        currentItemInfoList=new LivePagedListBuilder(new MyDataSourceFactory(),config).build();
    }
}

可以进一步创建一个ViewModel工厂，用于提供MyViewModel对象。


public class MyViewModelFactory implements ViewModelProvider.Factory {

    @NonNull
    @Override
    public <T extends ViewModel> T create(@NonNull Class<T> modelClass) {
         T t = (T) new MyViewModel();
        return t;
    }
}

组装以上模块

完成以上模块的构建之后，就可以在界面控制器中应用这些模块，实现完整的包括列表数据获取、适配与显示等功能。以一个Activity控制器为例：

public class MyActivity extends AppCompatActivity {
    private RecyclerView recyclerView;
    private RecyclerView.LayoutManager layoutManager;
    private MyListAdapter adapter=new MyListAdapter();
    private MyViewModel viewModel;
    private MyViewModelFactory viewModelFactory;


    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_my);
        viewModelFactory=new MyViewModelFactory();
        try {
             recyclerView=(RecyclerView)findViewById(R.id.myRecyclerview);
             layoutManager=new LinearLayoutManager(this);
             recyclerView.setLayoutManager(layoutManager);
             recyclerView.setAdapter(adapter);
             viewModel=new ViewModelProvider(this,viewModelFactory).get(MyViewModel.class);

             Observer<PagedList<ItemInfo>> listObserver= itemList->submitListForAdapter(itemList);
             viewModel.currentItemInfoList.observe(this,listObserver);
         }
         catch (Exception e)
         {

         }
    }
    
   public void submitListForAdapter(PagedList<ItemInfo> itemList)
    {
        adapter.submitList((PagedList<ItemInfo>) itemList);
        //其他自定义逻辑
    }
}

通过以上的工作，可以实现使用RecyclerView及相关架构组件实现列表数据展示的这一目标。当然只是实现基本的功能与流程。对于具体的业务需求和不同的使用场景。可以视情况，在自定义的DataSource，Adapter和界面控制器中添加更多的业务逻辑代码。实现更丰富的数据展示和更复杂更完善的功能

额外说明

以上的内容中可能会用到一些组件、框架。
另外还有一些未明确解释的概念。
具体情况可以查看以下相关资料深入了解。

获取服务器API数据组件—Retrofit
对于SQLite的一个抽象层组件库—Room
图片加载–Glide
组件生命周期–lifecycle

0522

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
android--使用RecyclerView及相关架构组件实现列表数据展示

使用RecyclerView及相关架构组件实现列表数据展示参考资料IDE相关组件概述LiveDataViewModel分页库PagedList数据源（DataSource）RecyclerView声明依赖项搭建列表显示模块代码框架创建列表项的视图布局文件构建适配器PagedListAdapter构建数据源DataSource构建ViewModel组装以上模块额外说明参考资料安卓开发官方文档:架构组件（包括分页库、ViewModel、LiveData等相关组件）IDEAndroidStudio
复制链接

扫一扫