sqlite mysql 本机_使用 SQLite 本地数据库

为存储数据到数据库，首先需要定义数据库结构并打开数据库。 Android 提供了一个帮助类 SQLiteOpenHelper ，其中封装了一些存储应用数据的常用数据库操作，如 创建 、打开 以及 更新数据库 等。

SQLiteOpenHelper 类的常用方法

构造方法

SQLiteOpenHelper (Context context, //用来打开或创建一个数据库

String name, //用来指定数据库文件，若为 null 则指内存中的数据库

SQLiteDatabase.CursorFactory factory, //用来创建游标 Cursor 对象，若为 null 则使用默认的

int version) //数据库版本号，应为从 1 开始的递增整数值。

Tips： 关于版本号：

SQLiteOpenHelper 类有着管理不同版本数据库结构的能力。如果应用当前数据库版本更老，会通过 onUpgrade(SQLiteDatabase, int, int) 来更新数据库版本；反之如果当前应用数据库版本更新，则会通过 onDowngrade(SQLiteDatabase, int, int) 对数据库版本进行降级。

因此在实际应用中，每次对数据库结构做出调整后，都应该增加版本号常量。

公开的成员方法

//关闭任何已打开的数据库对象

void close ()

//创建或打开数据库

SQLiteDatabase getReadableDatabase ()

//创建或打开一个可读、可写的数据库

SQLiteDatabase getWritableDatabase ()

//配置数据库连接

void onConfigure (SQLiteDatabase db)

//第一次创建数据库时调用。数据库表的创建以及表的初始内容的填充 在这里完成。

void onCreate (SQLiteDatabase db)

//数据库降级

void onDowngrade (SQLiteDatabase db,

int oldVersion,

int newVersion)

//数据库升级

void onUpgrade (SQLiteDatabase db,

int oldVersion,

int newVersion)

Tips：

一般情况下，getReadableDatabase () 和 getWritableDatabase () 方法返回的是同一个对象，但如果出现一些极端情况(如硬盘满了)，那么调用 getReadableDatabase () 方法返回的就是一个只读的数据库。

这两种方法都会花费较长的时间，因此官方不建议从主线程(包括 ContentProvider.onCreate() )中调用。

SQLiteDatabase 类常用方法

执行 SQL 语句

/**

* execSQL()

* 作用: 执行一个非 SELECT 的 SQL 语句或任何其他返回数据的 SQL 语句

* @param String: 要执行的SQL语句。不支持以分号分隔的多个语句

* Throws SQLException: 当传入的 String 无效时

*/

void execSQL(String sql)

官方鼓励开发人员尽可能使用 SQLiteDatabase 内嵌的 insert() 、 update() 方法来取代传统的 SQL 语句，但是博主 Carson_Ho 在相关文章中却建议多使用 SQL 语句(因为相对官方提供的方法更为简单、通用)。至于具体实际应用中使用哪种为多，我也不知道了。。这里就先挖个坑吧，等经验多了再回过头来补充我自己的观点。

插入

/**

* insert()

* 作用: 向数据库中插入一行数据

* 返回值: long 型。返回新插入的行数，如果插入过程出错则返回 -1

* @param table: 指定表的名称

* @param nullColumHack: 可选的; 可能是null。SQL不允许在不命名至少一个列名的

情况下插入空行。如果您提供的values是空的，则不知道列名称，并且无法插入空行。如

果未设置为 null ，则该 nullColumnHack 参数提供可为空的列名称的名称，以便在您

values 为空时显式插入 null

* @param values: ContentValues - 此映射包含行的初始列值。键应该是列名，值应该是列值

*/

long insert (String table,

String nullColumnHack,

ContentValues values)

//下面语句的意思是：向名为 SQLTest 的表中插入 id = 1, name = "张三" 的记录

ContentValues value = new ContentValues();

value.put("id", 1);

value.put("name", "张三");

mDatabase.insert("SQLTest", null, value);

删除

/**

* delete()

* 作用: 删除数据库中的行

* 返回值: int 型。如果传入的是 where 子句那么返回受到影响的行数，否则返回 0 。要

删除所有行并获取总数则传入 1 作为 where 子句

* @param table: 指定表的名称

* @param whereClause: 删除时要应用的可选 where 子句。传递null将删除所有行

* @param whereArgs: 如果在 where 子句中包含 ？ ，它将被 whereArgs 中的值替换。

这些值将会被绑定成为字符串类型

*/

