PersistantRecyclerAdapter

PersistantRecyclerAdapter is a simple, lite weight android library that persists data across fragment and activity recreation

How To Use PersistantRecyclerAdapter

Step 1. Add the JitPack repository to your build file

Add it in your root build.gradle at the end of repositories:

allprojects {
 repositories {
  ...
  maven { url 'https://jitpack.io' }
 }
}

Step 2. Add the dependency

dependencies {
        implementation 'com.github.devmike01:PersistantRecyclerAdapter:0.1.0'
}

Example usage

Create an empty Java class and name it PersistentRecyclerAdapter.
Create a nested class inside the PersistentRecyclerAdapter class. Name it SampleViewHolder and extends RecyclerView.ViewHolder.
Initialize a List global variable (e.g private List<SampleItems> itemsList;) in the RecyclerView adapter class and assign the incomming data to it.
Now create a model class and implements Parcelable, like this:

public class SampleItems implements Parcelable{
    private String str;
    
    public SampleItems() {
    }

  public static final Creator<SampleItems> CREATOR = new Creator<SampleItems>() {
  
        @Override
        public SampleItems createFromParcel(Parcel in) {
            SampleItems items = new SampleItems();
            items.str = in.readString();
            return items;
        }

   @Override
        public SampleItems[] newArray(int size) {
            return new SampleItems[size];
         }
     };
 
 public void setStr(String s){
         str =s;
     }
 public String getStr(){
         return str;
     }
 
 @Override
     public int describeContents() {
         return 0;
     }
 
     @Override
     public void writeToParcel(Parcel dest, int flags) {
         dest.writeString(str);
     }
}

Pass the model class SampleItems as the first parameter to the adapter and the SampleViewHolder as the second parameter. At the end your Adapter class should look like the code snippet below:

public class SampleAdapter extends PersistentRecyclerAdapter<SampleItems, SampleAdapter.SampleViewHolder> {
       
   private List<SampleItems> itemsList; //Initialize a list with your data model
   
       public SampleAdapter(List<SampleItems> parcelableList) {
           super(parcelableList);
           itemsList = parcelableList;
       }
   
   @Override
       public void onBindViewHolder(@NonNull SampleViewHolder holder, int position, SampleItems data) {
           holder.tv.setText(data.getStr());
       }
   
   @NonNull
       @Override
       public SampleViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
           View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.grid_items_sample, parent, false);
           return new SampleViewHolder(view);
       }
   
    @Override
       public int getItemCount() {
           return itemsList.size();
       }
   
   //Recycler ViewHolder
   public class SampleViewHolder extends RecyclerView.ViewHolder{
     TextView tv;
            public SampleViewHolder(View itemView) {
                super(itemView);
                tv = itemView.findViewById(R.id.grid_text);
           }
       }
   }

We can now intialize the adapter in our Fragment/Activity class and pass the data we want to display to it. Version 0.0.2 of PersistantRecyclerAdapter now supports all RecyclerView LayoutManager.

LinearLayoutManager

LinearLayoutManager mLinearLayout = a.getLinearLayoutManager(getActivity(), 3);
 mLinearLayout.setLayoutManager(gridLayout);
 mLinearLayout.setHasFixedSize(true);
 mLinearLayout.setAdapter(a);

GridLayoutManager

GridLayoutManager gridLayout = a.getGridLayoutManager(getActivity(), 3);
 gridView.setLayoutManager(gridLayout);
 gridView.setHasFixedSize(true);
 gridView.setAdapter(a);

StaggeredGridLayoutManager

StaggeredGridLayoutManager mStaggeredGridLayoutManager = a.getGridLayoutManager(getActivity(), 3);
 gridView.setLayoutManager(mStaggeredGridLayoutManager);
 gridView.setHasFixedSize(true);
 gridView.setAdapter(a);

Contributions

If you would like to contribute to PersistantRecyclerAdapter for Android, clone the repository and just make a pull request.

git clone https://github.com/devmike01/PersistantRecyclerAdapter.git

License

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.

PersistentRecyclerAdapter

General

Additional