Android提供了创建和使用SQLite数据库的API(Application Programming Interface,应用程序编程接口)。
在Android系统中,主要由类SQLiteDatabase和SQLiteOpenHelper对SQLite数据库进行管理和操作。
(一)SQLiteOpenHelper类
SQLiteOpenHelper是SQLiteDatabase的一个帮助类,用来管理数据库的创建和版本的更新。
因为是个抽象类,所以必须创建一个类来继承它,并实现两个抽象的方法onCreate()和onUpgrade()方法。
方法 | 说明 |
SQLiteOpenHelper(Context context, String name, SQLiteDatabase.CursorFactory factory, int version) |
构造方法 |
abstract void onCreate(SQLiteDatabase db) | 创建数据库时调用 |
abstract void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) |
升级数据库时调用
|
void onOpen(SQLiteDatabase db) | 打开数据库时调用 |
SQLiteDatabase getReadableDatabase() |
创建或打开数据库
|
SQLiteDatabase getWritableDatabase() | 创建或打开一个读写数据库 |
下面是一个具体的例子:DatabaseHelper.java
private static class DatabaseHelper extends SQLiteOpenHelper { static final String DATABASE_NAME = "College.db"; static final int DATABASE_VERSION = 1; static final String STUDENTS_TABLE_NAME = "students"; static final String CREATE_DB_TABLE = " CREATE TABLE " + STUDENTS_TABLE_NAME + " (_id INTEGER PRIMARY KEY AUTOINCREMENT, " + " name TEXT NOT NULL, " + " grade TEXT NOT NULL);"; DatabaseHelper(Context context){ super(context, DATABASE_NAME, null, DATABASE_VERSION); } @Override public void onCreate(SQLiteDatabase db) { db.execSQL(CREATE_DB_TABLE); } @Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { db.execSQL("DROP TABLE IF EXISTS " + STUDENTS_TABLE_NAME); onCreate(db); } }
(二)创建数据库
在Activity中创建数据库对象,可能是在onCreate()方法或事件中创建:
DatabaseHelper database = new DatabaseHelper(this); SQLiteDatabase db = null; db = database.getWritableDatabase();
首先实例一个SQLiteOpenHelper帮助类的对象,然后调用该对象的getWritableDatabase() 或 getReadableDatabase()方法 获得SQLiteDatabase 数据库对象。
另外2种创建的方法:
1、应用SQLiteDatabase对象openDatabase()方法及openOrCreateDatabase()方法创建数据库;
2、应用Activity继承于父类android.content.Context创建数据库的方法openOrCreateDatabase()来创建数据库。
1、在DDMS中查看,College.db 生成在/data/data/xxxx(包名)/databases路径下。
2、删除数据库文件,应用android.content.Context类的deleteDatabase(String name)方法来删除指定的数据库。
(三)SQLiteDatabase 类
SQLiteDatabase 类的方法有很多,下面是最常用的几个。一般的数据操作,可以使用对应的方法,或者自己写需要的sql语句,再调用execSQL()方法执行。
方法 | 说明 |
openOrCreateDatabase(String path, SQLiteDatabase.CursorFactory factory) |
打开或创建数据库 |
openDatabase(String path, SQLiteDatabase.CursorFactory factory,int flags) |
打开指定的数据库 |
insert(String table, String nullColumnHack, ContentValues values) |
新增一条记录 |
delete(String table,String whereClause, String[] whereArgs) |
删除一条记录 |
update(String table,ContentValues values, String whereClause,String[] whereArgs) |
修改记录 |
query(String table,String[] columns, String selection, String[]selectionArgs, String groupBy,String having, String orderBy) |
查询一条记录 |
execSQL(String sql) | 执行SQL语句 |
close() | 关闭数据库 |
(四)增删改查
对数据记录的操作处理有两种方法:
- 编写一条对记录进行增、删、改、查的SQL语句,通过exeSQL()方法来执行
- 使用SQLiteDatabase对象的相应方法进行操作
数据添加
insert(String table, String nullColumnHack, ContentValues values)方法
第1个参数table:增加记录的数据表;
第2个参数nullColumnHack:空列的默认值,通常为null;
第3个参数ContentValues:为ContentValues对象,其实就是一个键值对的字段名称,键名为表中的字段名,键值为要增加的记录数据值。通过ContentValues对象的put()方法把数据存放到ContentValues对象中。
ContentValues cv = new ContentValues(); //实例化ContentValues用来装载待插入的数据 cv.put("name","Apple"); //添加学生 cv.put("grade","A"); //添加成绩 db.insert("user",null,cv); //执行插入操作
或者
String sql = "insert into students (name,grade) values ('Apple','A'); db.execSQL(sql);
数据删除
delete(String table,String whereClause, String[] whereArgs)方法
第1个参数table:修改记录的数据表;
第2个参数whereClause:删除数据的条件,相当于SQL语句的where子句;
第3个参数whereArgs:删除条件的参数数组。
String whereClause = "name=?"; //删除的条件 String[] whereArgs = {"Apple"}; //删除的条件参数 db.delete("students",whereClause,whereArgs); //执行删除
或者
String sql = "delete from students where name='Apple'";
db.execSQL(sql);
数据修改
update(String table,ContentValues values,String whereClause, String[] whereArgs)方法
第1个参数table:修改记录的数据表;
第2个参数ContentValues:ContentValues对象,存放已作修改的数据的对象;
第3个参数whereClause:修改数据的条件,相当于SQL语句的where子句;
第4个参数whereArgs:修改数据值的数组。
ContentValues cv = new ContentValues(); //实例化ContentValues cv.put("grade","AA"); //添加要更改的字段及内容 String whereClause = "username=?"; //修改条件 String[] whereArgs = {"Appke"}; //修改条件的参数 db.update("students",cv,whereClause,whereArgs); //执行修改
或者
String sql = "update students set grade = 'AA' where name='Apple'";
db.execSQL(sql);
数据查询
query(String table, String[] columns, String selection,
String[] selectionArgs, String groupBy, String having, String orderBy)方法
第1个参数table:查询记录的数据表;
第2个参数columns:查询的字段,如为null,则为所有字段;
第3个参数selection:查询条件,可以使用通配符“?”;
第4个参数selectionArgs:参数数组,用于替换查询条件中的“?”;
第5个参数groupBy:查询结果按指定字段分组;
第6个参数having:限定分组的条件;
第7个参数orderBy:查询结果的排序条件。
db.query("students",null,null,null,null,null,null);
或者
String sql = "select * from students";
db.execSQL(sql);
(五)对查询结果cursor的处理
query()方法查询的数据均封装到查询结果Cursor对象之中,Cursor相当于SQL语句中resultSet结果集上的一个游标,可以向前向后移动。
Cursor对象的常用方法有:
方法 |
说明 |
getCount() |
获取总记录条数 |
isFirst() |
判断是否第一条记录 |
isLast() |
判断是否最后一条记录 |
moveToFirst() |
移动到第一条记录 |
moveToLast() |
移动到最后一条记录 |
move(int offset) |
移动到指定的记录 |
moveToNext() |
移动到下一条记录 |
moveToPrevious() |
移动到上一条记录 |
getColumnIndex(String columnName) |
获得指定列索引的int类型值 |
一个例子:
Cursor c = db.query("students",null,null,null,null,null,null); //查询并获得游标 if(c.moveToFirst()){ //判断游标是否为空 for(int i=0;i<c.getCount();i++){ c.move(i); //移动到指定记录 String name = c.getString(c.getColumnIndex("name"); String grade = c.getString(c.getColumnIndex("grade")); } }