Android Cursor源码笔记(1)

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

2. 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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