universum.studios.android.widget.adapter

Class BaseSpinnerAdapter<Item,VH,DVH>

java.lang.Object

android.widget.BaseAdapter

universum.studios.android.widget.adapter.BaseAdapter<Item,VH>

universum.studios.android.widget.adapter.BaseSpinnerAdapter<Item,VH,DVH>

Type Parameters:

Item - Type of the item presented within a data set of a subclass of this BaseSpinnerAdapter.

VH - Type of the view holder used within a subclass of this BaseSpinnerAdapter.

DVH - Type of the drop down view holder used within a subclass of this BaseSpinnerAdapter.

All Implemented Interfaces:

Adapter, ListAdapter, SpinnerAdapter, DataSet<Item>, DataSetAdapter<Item>

Direct Known Subclasses:

SimpleSpinnerAdapter

public abstract class BaseSpinnerAdapter<Item,VH,DVH>
extends BaseAdapter<Item,VH>

A BaseAdapter implementation that may be used to provide optimized adapter also for Spinner widget. This "spinner based" adapter also supports API to store current selected item and its corresponding position. The position of the selected item is stored whenever getView(int, View, ViewGroup) is called. The selected item position may be obtained via getSelectedItemPosition().

Author:

Martin Albedinsky

Field Summary

Fields inherited from class universum.studios.android.widget.adapter.BaseAdapter

mContext, mLayoutInflater, mResources

Fields inherited from interface universum.studios.android.widget.adapter.DataSet

NO_ID, NO_POSITION

Fields inherited from interface android.widget.Adapter

IGNORE_ITEM_VIEW_TYPE, NO_SELECTION

Constructor Summary

Constructors

Constructor and Description
BaseSpinnerAdapter(Context context) Creates a new instance of BaseSpinnerAdapter within the given context.

Method Summary

Modifier and Type	Method and Description
View	getDropDownView(int position, View convertView, ViewGroup parent) Performs optimized algorithm for this method using the Holder pattern.
Item	getSelectedItem() Returns the item model of this adapter for the current selected position.
int	getSelectedItemPosition() Returns the position of the currently selected item.
View	getView(int position, View convertView, ViewGroup parent)
protected void	onBindDropDownViewHolder(DVH viewHolder, int position) Invoked to configure and bind a drop down view of an item from the current data set at the specified position.
protected void	onBindViewHolder(VH viewHolder, int position) This implementation by default invokes #onUpdateViewHolder(Object, Item, int) with item at the current selected position.
protected View	onCreateDropDownView(ViewGroup parent, int position) Invoked to create a drop down view for an item from the current data set at the specified position.
protected DVH	onCreateDropDownViewHolder(View itemView, int position) Invoked to create a view holder for a drop down view of an item from the current data set at the specified position.
protected abstract void	onUpdateViewHolder(DVH viewHolder, Item item, int position) Invoked to update views of the given viewHolder with data of the given cursor.

Methods inherited from class universum.studios.android.widget.adapter.BaseAdapter

currentViewType, getCount, getItemId, hasStableIds, inflate, notifyDataSetActionSelected, notifyDataSetChanged, notifyDataSetInvalidated, onCreateView, onCreateViewHolder, onDataSetActionSelected, registerOnDataChangeListener, registerOnDataSetActionListener, registerOnDataSetListener, restoreInstanceState, saveInstanceState, unregisterOnDataChangeListener, unregisterOnDataSetActionListener, unregisterOnDataSetListener

Methods inherited from class android.widget.BaseAdapter

areAllItemsEnabled, getItemViewType, getViewTypeCount, isEmpty, isEnabled, registerDataSetObserver, unregisterDataSetObserver

Methods inherited from class java.lang.Object

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

Methods inherited from interface universum.studios.android.widget.adapter.DataSetAdapter

isEnabled

Methods inherited from interface universum.studios.android.widget.adapter.DataSet

getItem, getItemCount, hasItemAt, isEmpty

Methods inherited from interface android.widget.Adapter

getItem

Constructor Detail

BaseSpinnerAdapter

public BaseSpinnerAdapter(@NonNull
                          Context context)

Creates a new instance of BaseSpinnerAdapter within the given context.

