RecyclerView and Adapters in Android Java

Introduction to RecyclerView

RecyclerView is a more advanced and flexible version of ListView for displaying large data sets efficiently. It recycles item views as they scroll off-screen, providing better performance and memory management.

Basic RecyclerView Setup

1. Add Dependencies

dependencies {
implementation 'androidx.recyclerview:recyclerview:1.3.2'
implementation 'androidx.cardview:cardview:1.0.0'
}

2. Layout Files

activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
android:padding="16dp">
<androidx.recyclerview.widget.RecyclerView
android:id="@+id/recyclerView"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</LinearLayout>

item_layout.xml (Individual item layout)

<?xml version="1.0" encoding="utf-8"?>
<androidx.cardview.widget.CardView xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_margin="8dp"
app:cardCornerRadius="8dp"
app:cardElevation="4dp">
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
android:padding="16dp">
<ImageView
android:id="@+id/imageView"
android:layout_width="60dp"
android:layout_height="60dp"
android:src="@mipmap/ic_launcher" />
<LinearLayout
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1"
android:layout_marginStart="16dp"
android:orientation="vertical">
<TextView
android:id="@+id/textTitle"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="Title"
android:textSize="18sp"
android:textStyle="bold" />
<TextView
android:id="@+id/textDescription"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="Description"
android:textSize="14sp"
android:layout_marginTop="4dp" />
</LinearLayout>
<ImageButton
android:id="@+id/btnDelete"
android:layout_width="40dp"
android:layout_height="40dp"
android:src="@android:drawable/ic_delete"
android:background="?android:attr/selectableItemBackground" />
</LinearLayout>
</androidx.cardview.widget.CardView>

Data Model Class

public class Item {
private String title;
private String description;
private int imageResource;
private boolean isSelected;
public Item(String title, String description, int imageResource) {
this.title = title;
this.description = description;
this.imageResource = imageResource;
this.isSelected = false;
}
// Getters and Setters
public String getTitle() { return title; }
public void setTitle(String title) { this.title = title; }
public String getDescription() { return description; }
public void setDescription(String description) { this.description = description; }
public int getImageResource() { return imageResource; }
public void setImageResource(int imageResource) { this.imageResource = imageResource; }
public boolean isSelected() { return isSelected; }
public void setSelected(boolean selected) { isSelected = selected; }
}

ViewHolder Pattern

Basic ViewHolder

import android.view.View;
import android.widget.ImageButton;
import android.widget.ImageView;
import android.widget.TextView;
import androidx.annotation.NonNull;
import androidx.recyclerview.widget.RecyclerView;
public class ItemViewHolder extends RecyclerView.ViewHolder {
public ImageView imageView;
public TextView textTitle;
public TextView textDescription;
public ImageButton btnDelete;
public ItemViewHolder(@NonNull View itemView) {
super(itemView);
imageView = itemView.findViewById(R.id.imageView);
textTitle = itemView.findViewById(R.id.textTitle);
textDescription = itemView.findViewById(R.id.textDescription);
btnDelete = itemView.findViewById(R.id.btnDelete);
}
}

RecyclerView Adapter

Basic Adapter Implementation

import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import androidx.annotation.NonNull;
import androidx.recyclerview.widget.RecyclerView;
import java.util.List;
public class ItemAdapter extends RecyclerView.Adapter<ItemViewHolder> {
private List<Item> itemList;
private OnItemClickListener listener;
// Interface for click events
public interface OnItemClickListener {
void onItemClick(int position);
void onDeleteClick(int position);
}
public ItemAdapter(List<Item> itemList, OnItemClickListener listener) {
this.itemList = itemList;
this.listener = listener;
}
@NonNull
@Override
public ItemViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
View view = LayoutInflater.from(parent.getContext())
.inflate(R.layout.item_layout, parent, false);
return new ItemViewHolder(view);
}
@Override
public void onBindViewHolder(@NonNull ItemViewHolder holder, int position) {
Item currentItem = itemList.get(position);
holder.imageView.setImageResource(currentItem.getImageResource());
holder.textTitle.setText(currentItem.getTitle());
holder.textDescription.setText(currentItem.getDescription());
// Handle item click
holder.itemView.setOnClickListener(v -> {
if (listener != null) {
listener.onItemClick(position);
}
});
// Handle delete button click
holder.btnDelete.setOnClickListener(v -> {
if (listener != null) {
listener.onDeleteClick(position);
}
});
}
@Override
public int getItemCount() {
return itemList.size();
}
}

