SortedList.Callback - Android SDK

Classes

Summary: Ctors | Methods | Inherited Methods | [Expand All]

public static abstract class

SortedList.Callback

extends Object
implements Comparator<T2>

java.lang.Object
↳	android.support.v7.util.SortedList.Callback<T2>

Known Direct Subclasses

SortedList.BatchedCallback<T2>, SortedListAdapterCallback<T2>

Class Overview

The class that controls the behavior of the SortedList.

It defines how items should be sorted and how duplicates should be handled.

SortedList calls the callback methods on this class to notify changes about the underlying data.

Summary

Public Constructors
	SortedList.Callback()

Public Methods
abstract boolean	areContentsTheSame(T2 oldItem, T2 newItem) Called by the SortedList when it wants to check whether two items have the same data or not.
abstract boolean	areItemsTheSame(T2 item1, T2 item2) Called by the SortedList to decide whether two object represent the same Item or not.
abstract int	compare(T2 o1, T2 o2) Similar to `compare(Object, Object)`, should compare two and return how they should be ordered.
abstract void	onChanged(int position, int count) Called by the SortedList when the item at the given position is updated.
abstract void	onInserted(int position, int count) Called by the SortedList when an item is inserted at the given position.
abstract void	onMoved(int fromPosition, int toPosition) Called by the SortedList when an item changes its position in the list.
abstract void	onRemoved(int position, int count) Called by the SortedList when an item is removed from the given position.

[Expand]

Inherited Methods

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of `Class` that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

From interface java.util.Comparator

Public Constructors

public SortedList.Callback ()

Public Methods

public abstract boolean areContentsTheSame (T2 oldItem, T2 newItem)

Called by the SortedList when it wants to check whether two items have the same data or not. SortedList uses this information to decide whether it should call onChanged(int, int) or not.

SortedList uses this method to check equality instead of equals(Object) so that you can change its behavior depending on your UI.

For example, if you are using SortedList with a RecyclerView.Adapter, you should return whether the items' visual representations are the same or not.

Parameters

oldItem	The previous representation of the object.
newItem	The new object that replaces the previous one.

Returns

True if the contents of the items are the same or false if they are different.

public abstract boolean areItemsTheSame (T2 item1, T2 item2)

Called by the SortedList to decide whether two object represent the same Item or not.

For example, if your items have unique ids, this method should check their equality.

Parameters

item1	The first item to check.
item2	The second item to check.

Returns

True if the two items represent the same object or false if they are different.

public abstract int compare (T2 o1, T2 o2)

Similar to compare(Object, Object), should compare two and return how they should be ordered.

Parameters

o1	The first object to compare.
o2	The second object to compare.

Returns

a negative integer, zero, or a positive integer as the first argument is less than, equal to, or greater than the second.

public abstract void onChanged (int position, int count)

Called by the SortedList when the item at the given position is updated.

Parameters

position	The position of the item which has been updated.
count	The number of items which has changed.

public abstract void onInserted (int position, int count)

Called by the SortedList when an item is inserted at the given position.

Parameters

position	The position of the new item.
count	The number of items that have been added.

public abstract void onMoved (int fromPosition, int toPosition)

Called by the SortedList when an item changes its position in the list.

Parameters

fromPosition	The previous position of the item before the move.
toPosition	The new position of the item.

public abstract void onRemoved (int position, int count)

Called by the SortedList when an item is removed from the given position.

Parameters

position	The position of the item which has been removed.
count	The number of items which have been removed.

Results

Classes

SortedList.Callback

Class Overview

Summary

Public Constructors

public SortedList.Callback ()

Public Methods

public abstract boolean areContentsTheSame (T2 oldItem, T2 newItem)

Parameters

Returns

public abstract boolean areItemsTheSame (T2 item1, T2 item2)

Parameters

Returns

public abstract int compare (T2 o1, T2 o2)

Parameters

Returns

public abstract void onChanged (int position, int count)

Parameters

public abstract void onInserted (int position, int count)

Parameters

public abstract void onMoved (int fromPosition, int toPosition)

Parameters

public abstract void onRemoved (int position, int count)

Parameters