com.cocosw.adapter.recyclerview

类 CursorAdapter<VH extends RecyclerView.ViewHolder>

java.lang.Object

android.support.v7.widget.RecyclerView.Adapter<VH>

com.cocosw.adapter.recyclerview.CursorAdapter<VH>

所有已实现的接口:

Filterable

直接已知子类:

SingleTypeCursorAdapter

public abstract class CursorAdapter<VH extends RecyclerView.ViewHolder>
extends RecyclerView.Adapter<VH>
implements Filterable

Project: Accessory Created by LiaoKai(soarcn) on 2015/1/17.

字段概要

字段

限定符和类型	字段和说明
static int	FLAG_REGISTER_CONTENT_OBSERVER If set the adapter will register a content observer on the cursor and will call onContentChanged() when a notification comes in.
protected com.cocosw.adapter.recyclerview.CursorAdapter.ChangeObserver	mChangeObserver This field should be made private, so it is hidden from the SDK.
protected Context	mContext This field should be made private, so it is hidden from the SDK.
protected Cursor	mCursor The current cursor
protected com.cocosw.adapter.recyclerview.CursorFilter	mCursorFilter This field should be made private, so it is hidden from the SDK.
protected DataSetObserver	mDataSetObserver This field should be made private, so it is hidden from the SDK.
protected boolean	mDataValid This field should be made private, so it is hidden from the SDK.
protected FilterQueryProvider	mFilterQueryProvider This field should be made private, so it is hidden from the SDK.
protected int	mRowIDColumn The row id column
protected ViewUpdater	updater Updater for current view

构造器概要

构造器

构造器和说明
CursorAdapter(Context context, Cursor c, int flags) Recommended constructor.

方法概要

方法

限定符和类型	方法和说明
void	changeCursor(Cursor cursor) Change the underlying cursor to a new cursor.
CharSequence	convertToString(Cursor cursor) Converts the cursor into a CharSequence.
Cursor	getCursor() Returns the cursor.
Filter	getFilter()
FilterQueryProvider	getFilterQueryProvider() Returns the query filter provider used for filtering.
int	getItemCount()
long	getItemId(int position)
abstract void	onBindViewHolder(VH holder, Cursor cursor) Call when bind view with the cursor
void	onBindViewHolder(VH holder, int position)
protected abstract void	onContentChanged() Called when the ContentObserver on the cursor receives a change notification.
Cursor	runQueryOnBackgroundThread(CharSequence constraint) Runs a query with the specified constraint.
void	setFilterQueryProvider(FilterQueryProvider filterQueryProvider) Sets the query filter provider used to filter the current Cursor.
Cursor	swapCursor(Cursor newCursor) Swap in a new Cursor, returning the old Cursor.

从类继承的方法 android.support.v7.widget.RecyclerView.Adapter

bindViewHolder, createViewHolder, getItemViewType, hasObservers, hasStableIds, notifyDataSetChanged, notifyItemChanged, notifyItemInserted, notifyItemMoved, notifyItemRangeChanged, notifyItemRangeInserted, notifyItemRangeRemoved, notifyItemRemoved, onAttachedToRecyclerView, onCreateViewHolder, onDetachedFromRecyclerView, onViewAttachedToWindow, onViewDetachedFromWindow, onViewRecycled, registerAdapterDataObserver, setHasStableIds, unregisterAdapterDataObserver

从类继承的方法 java.lang.Object

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

字段详细资料

mDataValid

protected boolean mDataValid

This field should be made private, so it is hidden from the SDK.

mCursor

protected Cursor mCursor

The current cursor

mContext

protected Context mContext

This field should be made private, so it is hidden from the SDK.

mRowIDColumn

protected int mRowIDColumn

The row id column

mChangeObserver

protected com.cocosw.adapter.recyclerview.CursorAdapter.ChangeObserver mChangeObserver

This field should be made private, so it is hidden from the SDK.

mDataSetObserver

protected DataSetObserver mDataSetObserver

This field should be made private, so it is hidden from the SDK.

mCursorFilter

protected com.cocosw.adapter.recyclerview.CursorFilter mCursorFilter

This field should be made private, so it is hidden from the SDK.

mFilterQueryProvider

protected FilterQueryProvider mFilterQueryProvider

This field should be made private, so it is hidden from the SDK.

updater

protected final ViewUpdater updater

Updater for current view

FLAG_REGISTER_CONTENT_OBSERVER