Advanced Adapter with Multiple View Types

Multiple View Types Adapter

import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import androidx.annotation.NonNull;
import androidx.recyclerview.widget.RecyclerView;
import java.util.List;
public class MultiTypeAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
private List<Object> items;
private static final int TYPE_HEADER = 0;
private static final int TYPE_ITEM = 1;
private static final int TYPE_FOOTER = 2;
public MultiTypeAdapter(List<Object> items) {
this.items = items;
}
@Override
public int getItemViewType(int position) {
Object item = items.get(position);
if (item instanceof Header) {
return TYPE_HEADER;
} else if (item instanceof Footer) {
return TYPE_FOOTER;
} else {
return TYPE_ITEM;
}
}
@NonNull
@Override
public RecyclerView.ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
LayoutInflater inflater = LayoutInflater.from(parent.getContext());
switch (viewType) {
case TYPE_HEADER:
View headerView = inflater.inflate(R.layout.header_layout, parent, false);
return new HeaderViewHolder(headerView);
case TYPE_FOOTER:
View footerView = inflater.inflate(R.layout.footer_layout, parent, false);
return new FooterViewHolder(footerView);
default:
View itemView = inflater.inflate(R.layout.item_layout, parent, false);
return new ItemViewHolder(itemView);
}
}
@Override
public void onBindViewHolder(@NonNull RecyclerView.ViewHolder holder, int position) {
switch (holder.getItemViewType()) {
case TYPE_HEADER:
Header header = (Header) items.get(position);
HeaderViewHolder headerHolder = (HeaderViewHolder) holder;
headerHolder.textHeader.setText(header.getTitle());
break;
case TYPE_ITEM:
Item item = (Item) items.get(position);
ItemViewHolder itemHolder = (ItemViewHolder) holder;
itemHolder.textTitle.setText(item.getTitle());
itemHolder.textDescription.setText(item.getDescription());
break;
case TYPE_FOOTER:
Footer footer = (Footer) items.get(position);
FooterViewHolder footerHolder = (FooterViewHolder) holder;
footerHolder.textFooter.setText(footer.getMessage());
break;
}
}
@Override
public int getItemCount() {
return items.size();
}
// Different ViewHolder classes
static class HeaderViewHolder extends RecyclerView.ViewHolder {
TextView textHeader;
HeaderViewHolder(View view) {
super(view);
textHeader = view.findViewById(R.id.textHeader);
}
}
static class FooterViewHolder extends RecyclerView.ViewHolder {
TextView textFooter;
FooterViewHolder(View view) {
super(view);
textFooter = view.findViewById(R.id.textFooter);
}
}
}

DiffUtil for Efficient Updates

Using DiffUtil for Better Performance

import androidx.recyclerview.widget.DiffUtil;
import java.util.List;
public class ItemDiffCallback extends DiffUtil.Callback {
private final List<Item> oldList;
private final List<Item> newList;
public ItemDiffCallback(List<Item> oldList, List<Item> newList) {
this.oldList = oldList;
this.newList = newList;
}
@Override
public int getOldListSize() {
return oldList.size();
}
@Override
public int getNewListSize() {
return newList.size();
}
@Override
public boolean areItemsTheSame(int oldItemPosition, int newItemPosition) {
Item oldItem = oldList.get(oldItemPosition);
Item newItem = newList.get(newItemPosition);
return oldItem.getTitle().equals(newItem.getTitle());
}
@Override
public boolean areContentsTheSame(int oldItemPosition, int newItemPosition) {
Item oldItem = oldList.get(oldItemPosition);
Item newItem = newList.get(newItemPosition);
return oldItem.getTitle().equals(newItem.getTitle()) &&
oldItem.getDescription().equals(newItem.getDescription()) &&
oldItem.getImageResource() == newItem.getImageResource();
}
}
// Enhanced Adapter with DiffUtil
public class EfficientItemAdapter extends RecyclerView.Adapter<ItemViewHolder> {
private List<Item> items;
private OnItemClickListener listener;
public EfficientItemAdapter(List<Item> items, OnItemClickListener listener) {
this.items = items;
this.listener = listener;
}
public void updateItems(List<Item> newItems) {
DiffUtil.DiffResult diffResult = DiffUtil.calculateDiff(
new ItemDiffCallback(this.items, newItems)
);
this.items.clear();
this.items.addAll(newItems);
diffResult.dispatchUpdatesTo(this);
}
// ... rest of the adapter methods
}

