com.appboy.ui.adapters

Class AppboyListAdapter

java.lang.Object

android.widget.BaseAdapter

android.widget.ArrayAdapter<Card>

com.appboy.ui.adapters.AppboyListAdapter

All Implemented Interfaces:

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

public class AppboyListAdapter
extends android.widget.ArrayAdapter<Card>

Default adapter used to display cards and log card impressions for the Braze news feed.

This allows the stream to reuse cards when they go out of view.

IMPORTANT - When you add a new card, be sure to add the new view type and update the view count here

A card generates an impression once per viewing per open ListView. If a card is viewed more than once in a particular ListView, it generates only one impression. If closed an reopened, a card will again generate an impression. This also takes into account the case of a card being off-screen in the ListView. The card only generates an impression when it actually scrolls onto the screen.

IMPORTANT - You must call resetCardImpressionTracker() whenever the ListView is displayed. This will ensure that cards that come into view will be tracked according to the description above.

Adding and removing cards to and from the adapter should be done using the following synchronized methods: add(Card), ArrayAdapter.clear()clear(), replaceFeed(java.util.List)

Field Summary

Fields inherited from interface android.widget.Adapter

IGNORE_ITEM_VIEW_TYPE, NO_SELECTION

Constructor Summary

Constructors

Constructor and Description
AppboyListAdapter(android.content.Context context, int layoutResourceId, java.util.List<Card> cards)

Method Summary

Modifier and Type	Method and Description
void	add(Card card)
void	batchSetCardsToRead(int startIndex, int endIndex) Helper method to batch set cards to visually read after either an up or down scroll of the feed.
int	getItemViewType(int position)
android.view.View	getView(int position, android.view.View convertView, android.view.ViewGroup parent) Always try to use a convert view if possible, otherwise create one from scratch.
int	getViewTypeCount() Be sure to keep view count in sync with the number of card types in the stream.
void	replaceFeed(java.util.List<Card> cards)
void	resetCardImpressionTracker() Resets the list of viewed cards.

Methods inherited from class android.widget.ArrayAdapter

addAll, addAll, clear, createFromResource, getAutofillOptions, getContext, getCount, getDropDownView, getDropDownViewTheme, getFilter, getItem, getItemId, getPosition, insert, notifyDataSetChanged, remove, setDropDownViewResource, setDropDownViewTheme, setNotifyOnChange, sort

Methods inherited from class android.widget.BaseAdapter

areAllItemsEnabled, hasStableIds, isEmpty, isEnabled, notifyDataSetInvalidated, registerDataSetObserver, setAutofillOptions, 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.Adapter

hasStableIds, isEmpty, registerDataSetObserver, unregisterDataSetObserver

Constructor Detail

AppboyListAdapter

public AppboyListAdapter(android.content.Context context,
                         int layoutResourceId,
                         java.util.List<Card> cards)

Method Detail

getViewTypeCount

public int getViewTypeCount()

Be sure to keep view count in sync with the number of card types in the stream. It is used internally to return the correct card type and to cache views for reuse

Specified by:

getViewTypeCount in interface android.widget.Adapter

Overrides:

getViewTypeCount in class android.widget.BaseAdapter

getItemViewType

public int getItemViewType(int position)

Specified by:

getItemViewType in interface android.widget.Adapter

Overrides:

getItemViewType in class android.widget.BaseAdapter

getView

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

Always try to use a convert view if possible, otherwise create one from scratch. The convertView should always be of the appropriate type, but it will be recycled, so you need to fully re-populate it with data from the card.

Specified by:

getView in interface android.widget.Adapter

Overrides:

getView in class android.widget.ArrayAdapter<Card>

replaceFeed

public void replaceFeed(java.util.List<Card> cards)

add

public void add(Card card)

Overrides:

add in class android.widget.ArrayAdapter<Card>

resetCardImpressionTracker

public void resetCardImpressionTracker()

Resets the list of viewed cards. This must be called every time the ListView is displayed and it will reset the impressions.

batchSetCardsToRead

public void batchSetCardsToRead(int startIndex,
                                int endIndex)

Helper method to batch set cards to visually read after either an up or down scroll of the feed. Since scrolls can have multiple cards scrolled off screen at a time, this method can batch set those cards to read.

Parameters:

startIndex - Where to start setting cards to viewed. The card at this index will be set to viewed. Must be less than endIndex

endIndex - Where to end setting cards to viewed. The card at this index will be set to viewed.