com.bazaarvoice.bvandroidsdk

Class CurationsInfiniteRecyclerView

java.lang.Object

BVRecyclerView

com.bazaarvoice.bvandroidsdk.CurationsInfiniteRecyclerView

public class CurationsInfiniteRecyclerView
extends BVRecyclerView

Helper View class to manage fetching and displaying a Grid of CurationsFeedItems

Make sure to implement your own CurationsImageLoader to manage the fetching and displaying of images. We use this interface to be able to tie into whatever existing image fetching/caching/manipulating library you are already using.

Example

In your layout add

 <com.bazaarvoice.bvandroidsdk.CurationsInfiniteRecyclerView
  android:id="@+id/curations_recycler_view"
  android:layout_width="match_parent"
  android:layout_height="@dimen/curations_height"
  app:curationSpanCount="3"
  app:curationCellWidthRatio="4"
  app:curationCellHeightRatio="3"
  app:curationPageSize="20"
  app:curationOrientation="horizontal"/>

In your android.app.Activity#onCreate(Bundle) after inflating your layout, add

{@code
 final CurationsFeedRequest request = new CurationsFeedRequest
  .Builder(Arrays.asList("__foo__", "__bar__"))
  .build();
 curationsRecyclerView
  .setRequest(request)
  .setImageLoader(curationsImageLoader)
  .setOnPageLoadListener(new CurationsInfiniteRecyclerView.OnPageLoadListener() {

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	CurationsInfiniteRecyclerView.OnFeedItemClickListener Listener to be notified when a CurationsFeedItem cell is tapped
static interface	CurationsInfiniteRecyclerView.OnPageLoadListener Listener to be notified when paging requests succeeds or fails

Constructor Summary

Constructors

Constructor and Description
CurationsInfiniteRecyclerView(android.content.Context context)
CurationsInfiniteRecyclerView(android.content.Context context, android.util.AttributeSet attrs)
CurationsInfiniteRecyclerView(android.content.Context context, android.util.AttributeSet attrs, int defStyle)

Method Summary

Modifier and Type	Method and Description
java.lang.String	getProductId()
protected void	init(android.content.Context context, android.util.AttributeSet attr)
void	load() Starts the fetching of the data for the grid with all of the provided options
void	onAddedToViewHierarchy()
void	onViewGroupInteractedWith()
void	setAdapter(Adapter adapter)
CurationsInfiniteRecyclerView	setCellHeightRatio(int cellHeightRatio)
CurationsInfiniteRecyclerView	setCellWidthRatio(int cellWidthRatio)
CurationsInfiniteRecyclerView	setImageLoader(CurationsImageLoader imageLoader)
void	setLayoutManager(LayoutManager layoutManager)
CurationsInfiniteRecyclerView	setMaxFeedItemCount(int maxFeedItemCount) Optional field to increase the maximum number of CurationsFeedItems that this View will associate with the Adapter.
CurationsInfiniteRecyclerView	setOnFeedItemClickListener(CurationsInfiniteRecyclerView.OnFeedItemClickListener onFeedItemClickListener)
CurationsInfiniteRecyclerView	setOnPageLoadListener(CurationsInfiniteRecyclerView.OnPageLoadListener pageLoadListener)
CurationsInfiniteRecyclerView	setOrientation(int orientation)
CurationsInfiniteRecyclerView	setRequest(CurationsFeedRequest request)
CurationsInfiniteRecyclerView	setSpanCount(int spanCount)
boolean	startNestedScroll(int axes)

Methods inherited from class java.lang.Object

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

Constructor Detail

CurationsInfiniteRecyclerView

public CurationsInfiniteRecyclerView(android.content.Context context)

CurationsInfiniteRecyclerView

public CurationsInfiniteRecyclerView(android.content.Context context,
                                     android.util.AttributeSet attrs)

CurationsInfiniteRecyclerView

public CurationsInfiniteRecyclerView(android.content.Context context,
                                     android.util.AttributeSet attrs,
                                     int defStyle)

Method Detail

init

protected void init(android.content.Context context,
                    android.util.AttributeSet attr)

setRequest

public CurationsInfiniteRecyclerView setRequest(CurationsFeedRequest request)

Parameters:

request - Your CurationsFeedRequest. This class will manage the paging.

Returns:

setOnPageLoadListener

public CurationsInfiniteRecyclerView setOnPageLoadListener(CurationsInfiniteRecyclerView.OnPageLoadListener pageLoadListener)

Parameters:

pageLoadListener - Your implementation of the CurationsInfiniteRecyclerView.OnPageLoadListener interface

Returns:

this class

setOnFeedItemClickListener

public CurationsInfiniteRecyclerView setOnFeedItemClickListener(CurationsInfiniteRecyclerView.OnFeedItemClickListener onFeedItemClickListener)

Parameters:

onFeedItemClickListener - Your implementation of the CurationsInfiniteRecyclerView.OnFeedItemClickListener interface

Returns:

this class

setImageLoader

public CurationsInfiniteRecyclerView setImageLoader(CurationsImageLoader imageLoader)

Parameters:

imageLoader - Your implementation of the CurationsImageLoader interface

Returns:

this class

setMaxFeedItemCount

public CurationsInfiniteRecyclerView setMaxFeedItemCount(int maxFeedItemCount)

Optional field to increase the maximum number of CurationsFeedItems that this View will associate with the Adapter. Default is 360,430 which should be sufficient as is. Increasing this number, increases the amount of heap that is retained by the adapter.

Parameters:

maxFeedItemCount - Max number of items associated with Adapter

Returns:

this class

setCellWidthRatio

public CurationsInfiniteRecyclerView setCellWidthRatio(int cellWidthRatio)

Parameters:

cellWidthRatio - Used with setCellHeightRatio(int) to set the aspect ratio that this cell will be rendered at.

Returns:

this class

setCellHeightRatio

public CurationsInfiniteRecyclerView setCellHeightRatio(int cellHeightRatio)

Parameters:

cellHeightRatio - Used with setCellWidthRatio(int) to set the aspect ratio that this cell will be rendered at.

Returns:

this class

setSpanCount

public CurationsInfiniteRecyclerView setSpanCount(int spanCount)

Parameters:

spanCount - Number of columns if orientation is LinearLayoutManager#VERTICAL and number of rows if orientation is LinearLayoutManager#HORIZONTAL

Returns:

this class

setOrientation

public CurationsInfiniteRecyclerView setOrientation(int orientation)

Parameters:

orientation - Orientation for the list/grid. Can be LinearLayoutManager#VERTICAL or LinearLayoutManager#HORIZONTAL

Returns:

this class

load

public void load()

Starts the fetching of the data for the grid with all of the provided options

setAdapter

public void setAdapter(Adapter adapter)

setLayoutManager

public void setLayoutManager(LayoutManager layoutManager)

getProductId

public java.lang.String getProductId()

onViewGroupInteractedWith

public void onViewGroupInteractedWith()

onAddedToViewHierarchy

public void onAddedToViewHierarchy()

startNestedScroll

public boolean startNestedScroll(int axes)