public static final int FLAG_REGISTER_CONTENT_OBSERVER

If set the adapter will register a content observer on the cursor and will call onContentChanged() when a notification comes in. Be careful when using this flag: you will need to unset the current Cursor from the adapter to avoid leaks due to its registered observers. This flag is not needed when using a CursorAdapter with a CursorLoader.

另请参阅:

常量字段值

构造器详细资料

CursorAdapter

public CursorAdapter(Context context,
             Cursor c,
             int flags)

Recommended constructor.

参数:

c - The cursor from which to get the data.

context - The context

flags - Flags used to determine the behavior of the adapter; Currently it accept FLAG_REGISTER_CONTENT_OBSERVER.

方法详细资料

onBindViewHolder

public abstract void onBindViewHolder(VH holder,
                    Cursor cursor)

Call when bind view with the cursor

参数:

holder -

cursor -

getCursor

public Cursor getCursor()

Returns the cursor.

返回:

the cursor.

getItemCount

public int getItemCount()

指定者:

getItemCount 在类中 RecyclerView.Adapter<VH extends RecyclerView.ViewHolder>

另请参阅:

RecyclerView.Adapter.getItemCount()

getItemId

public long getItemId(int position)

覆盖:

getItemId 在类中 RecyclerView.Adapter<VH extends RecyclerView.ViewHolder>

参数:

position - Adapter position to query

返回:

另请参阅:

RecyclerView.Adapter.getItemId(int)

onBindViewHolder

public void onBindViewHolder(VH holder,
                    int position)

指定者:

onBindViewHolder 在类中 RecyclerView.Adapter<VH extends RecyclerView.ViewHolder>

changeCursor

public void changeCursor(Cursor cursor)

Change the underlying cursor to a new cursor. If there is an existing cursor it will be closed.

参数:

cursor - The new cursor to be used

swapCursor

public Cursor swapCursor(Cursor newCursor)

Swap in a new Cursor, returning the old Cursor. Unlike changeCursor(Cursor), the returned old Cursor is not closed.

参数:

newCursor - The new cursor to be used.

返回:

Returns the previously set Cursor, or null if there wasa not one. If the given new Cursor is the same instance is the previously set Cursor, null is also returned.

convertToString

public CharSequence convertToString(Cursor cursor)

Converts the cursor into a CharSequence. Subclasses should override this method to convert their results. The default implementation returns an empty String for null values or the default String representation of the value.

参数:

cursor - the cursor to convert to a CharSequence

返回:

a CharSequence representing the value

runQueryOnBackgroundThread

public Cursor runQueryOnBackgroundThread(CharSequence constraint)

Runs a query with the specified constraint. This query is requested by the filter attached to this adapter.

The query is provided by a FilterQueryProvider. If no provider is specified, the current cursor is not filtered and returned.

After this method returns the resulting cursor is passed to changeCursor(Cursor) and the previous cursor is closed.

This method is always executed on a background thread, not on the application's main thread (or UI thread.)

Contract: when constraint is null or empty, the original results, prior to any filtering, must be returned.

参数:

constraint - the constraint with which the query must be filtered

返回:

a Cursor representing the results of the new query

另请参阅:

getFilter(), getFilterQueryProvider(), setFilterQueryProvider(android.widget.FilterQueryProvider)

getFilter

public Filter getFilter()

指定者:

getFilter 在接口中 Filterable

getFilterQueryProvider

public FilterQueryProvider getFilterQueryProvider()

Returns the query filter provider used for filtering. When the provider is null, no filtering occurs.

返回:

the current filter query provider or null if it does not exist

另请参阅:

setFilterQueryProvider(android.widget.FilterQueryProvider), runQueryOnBackgroundThread(CharSequence)

setFilterQueryProvider

public void setFilterQueryProvider(FilterQueryProvider filterQueryProvider)

Sets the query filter provider used to filter the current Cursor. The provider's FilterQueryProvider.runQuery(CharSequence) method is invoked when filtering is requested by a client of this adapter.

参数:

filterQueryProvider - the filter query provider or null to remove it

另请参阅:

getFilterQueryProvider(), runQueryOnBackgroundThread(CharSequence)

onContentChanged

protected abstract void onContentChanged()

Called when the ContentObserver on the cursor receives a change notification. The default implementation provides the auto-requery logic, but may be overridden by sub classes.

另请参阅:

ContentObserver.onChange(boolean)