io.realm

Class RealmRecyclerViewAdapter<T extends io.realm.RealmObject,VH extends android.support.v7.widget.RecyclerView.ViewHolder>

java.lang.Object

android.support.v7.widget.RecyclerView.Adapter<VH>

io.realm.RealmRecyclerViewAdapter<T,VH>

Type Parameters:

T - type of RealmObject stored in the adapter.

VH - type of RecyclerView.ViewHolder used in the adapter.

public abstract class RealmRecyclerViewAdapter<T extends io.realm.RealmObject,VH extends android.support.v7.widget.RecyclerView.ViewHolder>
extends android.support.v7.widget.RecyclerView.Adapter<VH>

The RealmBaseRecyclerAdapter class is an abstract utility class for binding RecyclerView UI elements to Realm data.

This adapter will automatically handle any updates to its data and call notifyDataSetChanged() as appropriate. Currently there is no support for RecyclerView's data callback methods like notifyItemInserted(int), notifyItemRemoved(int), notifyItemChanged(int) etc. It means that, there is no possibility to use default data animations.

The RealmAdapter will stop receiving updates if the Realm instance providing the OrderedRealmCollection is closed.

Constructor Summary

Constructors

Constructor and Description
RealmRecyclerViewAdapter(android.content.Context context, io.realm.OrderedRealmCollection<T> data, boolean autoUpdate)

Method Summary

Modifier and Type	Method and Description
io.realm.OrderedRealmCollection<T>	getData() Returns data associated with this adapter.
T	getItem(int index) Returns the item associated with the specified position.
int	getItemCount()
long	getItemId(int index) Returns the current ID for an item.
void	onAttachedToRecyclerView(android.support.v7.widget.RecyclerView recyclerView)
void	onDetachedFromRecyclerView(android.support.v7.widget.RecyclerView recyclerView)
void	updateData(io.realm.OrderedRealmCollection<T> data) Updates the data associated to the Adapter.

Methods inherited from class android.support.v7.widget.RecyclerView.Adapter

bindViewHolder, createViewHolder, getItemViewType, hasObservers, hasStableIds, notifyDataSetChanged, notifyItemChanged, notifyItemChanged, notifyItemInserted, notifyItemMoved, notifyItemRangeChanged, notifyItemRangeChanged, notifyItemRangeInserted, notifyItemRangeRemoved, notifyItemRemoved, onBindViewHolder, onBindViewHolder, onCreateViewHolder, onFailedToRecycleView, onViewAttachedToWindow, onViewDetachedFromWindow, onViewRecycled, registerAdapterDataObserver, setHasStableIds, unregisterAdapterDataObserver

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RealmRecyclerViewAdapter

public RealmRecyclerViewAdapter(android.content.Context context,
                                io.realm.OrderedRealmCollection<T> data,
                                boolean autoUpdate)

Method Detail

onAttachedToRecyclerView

public void onAttachedToRecyclerView(android.support.v7.widget.RecyclerView recyclerView)

Overrides:

onAttachedToRecyclerView in class android.support.v7.widget.RecyclerView.Adapter<VH extends android.support.v7.widget.RecyclerView.ViewHolder>

onDetachedFromRecyclerView

public void onDetachedFromRecyclerView(android.support.v7.widget.RecyclerView recyclerView)

Overrides:

onDetachedFromRecyclerView in class android.support.v7.widget.RecyclerView.Adapter<VH extends android.support.v7.widget.RecyclerView.ViewHolder>

getItemId

public long getItemId(int index)

Returns the current ID for an item. Note that item IDs are not stable so you cannot rely on the item ID being the same after notifyDataSetChanged() or updateData(OrderedRealmCollection) has been called.

Overrides:

getItemId in class android.support.v7.widget.RecyclerView.Adapter<VH extends android.support.v7.widget.RecyclerView.ViewHolder>

Parameters:

index - position of item in the adapter.

Returns:

current item ID.

getItemCount

public int getItemCount()

Specified by:

getItemCount in class android.support.v7.widget.RecyclerView.Adapter<VH extends android.support.v7.widget.RecyclerView.ViewHolder>

getItem

public T getItem(int index)

Returns the item associated with the specified position. Can return null if provided Realm instance by OrderedRealmCollection is closed.

Parameters:

index - index of the item.

Returns:

the item at the specified position, null if adapter data is not valid.

getData

public io.realm.OrderedRealmCollection<T> getData()

Returns data associated with this adapter.

Returns:

adapter data.

updateData

public void updateData(io.realm.OrderedRealmCollection<T> data)

Updates the data associated to the Adapter. Useful when the query has been changed. If the query does not change you might consider using the automaticUpdate feature.

Parameters:

data - the new OrderedRealmCollection to display.