Parameters:

context - Context in which will be this adapter used.

Method Detail

getSelectedItem

@NonNull
public Item getSelectedItem()

Returns the item model of this adapter for the current selected position.

Returns:

Item obtained via Adapter.getItem(int) for the current selected position.

See Also:

getSelectedItemPosition()

getSelectedItemPosition

public int getSelectedItemPosition()

Returns the position of the currently selected item.

Returns:

Position of item that is currently selected within a related Spinner widget or DataSet.NO_POSITION if this adapter does not have its data set specified.

See Also:

getSelectedItem()

getView

public View getView(int position,
                    @Nullable
                    View convertView,
                    @NonNull
                    ViewGroup parent)

Specified by:

getView in interface Adapter

Overrides:

getView in class BaseAdapter<Item,VH>

getDropDownView

public View getDropDownView(int position,
                            @Nullable
                            View convertView,
                            @NonNull
                            ViewGroup parent)

Performs optimized algorithm for this method using the Holder pattern.

Specified by:

getDropDownView in interface SpinnerAdapter

Overrides:

getDropDownView in class BaseAdapter

onCreateDropDownView

@NonNull
protected View onCreateDropDownView(@NonNull
                                              ViewGroup parent,
                                              int position)

Invoked to create a drop down view for an item from the current data set at the specified position.

This is invoked only if convertView for the specified position in getDropDownView(int, View, ViewGroup) was null.

Parameters:

parent - A parent view, to resolve correct layout params for the newly creating view.

position - Position of the item from the current data set for which should be a new drop down view created.

Returns:

New instance of the requested drop down view.

See Also:

BaseAdapter.inflate(int, ViewGroup)

onCreateDropDownViewHolder

@Nullable
protected DVH onCreateDropDownViewHolder(@NonNull
                                                    View itemView,
                                                    int position)

Invoked to create a view holder for a drop down view of an item from the current data set at the specified position.

This is invoked only if convertView for the specified position in getDropDownView(int, View, ViewGroup) was null, so drop down view along with its corresponding holder need to be created.

Parameters:

itemView - The same view as obtained from onCreateDropDownView(ViewGroup, int) for the specified position.

position - Position of the item from the current data set for which should be a new drop down view holder created.

Returns:

New instance of the requested view holder or null if holder for the drop down view is not required.

onBindViewHolder

protected void onBindViewHolder(@NonNull
                                VH viewHolder,
                                int position)

This implementation by default invokes #onUpdateViewHolder(Object, Item, int) with item at the current selected position.

Specified by:

onBindViewHolder in class BaseAdapter<Item,VH>

Parameters:

viewHolder - The same holder as provided by BaseAdapter.onCreateViewHolder(View, int) for the specified position or converted view as holder as described above.

position - Position of the item from the current data set of which view to bind with data.

See Also:

getSelectedItemPosition()

onBindDropDownViewHolder

protected void onBindDropDownViewHolder(@NonNull
                                        DVH viewHolder,
                                        int position)

Invoked to configure and bind a drop down view of an item from the current data set at the specified position. This is invoked whenever getDropDownView(int, View, ViewGroup) is called.

Note, that if onCreateDropDownViewHolder(View, int) returns null for the specified position here passed viewHolder will be the view created by onCreateDropDownView(ViewGroup, int) for the specified position or just recycled view for that position. This approach may be used when a view hierarchy of a specific item is represented by single custom view, where such view represents a holder for all its child views.

Parameters:

viewHolder - The same holder as provided by onCreateDropDownViewHolder(View, int) for the specified position or converted view as holder as described above.

position - Position of the item from the current data set of which view to bind with data.

onUpdateViewHolder

protected abstract void onUpdateViewHolder(@NonNull
                                           DVH viewHolder,
                                           @NonNull
                                           Item item,
                                           int position)

Invoked to update views of the given viewHolder with data of the given cursor.

Parameters:

viewHolder - The view holder passed either to onBindViewHolder(Object, int) or to onBindDropDownViewHolder(Object, int).

item - Item from the adapter's data set at the specified position.

position - Position of the item from the current data set of which view holder to update.