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) | 这是打开数据库时的回调函数,一般不会用到 |