Complete MainActivity Implementation

import android.os.Bundle;
import android.widget.Toast;
import androidx.appcompat.app.AppCompatActivity;
import androidx.recyclerview.widget.LinearLayoutManager;
import androidx.recyclerview.widget.RecyclerView;
import java.util.ArrayList;
import java.util.List;
public class MainActivity extends AppCompatActivity implements ItemAdapter.OnItemClickListener {
private RecyclerView recyclerView;
private ItemAdapter adapter;
private List<Item> itemList;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
initializeData();
setupRecyclerView();
}
private void initializeData() {
itemList = new ArrayList<>();
itemList.add(new Item("Java", "Object-oriented programming language", R.drawable.java_icon));
itemList.add(new Item("Kotlin", "Modern programming language for Android", R.drawable.kotlin_icon));
itemList.add(new Item("Python", "High-level programming language", R.drawable.python_icon));
itemList.add(new Item("JavaScript", "Scripting language for web development", R.drawable.js_icon));
itemList.add(new Item("C++", "General-purpose programming language", R.drawable.cpp_icon));
// Add more items as needed
}
private void setupRecyclerView() {
recyclerView = findViewById(R.id.recyclerView);
// Set layout manager
LinearLayoutManager layoutManager = new LinearLayoutManager(this);
recyclerView.setLayoutManager(layoutManager);
// Set adapter
adapter = new ItemAdapter(itemList, this);
recyclerView.setAdapter(adapter);
// Add item decoration for spacing
recyclerView.addItemDecoration(new ItemDecoration(16));
}
@Override
public void onItemClick(int position) {
Item item = itemList.get(position);
Toast.makeText(this, "Clicked: " + item.getTitle(), Toast.LENGTH_SHORT).show();
// Toggle selection
item.setSelected(!item.isSelected());
adapter.notifyItemChanged(position);
}
@Override
public void onDeleteClick(int position) {
Item item = itemList.get(position);
itemList.remove(position);
adapter.notifyItemRemoved(position);
Toast.makeText(this, "Deleted: " + item.getTitle(), Toast.LENGTH_SHORT).show();
}
// Method to add new item
public void addItem(Item newItem) {
itemList.add(0, newItem); // Add to beginning
adapter.notifyItemInserted(0);
recyclerView.scrollToPosition(0);
}
// Method to update item
public void updateItem(int position, Item updatedItem) {
itemList.set(position, updatedItem);
adapter.notifyItemChanged(position);
}
}

Custom Item Decoration

import android.graphics.Rect;
import android.view.View;
import androidx.annotation.NonNull;
import androidx.recyclerview.widget.RecyclerView;
public class ItemDecoration extends RecyclerView.ItemDecoration {
private final int spacing;
public ItemDecoration(int spacing) {
this.spacing = spacing;
}
@Override
public void getItemOffsets(@NonNull Rect outRect, @NonNull View view, 
@NonNull RecyclerView parent, @NonNull RecyclerView.State state) {
outRect.left = spacing;
outRect.right = spacing;
outRect.bottom = spacing;
// Add top margin only for the first item
if (parent.getChildAdapterPosition(view) == 0) {
outRect.top = spacing;
}
}
}

Advanced Features

1. Swipe to Delete

import androidx.recyclerview.widget.ItemTouchHelper;
import androidx.recyclerview.widget.RecyclerView;
public class SwipeToDeleteCallback extends ItemTouchHelper.SimpleCallback {
private ItemAdapter adapter;
public SwipeToDeleteCallback(ItemAdapter adapter) {
super(0, ItemTouchHelper.LEFT | ItemTouchHelper.RIGHT);
this.adapter = adapter;
}
@Override
public boolean onMove(@NonNull RecyclerView recyclerView, 
@NonNull RecyclerView.ViewHolder viewHolder, 
@NonNull RecyclerView.ViewHolder target) {
return false; // We don't support drag & drop
}
@Override
public void onSwiped(@NonNull RecyclerView.ViewHolder viewHolder, int direction) {
int position = viewHolder.getAdapterPosition();
adapter.deleteItem(position);
}
}
// Usage in MainActivity
private void enableSwipeToDelete() {
SwipeToDeleteCallback swipeToDeleteCallback = new SwipeToDeleteCallback(adapter);
ItemTouchHelper itemTouchHelper = new ItemTouchHelper(swipeToDeleteCallback);
itemTouchHelper.attachToRecyclerView(recyclerView);
}

