«

Android Cursor源码笔记(1)

时间:2024-3-2 16:58     作者:韩俊     分类: Android


Cursor接口:extends Closeable,没啥说的.因为本身就是一个接口,所以其源码的最大价值其实就是作为一份guide存在,注释还有让人读的欲望的. 就当翻译一遍guide了.不过有些太过直白的函数就不cover了. Cursor说白了就是一个row set附赠一些辅助函数.

getType(int columnIndex): 返回某个column的类型:

FIELD_TYPE_NULL : column is null.
FIELD_TYPE_INTEGER : integer
FIELD_TYPE_FLOAT : float
FIELD_TYPE_STRING : FIELD_TYPE_STRING
FIELD_TYPE_BLOB : blob

getPosition(): 返回Cursor 在Row set中的位置,起始位置为0, Cursor初始时的位置是-1(因此一般需要moveToFirst()作为初始化),对于已经到最后一个row的Cursor,如果继续next(),那么Cursor的pos就是 row 的 number(和-1遥遥呼应, -1是前位哨兵,rowNum是后位哨兵).

boolean move(int offset): 移动Cursor,如果移超了会被pos会被强制为哨兵位置,返回值代表移动到的新位置是不是一个可达有效的位置。

moveToFirst()/Last(), 只有在Cursor是empty的情况下才会是false.s

isBeforeFirst()/isAfterLast(),判断是否在哨兵位.

getColumnIndex(String columnName), 查找是否有columnName的column在当前的 row set中,不存在的话返回-1,否则返回index(以0为起始位),getColumnIndexOrThrow(String columnName)一样,不过更为严厉,不存在就抛异常了。

getBlob/String/Short….等getter,在column的value是null,或者column type不匹配,或者是无效值的情况(比如Long Short都会做极值判断的)下是会抛异常的,要注意。

deactivate(),暂时disable这个Cursor(可以理解内部有些资源已经释放了),所有的请求都会fail,主要是为了节省资源,deactivate()后,Cursor耗费资源会少一点. 但是呢已经和冤家requery()一起Deprecated了.

close()和deactivate()不同的是一种彻底的关闭和释放,不可逆.

registerContentObserver(ContentObserver observer),为此Cursor注册一个change的observer,注释里这么说:一般来说,只有requery()才会引起data change, 因为他监控的是the content backing this cursor.s

registerDataSetObserver(DataSetObserver observer),和上面类似,不过是监控changes happen to the contents of the this cursors data set,一般由requery()/deactivate()/close()触发

setNotificationUri(ContentResolver cr, Uri uri), 用来watch某个URI的change,这个URI可以是某一行,也可以是一个content type.

getWantsAllOnMoveCalls() onMove()只有在该函数返回true时才会被跨进程调用。判断是不是Cusor 所有的movement会引发一次onMove().

getExtras()就是给Cursor一个存储带外信息的地方,类似于View的tag.

respond(Bundle extras)也是一个带外性质的方法,其实就是一个自定义的接口,用户可以通过Override这个方法来实现对Curosr的某些自定义操作.

标签: android

热门推荐