Android中每一个数据库对创建它的应用程序包套件来说都是私有的,默认情况下其他应用程序无法直接访问此私有数据库。所有的数据库文件存放在手机中的/data/data/package_name/databases路径下,以下是常用的与数据库相关的函数:
返回值 |
函数 |
备注 |
static SQLiteDatabase |
create(SQLiteDatabase.CursorFactory factory) |
创建一个数据库 factory:可选的数据库游标工厂类,当查询(query)被提交时,该对象会被调用来实例化一个游标。 |
static SQLiteDatabase |
openDatabase(String path,SQLiteDatabase.CursorFactory factory,int flags) |
根据提供的模式打开一个数据库 path:打开或创建的数据库文件 factory:可选的数据库游标工厂类,当查询(query)被提交时,该对象会被调用来实例化一个游标。默认为null。 flags:控制数据库的访问模式。主要有以下几种模式: l OPEN_READWRITE l OPEN_READONLY l CREATE_IF_NECESSARY l NO_LOCALIZED_COLLATORS |
static SQLiteDatabase |
openOrCreateDatabase(File file, SQLiteDatabase.CursorFactory factory) |
等同于openDatabase(file.getPath(), factory, CREATE_IF_NECESSARY) |
static SQLiteDatabase |
openOrCreateDatabase(String path, SQLiteDatabase.CursorFactory factory) |
等同于openDatabase(path,factory, CREATE_IF_NECESSARY) |
void |
close() |
关闭数据库 |
boolean |
deleteDatabase(String name) |
删除指定的数据库 name:要关闭的数据库的名字 |
示例代码如下:
//创建数据库 SQLiteDatabase mydataBase=SQLiteDatabase.create(new CursorFactory(){ //工厂类,一个可选工厂类,当查询时调用来实例化一个游标 @Override public Cursor newCursor(SQLiteDatabase db, SQLiteCursorDriver masterQuery, String editTable, SQLiteQuery query) { // TODO Auto-generated method stub return null; } }); //创建或打开数据库 SQLiteDatabase myDataBase=this.openOrCreateDatabase("myDataBase.db", MODE_PRIVATE, new CursorFactory(){ //创建新的数据库,名称myDatabase,模式MODE_PRIVATE,可选的游标工厂类 @Override public Cursor newCursor(SQLiteDatabase db, SQLiteCursorDriver masterQuery, String editTable, SQLiteQuery query) { // TODO Auto-generated method stub return null; } }); SQLiteDatabase myDataBase=this.openOrCreateDatabase("myDataBase.db",MODE_PRIVATE,null); //关闭数据库 myDataBase.close(); //删除指定名称的数据库 this.deleteDatabase(“myDatabase.db”); |
在对数据库中的表进行相关操作时,可以使用非查询的execSQL(String sql)来执行。示例代码如下:
String CREATE_TABLE = “create table table1 (_id integer primary key autoincrement,number integer,data text)”; //创建表 myDataBase.execSQL(CREATE_TABLE); |
Android提供了非SQL指令的对数据表进行操作的方法,以下表格是一些常用方法:
返回值 |
函数 |
备注 |
long |
insert(String table, String nullColumnHack, ContentValues values) |
向表中插入一条数据 table:想要插入数据的表名 nullColumnHack:SQL不允许插入空行,初始化值为空时,这一列将会被显示地赋一个null值 values:要插入的值,具体解释见表格后的解释 |
int |
delete(String table, String whereClause, String[] whereArgs) |
从表中删除一行数据 table:想要删除数据的表名 whereClause:可选的where子句,如果其值为null,将会删除所有的行。 whereArgs:当在whereClause中包含”?”时,如果whereArgs的值不为null,则这个数组中的值将依次替换whereClause中出现的”?” |
Cursor |
query(String table, String[] columns, String selection, String[] selectionArgs, String groupBy, String having, String orderBy, String limit) |
查询数据表 table:要查询数据的表名 columns:要返回的列的列名数组 selection:可选的where子句 ,如果其值为null,将会返回所有的行 selectionArgs:当在selection中包含”?”时,如果selectionArgs的值不为null,则这个数组中的值将依次替换selection中出现的”?” groupBy:可选的group by子句,如果其值为null,将不会对行进行分组 having:可选的having子句,如果其值为null,将会包含所有的分组 orderBy:可选的order by子句,如果其值为null,将会使用默认的排序规则 limit:可选的limit子句,如果其值为null,将不会包含limit子句 关于返回值类型Cursor将在表格后面进行解释 |
int |
update(String table, ContentValues values, String whereClause, String[] whereArgs) |
修改表中的数据 table:想要修改数据的表名 values:要更新的值,具体解释见表格后的解释 whereClause:可选的where子句,如果其值为null,将会修改所有的行。 whereArgs:当在whereClause中包含”?”时,如果whereArgs的值不为null,则这个数组中的值将依次替换whereClause中出现的”?” |
ContentValues主要是存放表中的数据段,以及其对应的值,与Hashtable一样采用名值对的形式存储,但是它存储的名值对中,名是一个String类型,值是基本数据类型。其使用示例如下:
ContentValues args = new ContentValues(); args.put(KEY_TITLE, title); args.put(KEY_BODY, body); myDataBase.update(DATABASE_TABLE, args, KEY_ROWID + "=" + rowId, null); |
Android采用游标对从数据库中查询出来的结果进行随机的读写访问,在查询数据库后,将结果返回给游标(即android.database.Cursor),这是查询结果的记录集,示意图如下:
_id |
someNumber |
|
|
1 |
8 |
2 |
10 |
|
3 |
2 |
Cursor类常见的方法如下:
返回值 |
函数 |
备注 |
boolean |
move(int offset) |
以当前位置为参考,将Cursor移动指定数目的位置(相对位置) |
boolean |
moveToPosition(int position) |
将Cursor移动到指定位置(绝对位置) |
boolean |
moveToNext() |
将Cursor向前移动一个位置 |
boolean |
moveToLast() |
将Cursor向后移动一个位置 |
boolean |
moveToFirst() |
将Cursor移动到第一行 |
boolean |
isBeforeFirst() |
返回Cursor是否指向第一项数据之前 |
boolean |
isAfterLast() |
返回Cursor是否指向最后一项数据之后 |
boolean |
isClosed() |
返回Cursor是否关闭 |
boolean |
isFirst() |
返回Cursor是否指向第一项数据 |
boolean |
isLast() |
返回Cursor是否指向最后一项数据 |
boolean |
isNull(int columnIndex) |
返回指定位置的值是否为null |
int |
getCount() |
返回总的项目总数 |
int |
getInt(int columnIndex) |
返回指定列中的数据的int型表示 |
int |
getColumnIndex(String columnName) |
按给定的列的名字返回列的索引值,如果不存在则返回 -1 |
要创建一个Cursor(游标),必须执行一个查询,通过SQL使用rawQuery()方法或是更精心的query()方法,而不能使用execSQL(String sql)方法。以下为Cursor的使用示例:
Cursor cur=myDataBase.rawQuery("select * from test", null); if(cur!=null){//游标不为空 //返回给定名称的列的基于0开始的index,如果该属性列不存在则返回-1 //通过它们的index来检索属性值 int numColumn=cur.getColumnIndex("someNumber"); if(cur.moveToFirst()){ //cur.moveToFirst()让游标指向第一行,如果游标指向第一行,则返回true do { int num=cur.getInt(numColumn);//获得当前行该属性的值 /*Cursor提供了不同的方法来回索不同的数据类型,例如getInt(int index)/getString(int index)等等*/ /*做一些事情*/ } while (cur.moveToNext()); /*游标移动到下一行,如果游标已经到达结果集中的最后,即没有行可以移动时,则返回false*/ //其他可能移动的是 moveToPrevious() 和moveToFirst()方法 } } |
在实际使用的时候,通常都要封装一个继承SQLiteOpenHelper类的数据库操作类。SQLiteOpenHelper类是一个抽象的辅助类,主要用来生成一个数据库并对数据库的版本进行管理,在SQLiteOpenHelper类的构造方法中分别传入Context、数据库名称,CursorFactory(一般传入null,否则为默认数据库),数据库版本号(不能为负数)。在SQLiteOpenHelper中首先执行的是onCreate方法(当数据库第一次创建时),一般在这个方法里生成数据表。要注意的是,在构造函数时并没有真正创建数据库,而是在调用getWriteableDatabase()或者getReadableDatabase()方法的时候系统才会真正创建数据库,如果当时系统中不存在这个数据库,系统会自动生成一个数据库,然后返回SQLiteDatabase对象。在继承这个类的时候,要实现里面的3个方法,其中前两个方法是必须重写的。见如下表格:
返回值 |
函数 |
备注 |
public void |
onCreate(SQLiteDatabase db) |
在数据库第一次生成时会调用这个方法,一般我们在这个方法里生成数据表 |
public void |
onUpgrade(SQLiteDatabase db,int oldVersion,int newVersion) |
当数据库需要升级时,系统会自动调用这个方法,一般我们在这个方法里删除数据表,并建立新的数据表,并根据实际需求做其他的操作 |
public void |
onOpen(SQLiteDatabase db) |
这是打开数据库时的回调函数,一般不会用到 |