com.furdei.furdroid.components.widget

Class PartialLoadingAdapter

java.lang.Object

android.widget.BaseAdapter

com.furdei.furdroid.components.widget.PartialLoadingAdapter

All Implemented Interfaces:

android.widget.Adapter, android.widget.Filterable, android.widget.ListAdapter, android.widget.SpinnerAdapter, android.widget.WrapperListAdapter

public class PartialLoadingAdapter
extends android.widget.BaseAdapter
implements android.widget.Filterable, android.widget.WrapperListAdapter

Adapter for loading large cursors backed by RESTful services with a local cache in a database. This adapter is responsible for displaying "loading" items in the end of already loaded items in case when there is at least one more portion of unfetched data and for calling for that unfetched portion of data either.

Adapter does NOT provide any functionality for loading data itself, calling supplied listener PartialLoadingListener to start a loading process. loadNextPortionOfData method is called on the background thread by default unless you change this by calling setLoadNextPortionOnBackgroundThread(false).

Adapter always tries to load one more portion of data while user is looking through the end of the already shown portion. The threshold of "the end" can be configured through the setCursorPositionLoadingThreshold method. The default value is 15, which means that in case when cursor's length is 50 then the loading starts when the user goes further than 50 - 15 = 35 records. Note that loading doesn't start immediately. It is required that the threshold is crossed 3 times at least. It prevents us from reacting to "false" views when a ListView triggers adapter's getView method to determine it's length for example.

Author:

Stepan Furdey

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	PartialLoadingAdapter.PartialLoadingListener

Field Summary

Fields inherited from interface android.widget.Adapter

IGNORE_ITEM_VIEW_TYPE, NO_SELECTION

Constructor Summary

Constructors

Constructor and Description
PartialLoadingAdapter(android.support.v4.widget.CursorAdapter cursorAdapter, PartialLoadingAdapter.PartialLoadingListener listener, android.content.Context context, int loadingViewResId)
PartialLoadingAdapter(android.support.v4.widget.CursorAdapter cursorAdapter, PartialLoadingAdapter.PartialLoadingListener listener, android.view.View loadingView)

Method Summary

Methods

Modifier and Type	Method and Description
int	getCount()
int	getCursorPositionLoadingThreshold()
android.widget.Filter	getFilter()
Object	getItem(int position)
long	getItemId(int position)
android.view.View	getView(int position, android.view.View convertView, android.view.ViewGroup parent)
android.widget.ListAdapter	getWrappedAdapter()
boolean	isLoadNextPortionOnBackgroundThread()
void	setCursorPositionLoadingThreshold(int cursorPositionLoadingThreshold)
void	setLoadNextPortionOnBackgroundThread(boolean loadNextPortionOnBackgroundThread)
android.database.Cursor	swapCursor(android.database.Cursor newCursor)

Methods inherited from class android.widget.BaseAdapter

areAllItemsEnabled, getDropDownView, getItemViewType, getViewTypeCount, hasStableIds, isEmpty, isEnabled, notifyDataSetChanged, notifyDataSetInvalidated, registerDataSetObserver, unregisterDataSetObserver

Methods inherited from class java.lang.Object

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

Methods inherited from interface android.widget.ListAdapter

areAllItemsEnabled, isEnabled

Methods inherited from interface android.widget.Adapter

getItemViewType, getViewTypeCount, hasStableIds, isEmpty, registerDataSetObserver, unregisterDataSetObserver

Constructor Detail

PartialLoadingAdapter

public PartialLoadingAdapter(android.support.v4.widget.CursorAdapter cursorAdapter,
                     PartialLoadingAdapter.PartialLoadingListener listener,
                     android.content.Context context,
                     int loadingViewResId)

PartialLoadingAdapter

public PartialLoadingAdapter(android.support.v4.widget.CursorAdapter cursorAdapter,
                     PartialLoadingAdapter.PartialLoadingListener listener,
                     android.view.View loadingView)

Method Detail

getCursorPositionLoadingThreshold

public int getCursorPositionLoadingThreshold()

setCursorPositionLoadingThreshold

public void setCursorPositionLoadingThreshold(int cursorPositionLoadingThreshold)

isLoadNextPortionOnBackgroundThread

public boolean isLoadNextPortionOnBackgroundThread()

setLoadNextPortionOnBackgroundThread

public void setLoadNextPortionOnBackgroundThread(boolean loadNextPortionOnBackgroundThread)

swapCursor

public android.database.Cursor swapCursor(android.database.Cursor newCursor)

getWrappedAdapter

public android.widget.ListAdapter getWrappedAdapter()

Specified by:

getWrappedAdapter in interface android.widget.WrapperListAdapter

getCount

public int getCount()

Specified by:

getCount in interface android.widget.Adapter

getItem

public Object getItem(int position)

Specified by:

getItem in interface android.widget.Adapter

getItemId

public long getItemId(int position)

Specified by:

getItemId in interface android.widget.Adapter

getView

public android.view.View getView(int position,
                        android.view.View convertView,
                        android.view.ViewGroup parent)

Specified by:

getView in interface android.widget.Adapter

getFilter

public android.widget.Filter getFilter()

Specified by:

getFilter in interface android.widget.Filterable