RecyclerAdapters

Additional

Language
Java
Version
v0.3.0 (Oct 30, 2017)
Created
Oct 5, 2016
Updated
Oct 30, 2017 (Retired)
Owner
Alex Michenko (alex-michenko)
Contributor
Alex Michenko (alex-michenko)
1
Activity
Badge
Generate
Download
Source code
APK file

Commercial

RecyclerAdapters

Introduction

RecyclerAdapters provides you a very simple way for implement RecyclerView.Adapter class in your projects. With this library you can implement Adapter in a few line.

Get started

dependencies {
    compile 'com.github.alex-michenko:recycleradapters:0.3.0'
}

How to use

1.Create DataHolder

Create class-wrapper that will hold data for adapter:

public class PersonDH implements RecyclerDH {

  public boolean isFavourite;
  public int countStars;
  public String name;

  public String headerName;

  public PersonDH(String name, boolean isFavourite) {
      this.name = name;
      this.isFavourite = isFavourite;

      if (isFavourite)
          countStars = new Random().nextInt(4) + 1;
  }

  public PersonDH(String headerName) {
      this.headerName = headerName;
  }
}

2. Create ViewHolder

Create ViewHolder class and set generic parameter as created DataHolder:

public class PersonVH extends RecyclerVH<PersonDH> {

  private TextView tvNamePerson;

  public PersonVH(View itemView) {
      super(itemView);

      tvNamePerson = findView(R.id.tvNamePerson);
  }

  @Override
  public void setListeners(final OnCardClickListener listener) {
      tvNamePerson.setOnClickListener(new View.OnClickListener() {
          @Override
          public void onClick(View view) {
                  listener.onClick(view, getAdapterPosition(), getItemViewType());
          }
      });
  }

  @Override
  public void bindData(PersonDH data) {
      tvNamePerson.setText(data.name);
  }

}

Method setListeners() is called if OnCardClickListener was setted for your adapter

If you adapter has several viewTypes then create suitable ViewHolders:

public class FavouriteVH extends RecyclerVH<PersonDH> {
  //.....
}
public class HeaderVH extends RecyclerVH<PersonDH> {
  //.....
}

3. Create adapter

Create an adapter and implement methods for cteating ViewHolders

public class PersonAdapter extends RecyclerAdapter<PersonDH> {

  private static final int HEADER = 1;
  private static final int PERSON = 11;
  private static final int FAVOURITE = 0;

  @NonNull
  @Override
  protected RecyclerVH<PersonDH> createVH(View view, int viewType) {
      switch (viewType) {
          case PERSON:
              return new PersonVH(view);
          case HEADER:
              return new HeaderVH(view);
          default:
              return new FavouriteVH(view);
      }
  }

  @Override
  protected int getLayoutRes(int viewType) {
      switch (viewType) {
          case PERSON:
              return R.layout.item_person;
          case HEADER:
              return R.layout.item_header;
          default:
              return R.layout.item_favourite;
      }
  }

  @Override
  public int getItemViewType(int position) {
      PersonDH dh = getItem(position);
      if (dh.headerName != null) {
          return HEADER;
      } else {
          return dh.isFavourite ? FAVOURITE : PERSON;
      }
  }
}

4. Use adapter

Init your adapter and set in RecyclerView :

      rvSimpleList = (RecyclerView) view.findViewById(R.id.rvTypedList);
      rvSimpleList.setLayoutManager(new LinearLayoutManager(getContext()));

      adapter = new PersonAdapter();
      adapter.setOnCardClickListener(new OnCardClickListener() {
          @Override
          public void onClick(View view, int position, int viewType) {
              //do something
          }
      });

      rvSimpleList.setAdapter(adapter);

For more information see sample.

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.