RxRecyclerAdapter
Rx based generic RecyclerView Adapter Library.
How to use it?
Example!
- Enable Databinding by adding these lines to your build.gradle
dataBinding {
enabled = true
}
- Create the layout file
<?xml version="1.0" encoding="utf-8"?> <layout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools">
<LinearLayout
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
android:padding="@dimen/activity_horizontal_margin">
<TextView android:id="@+id/textViewItem"
android:layout_width="match_parent"
android:layout_height="wrap_content"
tools:text="Recycler Item"/>
</LinearLayout> </layout>- Create your dataSet
//Dummy DataSet List<String> dataSet = new ArrayList<>();
dataSet.add("This");
dataSet.add("is");
dataSet.add("an");
dataSet.add("example");
dataSet.add("of RX!");
- Create RxDataSource
RxDataSource<String> rxDataSource = new RxDataSource<>(dataSet);
//compose, bind and subscribe! rxDataSource.map(String::toLowerCase)
.repeat(10)
//cast call this method with the binding Layout
.<ItemLayoutBinding>bindRecyclerView(recyclerView, R.layout.item_layout)
.subscribe(viewHolder -> {
ItemLayoutBinding b = viewHolder.getViewDataBinding();
b.textViewItem.setText(viewHolder.getItem());
}
);
And that's it! The recyclerView is going to show
Changing the data dynamically
Simply call updateAdapter after making changes to the dataSet and that'll do the trick!
rxDataSource.map(...).filter(...).take(...).updateAdapter();
Adapter for multiple View Types
If multiple view types are required for your recyclerView, let's say, we have two types HEADER and ITEM then the coding steps will be :-
- Enable Databinding
- Create a list of ViewHolderInfo
List<ViewHolderInfo> viewHolderInfoList = new ArrayList<>();
viewHolderInfoList.add(new ViewHolderInfo(R.layout.item_layout, TYPE_ITEM));
//TYPE_ITEM = 1 viewHolderInfoList.add(new ViewHolderInfo(R.layout.item_header_layout, TYPE_HEADER));
//TYPE_HEADER = 0- Create an instance of OnGetItemViewType implementation
OnGetItemViewType viewTypeCallback = new OnGetItemViewType() {
@Override public int getItemViewType(int position) {
if (position % 2 == 0) //headers are at even pos
return TYPE_HEADER;
return TYPE_ITEM;
}
}
;- Compose and call bindRecyclerView passing in recyclerView, viewHolderInfoList and viewTypeCallBack
rxDataSource.map(...).filter(...)
.bindRecyclerView(recyclerView, viewHolderInfoList, viewTypeCallback)
.subscribe(vH -> {
//Check instance type and bind!
final ViewDataBinding b = vH.getViewDataBinding();
if (b instanceof ItemLayoutBinding) {
final ItemLayoutBinding iB = (ItemLayoutBinding) b;
iB.textViewItem.setText("ITEM: " + vH.getItem());
}
else if (b instanceof ItemHeaderLayoutBinding) {
ItemHeaderLayoutBinding hB = (ItemHeaderLayoutBinding) b;
hB.textViewHeader.setText("HEADER: " + vH.getItem());
}
}
);
And the output would look something like
More examples and details here
Download
Repository available on jCenter
compile 'com.minimize.android:rxrecycler-adapter:1.2.2'If the dependency fails to resolve, add this to your project repositories
repositories {
maven {
url "http://dl.bintray.com/ahmedrizwan/maven"
}
}
License
Copyright 2015 Ahmed Rizwan Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.