Skip to content

Most visited

Recently visited

navigation
added in version 24.1.0
belongs to Maven artifact com.android.support:recyclerview-v7:27.0.0

AsyncListUtil

public class AsyncListUtil
extends Object

java.lang.Object
   ↳ android.support.v7.util.AsyncListUtil<T>


A utility class that supports asynchronous content loading.

It can be used to load Cursor data in chunks without querying the Cursor on the UI Thread while keeping UI and cache synchronous for better user experience.

It loads the data on a background thread and keeps only a limited number of fixed sized chunks in memory at all times.

AsyncListUtil queries the currently visible range through AsyncListUtil.ViewCallback, loads the required data items in the background through AsyncListUtil.DataCallback, and notifies a AsyncListUtil.ViewCallback when the data is loaded. It may load some extra items for smoother scrolling.

Note that this class uses a single thread to load the data, so it suitable to load data from secondary storage such as disk, but not from network.

This class is designed to work with RecyclerView, but it does not depend on it and can be used with other list views.

Summary

Nested classes

class AsyncListUtil.DataCallback<T>

The callback that provides data access for AsyncListUtil

class AsyncListUtil.ViewCallback

The callback that links AsyncListUtil with the list view. 

Public constructors

AsyncListUtil(Class<T> klass, int tileSize, DataCallback<T> dataCallback, AsyncListUtil.ViewCallback viewCallback)

Creates an AsyncListUtil.

Public methods

T getItem(int position)

Returns the data item at the given position or null if it has not been loaded yet.

int getItemCount()

Returns the number of items in the data set.

void onRangeChanged()

Updates the currently visible item range.

void refresh()

Forces reloading the data.

Inherited methods

From class java.lang.Object

Public constructors

AsyncListUtil

added in version 24.1.0
AsyncListUtil (Class<T> klass, 
                int tileSize, 
                DataCallback<T> dataCallback, 
                AsyncListUtil.ViewCallback viewCallback)

Creates an AsyncListUtil.

Parameters
klass Class: Class of the data item.

tileSize int: Number of item per chunk loaded at once.

dataCallback DataCallback: Data access callback.

viewCallback AsyncListUtil.ViewCallback: Callback for querying visible item range and update notifications.

Public methods

getItem

added in version 24.1.0
T getItem (int position)

Returns the data item at the given position or null if it has not been loaded yet.

If this method has been called for a specific position and returned null, then onItemLoaded(int) will be called when it finally loads. Note that if this position stays outside of the cached item range (as defined by extendRangeInto(int[], int[], int) method), then the callback will never be called for this position.

Parameters
position int: Item position.

Returns
T The data item at the given position or null if it has not been loaded yet.

getItemCount

added in version 24.1.0
int getItemCount ()

Returns the number of items in the data set.

This is the number returned by a recent call to refreshData().

Returns
int Number of items.

onRangeChanged

added in version 24.1.0
void onRangeChanged ()

Updates the currently visible item range.

Identifies the data items that have not been loaded yet and initiates loading them in the background. Should be called from the view's scroll listener (such as onScrolled(RecyclerView, int, int)).

refresh

added in version 24.1.0
void refresh ()

Forces reloading the data.

Discards all the cached data and reloads all required data items for the currently visible range. To be called when the data item count and/or contents has changed.

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)