com.pedrogomez.renderers

Class RendererAdapter<T>

java.lang.Object

android.widget.BaseAdapter

com.pedrogomez.renderers.RendererAdapter<T>

All Implemented Interfaces:

android.widget.Adapter, android.widget.ListAdapter, android.widget.SpinnerAdapter

public class RendererAdapter<T>
extends android.widget.BaseAdapter

BaseAdapter created to work RendererBuilders and Renderer instances. Other adapters have to use this one to show information into ListView widgets. This class is the heart of this library. It's used to avoid the library users declare a new renderer each time they have to show information into a ListView. RendererAdapter has to be constructed with a LayoutInflater to inflate views, one RendererBuilder to provide Renderer to RendererAdapter and one AdapteeCollection to provide the elements to render.

Field Summary

Fields inherited from interface android.widget.Adapter

IGNORE_ITEM_VIEW_TYPE, NO_SELECTION

Constructor Summary

Constructors

Constructor and Description
RendererAdapter(RendererBuilder<T> rendererBuilder)
RendererAdapter(RendererBuilder<T> rendererBuilder, AdapteeCollection<T> collection)

Method Summary

Modifier and Type	Method and Description
void	add(T element) Add an element to the AdapteeCollection.
void	addAll(java.util.Collection<? extends T> elements) Add a Collection of elements to the AdapteeCollection.
void	clear() Remove all elements inside the AdapteeCollection.
protected AdapteeCollection<T>	getCollection() Allows the client code to access the AdapteeCollection from subtypes of RendererAdapter.
int	getCount()
T	getItem(int position)
long	getItemId(int position)
int	getItemViewType(int position) Indicate to the ListView the type of Renderer used to one position using a numeric value.
android.view.View	getView(int position, android.view.View convertView, android.view.ViewGroup parent) Main method of RendererAdapter.
int	getViewTypeCount() Indicate to the ListView the number of different how many Renderer implementations are in the RendererBuilder ready to use.
void	remove(java.lang.Object element) Remove an element from the AdapteeCollection.
void	removeAll(java.util.Collection<?> elements) Remove a Collection of elements to the AdapteeCollection.
void	setCollection(AdapteeCollection<T> collection)
protected void	updateRendererExtraValues(T content, Renderer<T> renderer, int position) Empty implementation created to allow the client code to extend this class without override getView method.

Methods inherited from class android.widget.BaseAdapter

areAllItemsEnabled, getDropDownView, 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

Constructor Detail

RendererAdapter

public RendererAdapter(RendererBuilder<T> rendererBuilder)

RendererAdapter

public RendererAdapter(RendererBuilder<T> rendererBuilder,
                       AdapteeCollection<T> collection)

Method Detail

getCount

public int getCount()

getItem

public T getItem(int position)

getItemId

public long getItemId(int position)

setCollection

public void setCollection(AdapteeCollection<T> collection)

getView

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

Main method of RendererAdapter. This method has the responsibility of update the RendererBuilder values and create or recycle a new Renderer. Once the renderer has been obtained the RendereBuilder will call the render method in the renderer and will return the Renderer root view to the ListView. If rRendererBuilder returns a null Renderer this method will throw a NullRendererBuiltException.

Parameters:

position - to render.

convertView - to use to recycle.

parent - used to inflate views.

Returns:

view rendered.

getItemViewType

public int getItemViewType(int position)

Indicate to the ListView the type of Renderer used to one position using a numeric value.

Specified by:

getItemViewType in interface android.widget.Adapter

Overrides:

getItemViewType in class android.widget.BaseAdapter

Parameters:

position - to analyze.

Returns:

the id associated to the Renderer used to render the content given a position.

getViewTypeCount

public int getViewTypeCount()

Indicate to the ListView the number of different how many Renderer implementations are in the RendererBuilder ready to use.

Specified by:

getViewTypeCount in interface android.widget.Adapter

Overrides:

getViewTypeCount in class android.widget.BaseAdapter

Returns:

amount of different Renderer types.

add

public void add(T element)

Add an element to the AdapteeCollection.

Parameters:

element - to add.

remove

public void remove(java.lang.Object element)

Remove an element from the AdapteeCollection.

Parameters:

element - to remove.

addAll

public void addAll(java.util.Collection<? extends T> elements)

Add a Collection of elements to the AdapteeCollection.

Parameters:

elements - to add.

removeAll

public void removeAll(java.util.Collection<?> elements)

Remove a Collection of elements to the AdapteeCollection.

Parameters:

elements - to remove.

clear

public void clear()

Remove all elements inside the AdapteeCollection.

getCollection

protected AdapteeCollection<T> getCollection()

Allows the client code to access the AdapteeCollection from subtypes of RendererAdapter.

Returns:

collection used in the adapter as the adaptee class.

updateRendererExtraValues

protected void updateRendererExtraValues(T content,
                                         Renderer<T> renderer,
                                         int position)

Empty implementation created to allow the client code to extend this class without override getView method. This method is called before render the Renderer and can be used in RendererAdapter extension to add extra info to the renderer created like the position in the ListView/RecyclerView.

Parameters:

content - to be rendered.

renderer - to be used to paint the content.

position - of the content.