2. Drag and Drop

public class DragDropCallback extends ItemTouchHelper.Callback {
private final ItemAdapter adapter;
public DragDropCallback(ItemAdapter adapter) {
this.adapter = adapter;
}
@Override
public boolean isLongPressDragEnabled() {
return true;
}
@Override
public boolean isItemViewSwipeEnabled() {
return false;
}
@Override
public int getMovementFlags(@NonNull RecyclerView recyclerView, 
@NonNull RecyclerView.ViewHolder viewHolder) {
int dragFlags = ItemTouchHelper.UP | ItemTouchHelper.DOWN;
return makeMovementFlags(dragFlags, 0);
}
@Override
public boolean onMove(@NonNull RecyclerView recyclerView,
@NonNull RecyclerView.ViewHolder source,
@NonNull RecyclerView.ViewHolder target) {
adapter.onItemMove(source.getAdapterPosition(), target.getAdapterPosition());
return true;
}
@Override
public void onSwiped(@NonNull RecyclerView.ViewHolder viewHolder, int direction) {
// Not used
}
}
// Add this method to your adapter
public void onItemMove(int fromPosition, int toPosition) {
Collections.swap(itemList, fromPosition, toPosition);
notifyItemMoved(fromPosition, toPosition);
}

3. Endless Scrolling

public abstract class EndlessScrollListener extends RecyclerView.OnScrollListener {
private LinearLayoutManager layoutManager;
private int visibleThreshold = 5;
private int currentPage = 0;
private int previousTotalItemCount = 0;
private boolean loading = true;
private int startingPageIndex = 0;
public EndlessScrollListener(LinearLayoutManager layoutManager) {
this.layoutManager = layoutManager;
}
@Override
public void onScrolled(@NonNull RecyclerView view, int dx, int dy) {
int lastVisibleItemPosition = layoutManager.findLastVisibleItemPosition();
int totalItemCount = layoutManager.getItemCount();
if (totalItemCount < previousTotalItemCount) {
this.currentPage = this.startingPageIndex;
this.previousTotalItemCount = totalItemCount;
if (totalItemCount == 0) {
this.loading = true;
}
}
if (loading && (totalItemCount > previousTotalItemCount)) {
loading = false;
previousTotalItemCount = totalItemCount;
}
if (!loading && (lastVisibleItemPosition + visibleThreshold) > totalItemCount) {
currentPage++;
onLoadMore(currentPage, totalItemCount, view);
loading = true;
}
}
public abstract void onLoadMore(int page, int totalItemsCount, RecyclerView view);
}
// Usage
recyclerView.addOnScrollListener(new EndlessScrollListener(layoutManager) {
@Override
public void onLoadMore(int page, int totalItemsCount, RecyclerView view) {
// Load more data
loadMoreData(page);
}
});

Best Practices and Performance Tips

1. ViewHolder Pattern

Always use ViewHolder pattern
Store view references in ViewHolder
Avoid findViewById() in onBindViewHolder()

2. Efficient Data Updates

Use DiffUtil for large datasets
Prefer notifyItemChanged() over notifyDataSetChanged()
Use stable IDs when possible

3. Memory Management

Clear references in onViewRecycled()
Use weak references for click listeners
Implement proper lifecycle management

4. Layout Optimization

Use ConstraintLayout for complex item layouts
Avoid nested weights
Use appropriate view types

Common Issues and Solutions

1. Item Click Not Working

// Make sure items are clickable
holder.itemView.setClickable(true);
// Or set focusable if needed
holder.itemView.setFocusable(true);

2. RecyclerView Not Showing

// Check layout manager is set
recyclerView.setLayoutManager(new LinearLayoutManager(this));
// Check adapter is set
recyclerView.setAdapter(adapter);
// Check data is not empty
if (itemList.isEmpty()) {
// Show empty state
}

3. Performance Issues

// Use setHasFixedSize(true) if item size doesn't change
recyclerView.setHasFixedSize(true);
// Use setItemViewCacheSize() for better scrolling
recyclerView.setItemViewCacheSize(20);
// Use setRecycledViewPool() for multiple RecyclerViews
RecyclerView.RecycledViewPool sharedPool = new RecyclerView.RecycledViewPool();
recyclerView.setRecycledViewPool(sharedPool);

RecyclerView with custom adapters provides a powerful and efficient way to display lists and grids in Android applications. By following these patterns and best practices, you can create smooth, responsive list interfaces that handle large datasets efficiently.