Package com.stfalcon.chatkit.dialogs

Class DialogsListAdapter<DIALOG extends IDialog>

java.lang.Object

android.support.v7.widget.RecyclerView.Adapter<DialogsListAdapter.BaseDialogViewHolder>

com.stfalcon.chatkit.dialogs.DialogsListAdapter<DIALOG>

public class DialogsListAdapter<DIALOG extends IDialog>
extends android.support.v7.widget.RecyclerView.Adapter<DialogsListAdapter.BaseDialogViewHolder>

Adapter for DialogsList

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	DialogsListAdapter.BaseDialogViewHolder<DIALOG extends IDialog>
static class	DialogsListAdapter.DialogViewHolder<DIALOG extends IDialog>
static interface	DialogsListAdapter.OnDialogClickListener<DIALOG extends IDialog>
static interface	DialogsListAdapter.OnDialogLongClickListener<DIALOG extends IDialog>
static interface	DialogsListAdapter.OnDialogViewClickListener<DIALOG extends IDialog>
static interface	DialogsListAdapter.OnDialogViewLongClickListener<DIALOG extends IDialog>

Field Summary

Fields

Modifier and Type	Field	Description
protected java.util.List<DIALOG>	items

Constructor Summary

Constructors

Constructor	Description
DialogsListAdapter(int itemLayoutId, ImageLoader imageLoader)	For custom list item layout and default view holder
DialogsListAdapter(int itemLayoutId, java.lang.Class<? extends DialogsListAdapter.BaseDialogViewHolder> holderClass, ImageLoader imageLoader)	For custom list item layout and custom view holder
DialogsListAdapter(ImageLoader imageLoader)	For default list item layout and view holder

Method Summary

Modifier and Type	Method	Description
void	addItem(int position, DIALOG dialog)	Add dialog to dialogs list
void	addItem(DIALOG dialog)	Add dialog to the end of dialogs list
void	addItems(java.util.List<DIALOG> newItems)	Add dialogs items
void	clear()	clear dialogs list
void	deleteById(java.lang.String id)	remove item with id
int	getDialogPosition(DIALOG dialog)
ImageLoader	getImageLoader()
DIALOG	getItemById(java.lang.String id)	Find an item by its id
int	getItemCount()
DialogsListAdapter.OnDialogClickListener	getOnDialogClickListener()
DialogsListAdapter.OnDialogViewClickListener	getOnDialogViewClickListener()
DialogsListAdapter.OnDialogViewLongClickListener<DIALOG>	getOnDialogViewLongClickListener()
DialogsListAdapter.OnDialogLongClickListener	getOnLongItemClickListener()
boolean	isEmpty()	Returns true if, and only if, dialogs count in adapter is non-zero.
void	moveItem(int fromPosition, int toPosition)	Move an item
void	onBindViewHolder(DialogsListAdapter.BaseDialogViewHolder holder, int position)
DialogsListAdapter.BaseDialogViewHolder	onCreateViewHolder(android.view.ViewGroup parent, int viewType)
void	setDatesFormatter(DateFormatter.Formatter datesFormatter)	Sets custom DateFormatter.Formatter for text representation of last message date.
void	setImageLoader(ImageLoader imageLoader)	Register a callback to be invoked when image need to load.
void	setItems(java.util.List<DIALOG> items)	Set dialogs list
void	setOnDialogClickListener(DialogsListAdapter.OnDialogClickListener<DIALOG> onDialogClickListener)	Register a callback to be invoked when item is clicked.
void	setOnDialogLongClickListener(DialogsListAdapter.OnDialogLongClickListener<DIALOG> onLongItemClickListener)	Register a callback to be invoked when item is long clicked.
void	setOnDialogViewClickListener(DialogsListAdapter.OnDialogViewClickListener<DIALOG> clickListener)	Register a callback to be invoked when dialog view is clicked.
void	setOnDialogViewLongClickListener(DialogsListAdapter.OnDialogViewLongClickListener<DIALOG> clickListener)	Register a callback to be invoked when item view is long clicked.
void	sort(java.util.Comparator<DIALOG> comparator)	Sort items with rules of comparator
void	sortByLastMessageDate()	Sort dialog by last message date
boolean	updateDialogWithMessage(java.lang.String dialogId, IMessage message)	Update last message in dialog and swap item to top of list.
void	updateItem(int position, DIALOG item)	Update dialog by position in dialogs list
void	updateItemById(DIALOG item)	Update dialog by dialog id
void	upsertItem(DIALOG item)	Upsert dialog in dialogs list or add it to then end of dialogs list

Methods inherited from class java.lang.Object

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

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

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

Field Detail

items

protected java.util.List<DIALOG extends IDialog> items

Constructor Detail

DialogsListAdapter

public DialogsListAdapter(ImageLoader imageLoader)

For default list item layout and view holder

Parameters:

imageLoader - image loading method

DialogsListAdapter

public DialogsListAdapter(@LayoutRes
                          int itemLayoutId,
                          ImageLoader imageLoader)

For custom list item layout and default view holder

Parameters:

itemLayoutId - custom list item resource id

imageLoader - image loading method

DialogsListAdapter

public DialogsListAdapter(@LayoutRes
                          int itemLayoutId,
                          java.lang.Class<? extends DialogsListAdapter.BaseDialogViewHolder> holderClass,
                          ImageLoader imageLoader)

