it.polimi.dima.mediatracker.adapters.media_items_list

Class SectionedRecyclerViewAdapter<T extends Sectioned>

java.lang.Object

it.polimi.dima.mediatracker.adapters.media_items_list.SectionedRecyclerViewAdapter<T>

Direct Known Subclasses:

MediaItemsAbstractAdapter

public abstract class SectionedRecyclerViewAdapter<T extends Sectioned>
extends java.lang.Object

Abstract adapter that allows to display a list of items divided into sections. Actually, this class is just a "wrapper" that allows to interface with the real (private) adapter. Usage is very similar to a normal adapter, the only difference is the method setAdapterToRecyclerView(RecyclerView) The wrapper is interfaced using the positions of the items list passed as parameter but internally it uses a list that contains both items and sections

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	SectionedRecyclerViewAdapter.SectionedAdapterTouchHelperCallback TouchHelper Callback for the adapter that allows to manage swiping and drag&drop on the list
static class	SectionedRecyclerViewAdapter.SectionViewHolder ViewHolder for the private adapter that describes a section

Field Summary

Fields

Modifier and Type	Field and Description
static int	VIEW_TYPE_ITEM
static int	VIEW_TYPE_SECTION

Constructor Summary

Constructors

Constructor and Description
SectionedRecyclerViewAdapter()

Method Summary

Modifier and Type	Method and Description
void	addItemsAtTheEndAndNotify(java.util.List<T> newItems) Adds the given items at the end of the current list and notifies the underlying adapter of the data set change
void	enableMovement(boolean enable) Allows to enable/disable movement
void	enableSectioning(boolean enable) Allows to enable/disable the sections
T	get(int position) Getter
int	getItemCount()
void	moveItemAndNotify(int fromPosition, int toPosition, Section fromSection, Section toSection) Allows to move the item at the given "from position" (section "from section") to the "to position" (section "to section") NOTE: if fromPosition=toPosition but fromSection!=toSection the item is not moved in the array but its section changes (happens when the item is the last before a section and it gets moved to the first position of the next section)
void	notifyItemChanged(int position) Informs the underlying adapter that the item at the given position has changed
void	notifyItemRangeChanged(int positionStart, int itemCount) Informs the underlying adapter that "itemCount" items have changed starting from "positionStart"
void	notifyItemRangeInserted(int positionStart, int itemCount) Informs the underlying adapter that "itemCount" items have been added starting from "positionStart"
void	removeItemAndNotify(int position) Allows to remove the item at the given position and notify the underlying adapter of the removal
void	setAdapterToRecyclerView(android.support.v7.widget.RecyclerView recyclerView) Allows to set the underlying adapter to the RecyclerView
void	setEmptyView(View emptyView) Setter
void	setItemsAndNotifyDataSetChanged(java.util.List<T> items) Reloads the whole list of items and notifies the underlying adapter of the data set change

Methods inherited from class java.lang.Object

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

Field Detail

VIEW_TYPE_SECTION

public static final int VIEW_TYPE_SECTION

See Also:

Constant Field Values

VIEW_TYPE_ITEM

public static final int VIEW_TYPE_ITEM

See Also:

Constant Field Values

Constructor Detail

SectionedRecyclerViewAdapter

public SectionedRecyclerViewAdapter()

Method Detail

enableSectioning

public void enableSectioning(boolean enable)

Allows to enable/disable the sections

Parameters:

enable - true if sections are to be displayed

enableMovement

public void enableMovement(boolean enable)

Allows to enable/disable movement

Parameters:

enable - true if movement is allowed

removeItemAndNotify

public void removeItemAndNotify(int position)

Allows to remove the item at the given position and notify the underlying adapter of the removal

Parameters:

position - the item position to remove

moveItemAndNotify

public void moveItemAndNotify(int fromPosition,
                              int toPosition,
                              Section fromSection,
                              Section toSection)

Allows to move the item at the given "from position" (section "from section") to the "to position" (section "to section") NOTE: if fromPosition=toPosition but fromSection!=toSection the item is not moved in the array but its section changes (happens when the item is the last before a section and it gets moved to the first position of the next section)

Parameters:

fromPosition - the starting position

toPosition - the final position

fromSection - the starting section

toSection - the final section

setItemsAndNotifyDataSetChanged

public void setItemsAndNotifyDataSetChanged(java.util.List<T> items)

Reloads the whole list of items and notifies the underlying adapter of the data set change

Parameters:

items - the new items

addItemsAtTheEndAndNotify

public void addItemsAtTheEndAndNotify(java.util.List<T> newItems)

Adds the given items at the end of the current list and notifies the underlying adapter of the data set change

Parameters:

newItems - the items to be added

notifyItemChanged

public void notifyItemChanged(int position)

Informs the underlying adapter that the item at the given position has changed

Parameters:

position - the changed item position

notifyItemRangeChanged

public void notifyItemRangeChanged(int positionStart,
                                   int itemCount)

Informs the underlying adapter that "itemCount" items have changed starting from "positionStart"

Parameters:

positionStart - starting position

itemCount - number of items that have changed

notifyItemRangeInserted

public void notifyItemRangeInserted(int positionStart,
                                    int itemCount)

Informs the underlying adapter that "itemCount" items have been added starting from "positionStart"

Parameters:

positionStart - starting position

itemCount - number of items that have been inserted

get

public T get(int position)

Getter

Parameters:

position - the item position

Returns:

the item at the given position

getItemCount

public int getItemCount()

See Also:

RecyclerView.Adapter#getItemCount()

setAdapterToRecyclerView

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

Allows to set the underlying adapter to the RecyclerView

Parameters:

recyclerView - the RecyclerView that needs the adapter

setEmptyView

public void setEmptyView(View emptyView)

Setter

Parameters:

emptyView - the view to be displayed if the adapter is empty