在Android 查询数据是通过Cursor 类来实现的。当我们使用 SQLiteDatabase.query()方法时,就会得到Cursor对象, Cursor所指向的就是每一条数据。
Cursor 位于 android.database.Cursor类,可见出它的设计是基于数据库服务产生的。
子类有:
- AbstractCursor
- AbstractWindowedCursor
- CrossProcessCursor
- CursorWrapper
- MatrixCursor
- MergeCursor
- MockCursor
- SQLiteCursor
1.Cursor必知
- Cursor 是每行的集合。
- 使用 moveToFirst() 定位第一行。
- 你必须知道每一列的名称。
- 你必须知道每一列的数据类型。
- Cursor 是一个随机的数据源。
- 所有的数据都是通过下标取得。
2.Cursor的重要方法
- close()
关闭游标,释放资源 - copyStringToBuffer(int columnIndex, CharArrayBuffer buffer)
在缓冲区中检索请求的列的文本,将将其存储 - getColumnCount()
返回所有列的总数 - getColumnIndex(String columnName)
返回指定列的名称,如果不存在返回-1 - getColumnIndexOrThrow(String columnName)
从零开始返回指定列名称,如果不存在将抛出IllegalArgumentException 异常。 - getColumnName(int columnIndex)
从给定的索引返回列名 - getColumnNames()
返回一个字符串数组的列名 - getCount()
返回Cursor 中的行数 - moveToFirst()
移动光标到第一行 - moveToLast()
移动光标到最后一行 - moveToNext()
移动光标到下一行 - moveToPosition(int position)
移动光标到一个绝对的位置 - moveToPrevious()
移动光标到上一行
3.如何使用
(1)判断cursor是否为空
if (cur.moveToFirst() == false) { //为空的Cursor return; }
(2)获取列值
*获取单个的列值 //获取列名为name的列索引 int nameColumnIndex = cur.getColumnIndex(People.NAME); //由列索引获取姓名 String name = cur.getString(nameColumnIndex); *循环 Cursor 取出我们需要的数据 while(cur.moveToNext()) { //光标移动成功 String email = cursor.getString(cursor.getColumnIndex(RuiXin.EMAIL)); startManagingCursor(cursor); //查找后关闭游标 //把数据取出 }
cur.moveToNext() 为假时将跳出循环,即 Cursor 数据循环完毕
3.补充
Activity.startManagingCursor方法:
将获得的Cursor对象交与Activity管理,这样Cursor对象的生命周期便能与当前的Activity自动同步,省去了自己对Cursor的管理。
1.这个方法使用的前提是:游标结果集里有很多的数据记录。
所以,在使用之前,
先对Cursor是否为null进行判断,如果Cursor != null,再使用此方法 2.如果使用这个方法,
最后也要用stopManagingCursor()来把它停止掉,以免出现错误。 3.使用这个方法的
目的是把获取的Cursor对象交给Activity管理,这样Cursor的生命周期便能和Activity自动同步,省去自己手动管理。 (绑定到ListView的Cursor必须有_id项,否则会有异常抛出) 例:
public void queryTheCursor(View view) { 02 Cursor c = mgr.queryTheCursor(); 03 startManagingCursor(c); //托付给activity根据自己的生命周期去管理Cursor的生命周期 04 CursorWrapper cursorWrapper = new CursorWrapper(c) { 05 @Override 06 public String getString(int columnIndex) { 07 //将简介前加上年龄 08 if (getColumnName(columnIndex).equals("info")) { 09 int age = getInt(getColumnIndex("age")); 10 return age + " years old, " + super.getString(columnIndex); 11 } 12 return super.getString(columnIndex); 13 } 14 }; 15 //确保查询结果中有"_id"列 16 SimpleCursorAdapter adapter = new SimpleCursorAdapter(this, android.R.layout.simple_list_item_2, 17 cursorWrapper, new String[]{"name", "info"}, new int[]{android.R.id.text1, android.R.id.text2}); 18 ListView listView = (ListView) findViewById(R.id.listView_db); 19 listView.setAdapter(adapter); 20 }
4.补充2 SimpleCursorAdapter
(转http://www.nowamagic.net/academy/detail/50350111)
一般在做网页的时候,要显示一个列表的数据,一般是对一个list的类进行循环,输出一大串的HTML字符串。数据比较多的话就会分页,比如一页10条记录,去数据库查询的时候就会limit 10条记录,速度非常快。
但在 Android中遇到几千条数据的时候,上下滑动,跟几十条数据的滑动流畅程度差不多,就是刚开始载入速度不一样。对Android 中的Adapter 数据绑定,进行Log输出后,发现是边滑动,数据边绑定的,并不是有多少数据一次性绑定完。但是数据一般是用sql 语句一次性查询出来,这点跟Web中的还是有点区别。
Android中ListView一般跟Cursor和Adapter有关。很多东西google都帮你弄好了,你只需要按照它约定的弄就行了。“你动不了Application Framework 的大结构,也不需要动。这是福利不是约束”。
SimpleCursorAdapter 的函数定义是:
SimpleCursorAdapter(Context context, int layout, Cursor c, String[] from, int[] to)
第二个layout的参数是ListView中单行的布局, c是你数据的游标。刚开始其实from和to比较让人不熟悉,From是你查询出的数据,to是单行布局中的单独控件,一对一的关系,用起来非常方便。比如:
SimpleCursorAdapter adapter = new SimpleCursorAdapter(this, R.layout.provice_list_item, cursor, new String[] {Location.PROVICE, Location.CITY }, new int[] { R.id.princeTextView,android.R.id.text1 });
写好Adapter,基本上大部分工作已经完成,只需要给你的listview设置这个adapter就行了。一个显示数据的列表就完成了。
需要注意的是SimpleCursorAdapter的应用,当我们使用这个适配器时,我们必须先得到一个Cursor对象,这里面有几个问题:如何管理Cursor的生命周期,如果包装Cursor,Cursor结果集都需要注意什么。
如果手动去管理Cursor的话会非常的麻烦,还有一定的风险,处理不当的话运行期间就会出现异常,幸好Activity为我们提供了startManagingCursor(Cursor cursor)方法,它会根据Activity的生命周期去管理当前的Cursor对象。
startManagingCursor
下面是 startManagingCursor 方法的说明:
文中提到,startManagingCursor方法会根据Activity的生命周期去管理当前的Cursor对象的生命周期,就是说(1)当Activity停止时他会自动调用Cursor的deactivate方法,禁用游标,(2)当Activity重新回到屏幕时它会调用Cursor的requery方法再次查询,(3)当Activity摧毁时,被管理的Cursor都会自动关闭释放。
如何包装Cursor?我们会使用到CursorWrapper对象去包装我们的Cursor对象,实现我们需要的数据转换工作,这个CursorWrapper实际上是实现了Cursor接口。我们查询获取到的Cursor其实是Cursor的引用,而系统实际返回给我们的必然是Cursor接口的一个实现类的对象实例,我们用CursorWrapper包装这个实例,然后再使用SimpleCursorAdapter将结果显示到列表上。
Cursor结果集需要注意些什么:一个最需要注意的是,在我们的结果集中必须要包含一个“_id”的列,否则SimpleCursorAdapter就会翻脸不认人,为什么一定要这样呢?因为这源于SQLite的规范,主键以“_id”为标准。
解决办法有三:
- 第一,建表时根据规范去做;
- 第二,查询时用别名,例如:SELECT id AS _id FROM person;
- 第三,在CursorWrapper里做文章:
如果试图从CursorWrapper里获取“_id”对应的列索引,我们就返回查询结果里“id”对应的列索引即可。