For custom list item layout and custom view holder

Parameters:

itemLayoutId - custom list item resource id

holderClass - custom view holder class

imageLoader - image loading method

Method Detail

onBindViewHolder

public void onBindViewHolder(DialogsListAdapter.BaseDialogViewHolder holder,
                             int position)

Specified by:

onBindViewHolder in class android.support.v7.widget.RecyclerView.Adapter<DialogsListAdapter.BaseDialogViewHolder>

onCreateViewHolder

public DialogsListAdapter.BaseDialogViewHolder onCreateViewHolder(android.view.ViewGroup parent,
                                                                  int viewType)

Specified by:

onCreateViewHolder in class android.support.v7.widget.RecyclerView.Adapter<DialogsListAdapter.BaseDialogViewHolder>

getItemCount

public int getItemCount()

Specified by:

getItemCount in class android.support.v7.widget.RecyclerView.Adapter<DialogsListAdapter.BaseDialogViewHolder>

Returns:

size of dialogs list

deleteById

public void deleteById(java.lang.String id)

remove item with id

Parameters:

id - dialog i

isEmpty

public boolean isEmpty()

Returns true if, and only if, dialogs count in adapter is non-zero.

Returns:

true if size is 0, otherwise false

clear

public void clear()

clear dialogs list

setItems

public void setItems(java.util.List<DIALOG> items)

Set dialogs list

Parameters:

items - dialogs list

addItems

public void addItems(java.util.List<DIALOG> newItems)

Add dialogs items

Parameters:

newItems - new dialogs list

addItem

public void addItem(DIALOG dialog)

Add dialog to the end of dialogs list

Parameters:

dialog - dialog item

addItem

public void addItem(int position,
                    DIALOG dialog)

Add dialog to dialogs list

Parameters:

dialog - dialog item

position - position in dialogs list

moveItem

public void moveItem(int fromPosition,
                     int toPosition)

Move an item

Parameters:

fromPosition - the actual position of the item

toPosition - the new position of the item

updateItem

public void updateItem(int position,
                       DIALOG item)

Update dialog by position in dialogs list

Parameters:

position - position in dialogs list

item - new dialog item

updateItemById

public void updateItemById(DIALOG item)

Update dialog by dialog id

Parameters:

item - new dialog item

upsertItem

public void upsertItem(DIALOG item)

Upsert dialog in dialogs list or add it to then end of dialogs list

Parameters:

item - dialog item

getItemById

@Nullable
public DIALOG getItemById(java.lang.String id)

Find an item by its id

Parameters:

id - the wanted item's id

Returns:

the found item, or null

updateDialogWithMessage

public boolean updateDialogWithMessage(java.lang.String dialogId,
                                       IMessage message)

Update last message in dialog and swap item to top of list.

Parameters:

dialogId - Dialog ID

message - New message

Returns:

false if dialog doesn't exist.

sortByLastMessageDate

public void sortByLastMessageDate()

Sort dialog by last message date

sort

public void sort(java.util.Comparator<DIALOG> comparator)

Sort items with rules of comparator

Parameters:

comparator - Comparator

getImageLoader

public ImageLoader getImageLoader()

Returns:

registered image loader

setImageLoader

public void setImageLoader(ImageLoader imageLoader)

Register a callback to be invoked when image need to load.

Parameters:

imageLoader - image loading method

getOnDialogClickListener

public DialogsListAdapter.OnDialogClickListener getOnDialogClickListener()

Returns:

the item click callback.

setOnDialogClickListener

public void setOnDialogClickListener(DialogsListAdapter.OnDialogClickListener<DIALOG> onDialogClickListener)

Register a callback to be invoked when item is clicked.

Parameters:

onDialogClickListener - on click item callback

getOnDialogViewClickListener

public DialogsListAdapter.OnDialogViewClickListener getOnDialogViewClickListener()

Returns:

the view click callback.

setOnDialogViewClickListener

public void setOnDialogViewClickListener(DialogsListAdapter.OnDialogViewClickListener<DIALOG> clickListener)

Register a callback to be invoked when dialog view is clicked.

Parameters:

clickListener - on click item callback

getOnLongItemClickListener

public DialogsListAdapter.OnDialogLongClickListener getOnLongItemClickListener()

Returns:

on long click item callback

setOnDialogLongClickListener

public void setOnDialogLongClickListener(DialogsListAdapter.OnDialogLongClickListener<DIALOG> onLongItemClickListener)

Register a callback to be invoked when item is long clicked.

Parameters:

onLongItemClickListener - on long click item callback

getOnDialogViewLongClickListener

public DialogsListAdapter.OnDialogViewLongClickListener<DIALOG> getOnDialogViewLongClickListener()

Returns:

on view long click callback

setOnDialogViewLongClickListener

public void setOnDialogViewLongClickListener(DialogsListAdapter.OnDialogViewLongClickListener<DIALOG> clickListener)

Register a callback to be invoked when item view is long clicked.

Parameters:

clickListener - on long click item callback

setDatesFormatter

public void setDatesFormatter(DateFormatter.Formatter datesFormatter)

Sets custom DateFormatter.Formatter for text representation of last message date.

getDialogPosition

public int getDialogPosition(DIALOG dialog)

Returns:

the position of a dialog in the dialogs list.