一、概述
SQLite是Android系统的核心数据存储服务之一,它是一个轻型的嵌入式数据库,占用非常少的资源却能提供很好很快的数据存取服务,许多大型的需要数据存储的Android项目都有用到SQLite(也可以用于桌面应用程序)。
下面介绍一下SQLite的创建数据库、表的操作,以及基本的增删改查操作。
二、基本操作API简介
在Android中,SQLiteDatabase类提供了SQLite的底层API,但在使用SQLite数据库时,我们往往不会直接操作SQLiteDatabase这个类,而是自己创建一个继承自SQLitOpenHelper的子类来实现数据库操作。这样做的目的一是为了以后如果数据库升级不至于要改动太多代码,已实现封装;二则是为了我们使用更方便。
1、创建数据库和表
SQLiteOpenHelper是一个抽象类,在这个类里有两个抽象方法,OnCreate和OnUpgrade,前者用于第一次创建数据库,后者用于数据库升级,创建类DBServices如下:
public class DBServices extends SQLiteOpenHelper{
final static int version = 1;
final static String dbName = "plan";
public DBServices(Context context){
super(context,dbName,null,version);
}
@Override
public void onCreate(SQLiteDatabase db) {
// TODO Auto-generated method stub
//创建今日计划表
String create_today_plan_sql = "CREATE TABLE [_today_plan] ("
+ "[_Date] varchar(10) not null,"
+ "[Item] varchar(200),"
+ "[Check] varchar(5) )";
db.execSQL(create_today_plan_sql);
}
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
// TODO Auto-generated method stub
}
}
示例里定义两个变量,一个是数据库的版本号,一个是数据库名。当Android应用运行时,SQLiteOpenHelper会先检查是否已经存在数据库,如果不存在,就创建数据库,然后打开数据库,最后调用OnCreate方法,所以我们需要再OnCreate中创建表(视图等);如果数据库已存在,而版本号比上次创建的数据库版本号高,就调用OnUpgrade,用于升级。
2、数据的增——insert
在创建了数据库和表之后,我们就可以给数据库和表添加数据了。
添加数据的操作和其他数据库一样,也是使用insert,只是SQLite的insert是函数,而且使用起来非常方便,下面是方法(属于上面的DBServices类,附录里有完整代码):
public void insert(String table, String nullColumnHack, ContentValues values){
SQLiteDatabase db = this.getWritableDatabase();
db.insert(table, nullColumnHack, values);
}
参数说明:
table:表名,直接使用字符串指定;
nullColumnHack:指定null值的列,SQLite里不允许空行,使用这个参数可以指定一个列的值为null,当存入行为空时,这个列的值就被指定为null;
values:使用类似map键值对映射的数据结构ContentValues来指定插入的数据
添加数据示例:
String[] args = {
today,
content,
Boolean.toString(checked)
};
String[] column = {
"[_Date]",
"[Item]",
"[Check]"
};
//数据库中添加数据
ContentValues c = new ContentValues();
for(int i=0;i<args.length;i++){
c.put(column[i], args[i]);
}
dbServices.insert("_today_plan", null, c);
3、数据的删——delete
删除和添加一样,也是通过传入参数调用方法来实现,方法:
public void delete(String table , String whereClause , String[] whereArgs){
SQLiteDatabase db = this.getWritableDatabase();
db.delete(table, whereClause, whereArgs);
Log.d("Delete",whereClause);
}
参数说明:
table:表名;
whereClause:可选,指定删除条件,相当于SQL语句WHERE语句之后的类容,可通过?来指定参数;
whereArgs:当whereClause指定了?参数,这个字符串数组里就是?所代表的参数,个数应与?数一致;
删除数据示例:
String args[] ={
today,
content,
Boolean.toString(checked)
};
dbServices.delete("_today_plan", "[_Date]=? and [Item]=? and [Check]=?"
,args);
4、数据的修改——update
修改与添加、删除相差不多,下面是update方法:
public void update(String table, ContentValues values,
String whereClause, String[] whereArgs){
SQLiteDatabase db = this.getWritableDatabase();
db.update(table, values, whereClause, whereArgs);
}
参数说明:
table:表名;
values:同上,是需要修改的列和值的映射集合;
whereClause:修改的行所需符合的条件;
whereArgs:指定条件里的参数;
修改数据示例:
String args[] ={
today,
content,
Boolean.toString(!m)
};
ContentValues c = new ContentValues();
c.put("[Check]", Boolean.toString(m));
dbServices.update("_today_plan", c,"[_Date]=? and [StartTime]=? and [Item]=? and [Check]=?"
,args);
5、数据的查询——read
在这里就和前面有所不同了,读取数据所用的方法是直接执行查询语句,获取游标,然后通过游标来遍历数据库,方法如下:
public Cursor read(String sql ,String[] args){
SQLiteDatabase db = this.getReadableDatabase();
Cursor cursor = db.rawQuery(sql, args);
Log.d("Database",cursor.getColumnName(0));
return cursor;
}
方法说明:
请注意:在这里db获取的是只读的数据库(getReadableDatabase),而在上述三种操作里都是使用的可写数据库(getWritableDatabase);至于游标的用法此处就不再赘述,只需看一下API的名字就能掌握基本用法,但最后一定要记得将游标关闭(close)!
三、附录
附录了DBServices类,仅作参考
package com.plan;
import android.content.ContentValues;
import android.content.Context;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteOpenHelper;
import android.util.Log;
public class DBServices extends SQLiteOpenHelper{
final static int version = 1;
final static String dbName = "plan";
public DBServices(Context context){
super(context,dbName,null,version);
}
@Override
public void onCreate(SQLiteDatabase db) {
// TODO Auto-generated method stub
//创建今日计划表
String create_today_plan_sql = "CREATE TABLE [_today_plan] ("
+ "[_Date] varchar(10) not null,"
+ "[Item] varchar(200),"
+ "[Check] varchar(5) )";
db.execSQL(create_today_plan_sql);
}
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
// TODO Auto-generated method stub
}
public Cursor read(String sql ,String[] args){
SQLiteDatabase db = this.getReadableDatabase();
Cursor cursor = db.rawQuery(sql, args);
Log.d("Database",cursor.getColumnName(0));
return cursor;
}
public void insert(String table, String nullColumnHack, ContentValues values){
SQLiteDatabase db = this.getWritableDatabase();
db.insert(table, nullColumnHack, values);
}
public void delete(String table , String whereClause , String[] whereArgs){
SQLiteDatabase db = this.getWritableDatabase();
db.delete(table, whereClause, whereArgs);
Log.d("Delete",whereClause);
}
public void update(String table, ContentValues values,
String whereClause, String[] whereArgs){
SQLiteDatabase db = this.getWritableDatabase();
db.update(table, values, whereClause, whereArgs);
}
}
有关SQLite的高级特性,如索引、视图以及触发器等,大家可以去看看SQlite的官方文档。
上述类在手机重启时,数据库会重新创建,原因是数据库没有关闭(但因为要提供游标,所以控制起来会比较困难),所以这里提出一个解决办法,就是数据库的操作(建表、增、删、改)均使用事务方式,示例如下:
db.beginTransaction(); //事务开始
//建表、增、删、改、查
db.setTransactionSuccessful(); //事务成功
db.endTransaction(); //提交事务