CrossProcessCursor**extends Cursor,按照注释所说,这是Cursor的一个扩展,支持Cursor被远端进程所使用(某种意义上,跨进程Cursor才是被用的最多的,因此这里也成了一个base的接口),一个跨进程的Cursor可以通过fill(fillWindow) 一个 CursorWindow(**A buffer containing multiple cursor rows)的方式编排到远端进程,一个优化是该Cursor本身可以提供一个pre-filled的window(getWindow),从而避免了一次数据拷贝.
getWindow():返回一个已经将Cursor执行的row的data填充完毕的CursorWindow.window中所含有的row就是Cursor的getPosition()所标识的row(就是Cursor当前所指向的row),Window中的data会和Cursor当前所指保持同步(Cursor move, window也会move)
fillWindow(int position, CursorWindow window),从position开始(包含position),直到最后或者Window的空间耗尽,所有的row的data填充到Window.
onMove(int oldPosition, int newPosition),每次Cursor成功的Move到新的位置都会被回调, onMove返回false会导致Move也返回false,并且Cursor的位置会变为beforeFirst(-1),一般来说,这个函数应该只在Cursor自己的Move类函数中调用,不能在外部调用.
AbstractCursor implements CrossProcessCursor, 所有具体Cursor类的基类,封装了一部分默认 常规操作。
扩展了ContentObserver -> SelfContentObserver,内部维护一个AbstractCursor的weakRef(构造时会指定Cursor),onChange(boolean selfChange)回调函数会尝试继续传递change给Cursor的onChange函数,而该Observer则是在setNotificationUri(ContentResolver cr, Uri notifyUri, int userHandle)时就会自己new一个并注册(mContentResolver.registerContentObserver(mNotifyUri, true, mSelfObserver, userHandle)).
setNotificationUri(ContentResolver cr, Uri notifyUri, int userHandle)函数会被多线程调用,因此内部会加锁,并且每次只能register一个SelfContentObserver(旧的会被刷掉),相应的getNotificationUri()内部也会加锁.
setExtras(Bundle extras)/getExtras(),内部有一个专门的mExtras对应。
checkPosition(),如果是无效位置(哨兵位)的话会抛异常.
finalize(),最后一次力所能及的释放资源:注销observer,以及close(没有close的话),之所以是力所能及,是因为JVM并不保证一定调用(常识).
onChange(boolean selfChange),因为涉及到了mSelfObserver的操作,会加锁,SelfContentObserver触发的onChange的selfChange为false.mContentObservable会保存当前所有的ContentObserver,在这一步也会通过自己的dispatchChange(selfChange, null)将change通知到注册到自己的Observer(mContentObservable说白了就是把Listener机制封装到了一个单独的类中,没什么神秘的,mDataSetObservable同样如此),如果是selfChange而且mNotifyUri不是null,那么会调用mContentResolver.notifyChange(mNotifyUri, mSelfObserver).
getColumnIndex(String columnName),简单的遍历ColumnName数组进行不区分大小写匹配.
final moveToPosition(int position),内部维护了一个mPos来表示Cursor当前指向的位置,构造时初始化为-1,注意该函数是final的,在mPos就是当前要移动的pos时,直接return true,接着是一个onMove函数的回调(这为subclass提供了自己的定制回调),如果onMove返回的是false,那么mPos也直接置为-1,返回的也是false,这就解释了前面onMove函数注释的意义(对MoveXXX操作有决定权),如果onMosve是true,那么mPos设置为position,代表着Move的成功,函数也返回true.其他的moveXXX()函数其实就是该函数的简单包装.
isFirst()/isLast()/isBeforeFirst()/isAfterLast(),mPos和getCount()的简单逻辑比较,注意的是在count为0时, isBeforeFirst() == isAfterLast() == true.
fillWindow(int position, CursorWindow window)是s对DatabaseUtils.cursorFillWindow()的直接转发.
一个mClosed Flag,在这个抽象基类中(AbstractCursor), close()的操作只是设置Flag,清空Observable,触发Deactivate/Close的callback.没有实质性的操作,这也是抽象类所必须的,close的具体行为应该由subClass自己决定。
requery()/onDeactivateOrClose()会触发mDataSetObservable的notifyChanged()/notifyInvalidated(),还会注册/注销SelfObserver.一个是开始前的初始化,一个是结束时的清理.