一、
首先我们需要创建一个继承自 SQLiteOpenHelper 的子类来管理数据库的创建、升级的工具类,代码如下:
public class SQLiteDbHelper extends SQLiteOpenHelper {
public static final String DB_NAME = "database.db";
public static final int DB_VERSION = 1;
public static final String TABLE_STUDENT = "students";
//创建 students 表的 sql 语句
private static final String STUDENTS_CREATE_TABLE_SQL = "create table" + TABLE_STUDENT + "("
+ "id integer primary key autoincrement,"
+ "name varchar(20) not null,"
+ "tel_no varchar(11) not null,"
+ "cls_id integer not null"
+ ");";
public SQLiteDbHelper(Context context) {
// 传递数据库名与版本号给父类
super(context, DB_NAME, null, DB_VERSION);
}
@Override
public void onCreate(SQLiteDatabase db) {
// 在这里通过 db.execSQL 函数执行 SQL 语句创建所需要的表
// 创建 students 表
db.execSQL(STUDENTS_CREATE_TABLE_SQL);
}
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
// 数据库版本号变更会调用 onUpgrade 函数,在这根据版本号进行升级数据库
switch (oldVersion) {
case 1:
// do something
break;
default:
break;
}
}
@Override
public void onOpen(SQLiteDatabase db) {
super.onOpen(db);
if (!db.isReadOnly()) {
// 启动外键
db.execSQL("PRAGMA foreign_keys = 1;");
//或者这样写
String query = String.format("PRAGMA foreign_keys = %s", "ON");
db.execSQL(query);
}
}
}
onCreate 函数会在第一次创建数据库时被调用,因此,在这里执行创建 students 数据库的 SQL 语句。
注意:创建数据库的 SQL 语句中字段的顺序就是我们使用 Cursor 类通过索引获取字段值时的索引位置。比如,students 表中第一个字段是 id,那么 id 的索引位置就是 0。
二、
接下来创建一个 student 类代表学生信息的实体类。
public class Student {
public long id;
public String name;
public String tel_no;
public int cls_id;
}
然后我们需要获取数据库的操作对象,可以从 SQLiteDbHelper 的 getWriteDatabase 函数获取,代码如下:
SQLiteDbHelper helper = new SQLiteDbHelper(getApplicationContext());
SQLiteDatabase database = helper.getWritableDatabase();
三、
3.1
向 students 表插入几条数据试试:
public void insertStudents() {
for (int i = 0; i < 5; i++) {
ContentValues values = studentToContentValues(mockStudent(i));
mSQLiteDatabase.insert(SQLiteDbHelper.TABLE_STUDENT, null, values);
}
}
// 构建 student 对象
private Student mockStudent(int i) {
Student student = new Student();
student.id = i;
student.name = "user-" + i;
student.tel_no = String.valueOf(new Random().nextInt(200000));
student.cls_id = new Random().nextInt(5);
return student;
}
// 将 student 对象的值存储到 ContentValues 中
private ContentValues studentToContentValues(Student student) {
ContentValues contentValues = new ContentValues();
contentValues.put("id", student.id);
contentValues.put("name", student.name);
contentValues.put("tel_no", student.tel_no);
contentValues.put("cls_id", student.cls_id);
return contentValues;
}
注意:ContentValues 存储的键必须与数据库中的字段名一致,ContentValues 的值就是字段的值。
3.2
插入数据之后,我们来试试使用查询操作吧:
private void queryStudents() {
// 相当于 select * from students 语句
Cursor cursor = mSQLiteDatabase.query(SQLiteDbHelper.TABLE_STUDENT, null,
"cls_id > ? and id >= 1", new String[]{"3"},
null, null, null, null);
// 不断移动光标获取值
while (cursor.moveToNext()) {
// 直接通过索引获取字段值
int stuId = cursor.getInt(0);
// 先获取 name 的索引值,然后再通过索引获取字段值
String stuName = cursor.getString(cursor.getColumnIndex("name"));
Log.e("", "id: " + stuId + " name: " + stuName);
}
// 关闭光标
cursor.close();
}
注意:cls_id 的类型为整型,但是参数 4 给出的是字符串值 — new String[]{"3"},这里不必担心,SQLite 会在底层进行类型转换,将参数 4 中的值转为表中字段对应的类型。
3.3
删除操作也类似:
private void deleteStudents() {
mSQLiteDatabase.delete(SQLiteDbHelper.TABLE_STUDENT,
"cls = ?", new String[]{"3"});
}
3.4
更新操作的参数就比删除操作多了一个 ContentValues,也就是要更新的字段键值对:
private void updateStudents() {
ContentValues contentValues = new ContentValues();
contentValues.put("name", "Jerry");
mSQLiteDatabase.update(SQLiteDbHelper.TABLE_STUDENT,
contentValues, "cls_id = ?", new String[]{"3"});
}