com.sawyer.advadapters.widget

Class NFArrayAdapter<T>

java.lang.Object

android.widget.BaseAdapter

com.sawyer.advadapters.widget.NFArrayAdapter<T>

All Implemented Interfaces:

Adapter, ListAdapter, SpinnerAdapter

public abstract class NFArrayAdapter<T>
extends BaseAdapter

A non-filterable custom abstract BaseAdapter that is backed by an ArrayList of arbitrary objects. By default this class delegates view generation to subclasses.

Designed to be a more flexible and customizable solution then Android's ArrayAdapter class but without the filtering mechanism. As a result, there is no need for synchronized blocks which may help those worried about performance. It provides extra features such as: supporting additional ArrayList methods, makes smarter use of notifyDataSetChanged(), and conveniently passes along a layout inflater for view creation.

If filtering is required, it's strongly recommended to use the AbsArrayAdapter instead.

Field Summary

Fields inherited from interface android.widget.Adapter

IGNORE_ITEM_VIEW_TYPE, NO_SELECTION

Constructor Summary

Constructors

Constructor and Description
NFArrayAdapter(Context activity) Constructor
NFArrayAdapter(Context activity, Collection<T> items) Constructor
NFArrayAdapter(Context activity, T[] items) Constructor

Method Summary

Modifier and Type	Method and Description
void	add(T item) Adds the specified item at the end of the adapter.
void	addAll(Collection<? extends T> items) Adds the specified Collection at the end of the adapter.
void	addAll(T... items) Adds the specified items at the end of the adapter.
void	clear() Remove all elements from the adapter.
boolean	contains(T item) Tests whether this adapter contains the specified item.
boolean	containsAll(Collection<?> items) Tests whether this adapter contains all items contained in the specified collection.
Context	getContext()
int	getCount()
View	getDropDownView(int position, View convertView, ViewGroup parent)
View	getDropDownView(LayoutInflater inflater, int position, View convertView, ViewGroup parent) Get a View that displays in the drop down popup the data at the specified position in the data set.
T	getItem(int position)
long	getItemId(int position)
ArrayList<T>	getList()
int	getPosition(T item) Returns the position of the specified item in the array.
View	getView(int position, View convertView, ViewGroup parent)
abstract View	getView(LayoutInflater inflater, int position, View convertView, ViewGroup parent) Get a View that displays the data at the specified position in the data set.
void	insert(int index, T item) Inserts the specified item at the specified index in the array.
void	insertAll(int index, Collection<? extends T> items) Inserts the item in the specified collection at the specified location in this adapter.
void	notifyDataSetChanged()
void	remove(T item) Removes the first occurrence of the specified item from the adapter
void	removeAll(Collection<?> items) Removes all occurrences in the adapter of each item in the specified collection.
void	retainAll(Collection<?> items) Removes all items from this adapter that are not contained in the specified collection.
void	setList(Collection<? extends T> items) Resets the adapter to store a new list of items.
void	setNotifyOnChange(boolean notifyOnChange) Control whether methods that change the list (add(T), insert(int, T), remove(T), clear()) automatically call notifyDataSetChanged().
void	sort() Sorts the content of this adapter using the natural order of the stored items themselves.
void	sort(Comparator<? super T> comparator) Sorts the content of this adapter using the specified comparator.
void	update(int position, T item) Updates the item at the specified position in the adapter with the specified item.

Methods inherited from class android.widget.BaseAdapter

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

Methods inherited from class java.lang.Object

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

Constructor Detail

NFArrayAdapter

public NFArrayAdapter(Context activity)

Constructor

Parameters:

activity - Context used for inflating views

NFArrayAdapter

public NFArrayAdapter(Context activity,
                      Collection<T> items)

Constructor

Parameters:

activity - Context used for inflating views

items - The items to represent within the adapter.

NFArrayAdapter

public NFArrayAdapter(Context activity,
                      T[] items)

Constructor

Parameters:

activity - Context used for inflating views

items - The items to represent within the adapter.

Method Detail

add

public void add(T item)

Adds the specified item at the end of the adapter.

Parameters:

item - The item to add at the end of the adapter.

addAll

public void addAll(Collection<? extends T> items)

Adds the specified Collection at the end of the adapter.

Parameters:

items - The Collection to add at the end of the adapter.

addAll

@SafeVarargs
public final void addAll(T... items)

Adds the specified items at the end of the adapter.

Parameters:

items - The items to add at the end of the adapter.

clear

public void clear()

Remove all elements from the adapter.

contains

public boolean contains(T item)

Tests whether this adapter contains the specified item. Be aware that this is a linear search.

Parameters:

item - The item to search for

Returns:

true if the item is an element of this adapter. false otherwise

containsAll

public boolean containsAll(Collection<?> items)

Tests whether this adapter contains all items contained in the specified collection. Be aware that this performs a nested for loop search...eg O(n*m) complexity.

Parameters:

items - The collection of items

Returns:

true if all items in the specified collection are elements of this adapter, false otherwise

getContext

public Context getContext()

Returns:

The Context associated with this adapter.

getCount

public int getCount()

getDropDownView

public View getDropDownView(LayoutInflater inflater,
                            int position,
                            View convertView,
                            ViewGroup parent)

Get a View that displays in the drop down popup the data at the specified position in the data set.

Parameters:

inflater - the LayoutInflater object that can be used to inflate each view.

position - index of the item whose view we want.

convertView - the old view to reuse, if possible. Note: You should check that this view is non-null and of an appropriate type before using. If it is not possible to convert this view to display the correct data, this method can create a new view.

parent - the parent that this view will eventually be attached to

Returns:

a View corresponding to the data at the specified position.

getDropDownView

public final View getDropDownView(int position,
                                  View convertView,
                                  ViewGroup parent)

Specified by:

getDropDownView in interface SpinnerAdapter

Overrides:

getDropDownView in class BaseAdapter

getItem

public T getItem(int position)

getItemId

public long getItemId(int position)

getList

public ArrayList<T> getList()

Returns:

The list of items stored within the Adapter

setList

public void setList(Collection<? extends T> items)

Resets the adapter to store a new list of items. Convenient way of calling clear(), then addAll(java.util.Collection) without having to worry about an extra notifyDataSetChanged() invoked in between.

Parameters:

items - New list of items to store within the adapter.

getPosition

public int getPosition(T item)

Returns the position of the specified item in the array. Be aware that this is a linear search.

Parameters:

item - The item to retrieve the position of.

Returns:

The position of the specified item.

getView

public abstract View getView(LayoutInflater inflater,
                             int position,
                             View convertView,
                             ViewGroup parent)

Get a View that displays the data at the specified position in the data set. You can either create a View manually or inflate it from an XML layout file. When the View is inflated, the parent View (GridView, ListView...) will apply default layout parameters unless you use LayoutInflater.inflate(int, android.view.ViewGroup, boolean) to specify a root view and to prevent attachment to the root.

Parameters:

inflater - the LayoutInflater object that can be used to inflate each view.

position - The position of the item within the adapter's data set of the item whose view we want.

convertView - The old view to reuse, if possible. Note: You should check that this view is non-null and of an appropriate type before using. If it is not possible to convert this view to display the correct data, this method can create a new view. Heterogeneous lists can specify their number of view types, so that this View is always of the right type (see BaseAdapter.getViewTypeCount() and BaseAdapter.getItemViewType(int)).

parent - The parent that this view will eventually be attached to

Returns:

A View corresponding to the data at the specified position.

getView

public final View getView(int position,
                          View convertView,
                          ViewGroup parent)

insert

public void insert(int index,
                   T item)

Inserts the specified item at the specified index in the array.

Parameters:

index - The index at which the item must be inserted.

item - The item to insert into the adapter.

insertAll

public void insertAll(int index,
                      Collection<? extends T> items)

Inserts the item in the specified collection at the specified location in this adapter. The items are added in the order they are returned from the collection's iterator.

Parameters:

index - The index at which the items must be inserted.

items - The collection of items to be inserted.

notifyDataSetChanged

public void notifyDataSetChanged()

Overrides:

notifyDataSetChanged in class BaseAdapter

remove

public void remove(T item)

Removes the first occurrence of the specified item from the adapter

Parameters:

item - The item to remove.

removeAll

public void removeAll(Collection<?> items)

Removes all occurrences in the adapter of each item in the specified collection.

Parameters:

items - The collection of items to remove

retainAll

public void retainAll(Collection<?> items)

Removes all items from this adapter that are not contained in the specified collection.

Parameters:

items - The collection of items to retain

setNotifyOnChange

public void setNotifyOnChange(boolean notifyOnChange)

Control whether methods that change the list (add(T), insert(int, T), remove(T), clear()) automatically call notifyDataSetChanged(). If set to false, caller must manually call notifyDataSetChanged() to have the changes reflected in the attached view.

The default is true, and calling notifyDataSetChanged() resets the flag to true.

Parameters:

notifyOnChange - if true, modifications to the list will automatically call notifyDataSetChanged()

sort

public void sort()

Sorts the content of this adapter using the natural order of the stored items themselves. This requires items to have implemented Comparable and is equivalent of passing null to sort(java.util.Comparator).

Throws:

ClassCastException - If the comparator is null and the stored items do not implement Comparable or if compareTo throws for any pair of items.

sort

public void sort(Comparator<? super T> comparator)

Sorts the content of this adapter using the specified comparator.

Parameters:

comparator - Used to sort the items contained in this adapter. Null to use an item's Comparable interface.

Throws:

ClassCastException - If the comparator is null and the stored items do not implement Comparable or if compareTo throws for any pair of items.

update

public void update(int position,
                   T item)

Updates the item at the specified position in the adapter with the specified item. This operation does not change the size of the adapter.

Parameters:

position - The location at which to put the specified item

item - The new item to replace with the old