Android SQLite 数据库开发使用示例

一、

首先我们需要创建一个继承自 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"});
    }