int delete (String table,

String whereClause,

String[] whereArgs)

//下面语句的意思是：从名为 SQLTest 的表中删除属性 id 值为 1 的行

mDatabase.delete("SQLTest", "id=?", new String[]{"1"});

修改

/**

* update()

* 作用: 更新数据库中的行

* 返回值: int 型。返回受影响的行数

* @param table: 指定表的名称

values 为空时显式插入 null

* @param values: ContentValues - 此映射包含行的初始列值。键应该是列名，值应该是列值

* @param whereClause: 删除时要应用的可选 where 子句。传递null将删除所有行

* @param whereArgs: 如果在 where 子句中包含 ? ，它将被 whereArgs 中的值替换。

这些值将会被绑定成为字符串类型

*/

int update (String table,

ContentValues values,

String whereClause,

String[] whereArgs)

//下面语句的意思是将名为 SQLTest 的表中， id=1 的元组的 name 值改为 "李四"

ContentValues value = new ContentValues();

value.put("name", "李四");

mDatabase.update("SQLTest", value1, "id=?", new String[]{"1"});

查询

/**

* query()

* 作用: 查询给定的 URL，返回 Cursor 结果集

* 返回值: 一个 Cursor 对象

* @param distinct: 消除相同行

* @param table: 指定表的名称

* @param columns: 要返回的列的列表(不建议为 null ，防止直接从内存中读取数据)

* @param selection: 一个过滤器，声明要返回哪些行，格式化为 SQL WHERE 子句(不包

括 WHERE 本身)。传入 null 将返回给定表的所有行

* @param selectionArgs: 如果在 selection 中包含了 ? ，那么它将被 selectionArgs 中的值替换

* @param groupBy: 一个过滤器，声明如何对行进行分组，格式化为 SQL GROUP BY 子句(不包

括 GROUP BY 本身)。传入 null 将导致行不被分组。

* @param having: 一个过滤器，声明要在游标中包含哪些行组，如果正在使用行分组，则格式化为

SQL HAVING 子句(不包括 HAVING 本身)。传入 null 将导致包含所有行组，并且在未使用行分

组时是必需的

* @param orderBy: 如何对行进行排序，格式化为 SQL ORDER BY 子句(不包括 ORDER BY 本身)。

传入 null 将使用默认排序顺序，该顺序可能是无序的

* @param limit: 限制查询返回的行数，格式为 LIMIT 子句。传入 null 表示没有 LIMIT 子句

*/

Cursor query (boolean distinct,

String table,

String[] columns,

String selection,

String[] selectionArgs,

String groupBy,

String having,

String orderBy,

String limit)

//query() 还有其他类似结构的方法，由于是部分参数的变化，这里就不一一列出了

由于这里涉及到了 Cursor ，因此要对查询结果进行进一步的操作就需要利用 Cursor 给出的方法，这里直接列出常用方法不再做多的说明：

//下面语句的意思是：将名为 SQLTest 的表中 id=1 的 "id" 列和 "name" 列返回给游标 Cursor

Cursor c = mDatabase.query(null, "SQLTest",

new String[]{"id", "name"},

"id=?",

new String[]{"1"},

null, null, null);

c.move(int offset); //以当前位置为参考,移动到指定行

c.moveToFirst(); //移动到第一行

c.moveToLast(); //移动到最后一行

c.moveToPosition(int position); //移动到指定行

c.moveToPrevious(); //移动到前一行

c.moveToNext(); //移动到下一行

c.isFirst(); //是否指向第一条

c.isLast(); //是否指向最后一条

c.isBeforeFirst(); //是否指向第一条之前

c.isAfterLast(); //是否指向最后一条之后

c.isNull(int columnIndex); //指定列是否为空(列基数为0)

c.isClosed(); //游标是否已关闭

c.getCount(); //总数据项数

c.getPosition(); //返回当前游标所指向的行数

c.getColumnIndex(String columnName); //返回某列名对应的列索引值

c.getString(int columnIndex); //返回当前行指定列的值

Demo

SQLTest Demo

本来想着把 Demo 放到 github 上的，但是由于代码实现起来较为容易，也没有这个必要，这里就不再放出了。

参考资源：

Android API

Android 编程权威指南 [美]Phillips,B. [美]Hardy,B. [译]王明发 (人民邮电出版社)

Android ：SQLlite数据库 使用手册 -- Carson_Ho