Android 数据存储(三)-SQLite数据库实例
一、介绍
1.1 SQLite
对于重复数据或结构化数据(例如联系信息),将数据保存到数据库是理想选择。下面咱咱就开始在Android上使用SQLite数据库。android.database.sqlite软件包中提供了在Android上使用数据库所需的API。
咱先玩玩SQLite数据库,后面咱从SQLite迁移到Room。
注意:虽然这些API功能强大,但它们的级别较低,使用起来需要花费大量时间和精力.
-
没有针对原始SQL查询的编译时验证。随着数据图表不断发生变化,你需要手动更新受影响的SQL查询。此过程既耗时又容易出错。 -
你需要使用大量样板代码,在SQL查询和数据对象之间进行转换。
出于这些原因,咱强烈建议将 Room 持久性库用作抽象层以访问应用的SQLite数据库中的信息。
Room持久性库:在SQLite上提供了一个抽象层,允许流畅的数据库访问,同时充分利用SQLite的强大功能。
1.2 SQL的基本语法
SQL本质上是一种编程语言,它的学名叫作“结构化查询语言”(全称为StructuredQuery Language,简称SQL)。不过SQL语言并非通用的编程语言,它专用于数据库的访问和处理,更像是一种操作命令,所以常说SQL语句而不说SQL代码。标准的SQL语句分为3类:数据定义、数据操纵和数据控制,但不同的数据库往往有自己的实现。
SQLite是一种小巧的嵌入式数据库,使用方便、开发简单。如同MySQL、Oracle那样,SQLite也采用SQL语句管理数据,由于它属于轻型数据库,不涉及复杂的数据控制操作,因此App开发只用到数据定义和数据操纵两类SQL。此外,SQLite的SQL语法与通用的SQL语法略有不同。
1.3 数据库帮助器SQLiteOpenHelper
由于SQLiteDatabase存在局限性,一不小心就会重复打开数据库,处理数据库的升级也不方便;因此Android提供了数据库帮助器SQLiteOpenHelper,帮助开发者合理使用SQLite。
SQLiteOpenHelper的具体使用步骤如下:
-
步骤1:新建一个继承自SQLiteOpenHelper的数据库操作类,按提示重写onCreate和onUpgrade两个方法。其中,onCreate方法只在第一次打开数据库时执行,在此可以创建表结构;而onUpgrade方法在数据库版本升高时执行,在此可以根据新旧版本号变更表结构。
-
步骤2:为保证数据库安全使用,需要封装几个必要方法,包括获取单例对象.打开数据库连接、关闭数据库连接,说明如下:
-
获取单例对象:确保在App运行过程中数据库只会打开一次,避免重复打开引起错误。 -
打开数据库连接:SQLite有锁机制,即读锁和写锁的处理;故而数据库连接也分两种,读连接可调用getReadableDatabase方法获得,写连接可调用getWritableDatabase获得。 -
关闭数据库连接:数据库操作完毕,调用数据库实例的close方法关闭连接。
-
-
步骤3:提供对表记录增加、删除、修改、查询的操作方法。
二、使用 SQLite
2.1 继承SQLiteOpenHelper类,重写onCreate、onUpgrade、onOpen方法
创建的默认数据库路径:/data/data/com.scc.datastorage(你的包名)/databases/user.db
public class UserDBHelper extends SQLiteOpenHelper {
private static final String DB_NAME = "user.db";//数据库的名称
private static UserDBHelper mHelper = null;//数据库帮助器的实例
private SQLiteDatabase mDB = null;//数据库的实例
public static final String TABLE_NAME = "user_info";
public static final String _ID = "_id";
public static final String COLUMN_NAME = "name";
public static final String COLUMN_AGE = "age";
public static final String COLUMN_UPDATE_TIME = "update_time";
/**
* @param context 上下文环境(例如,一个 Activity)
* DB_NAME 数据库名字
* factory null 一个可选的游标工厂(通常是 Null)
* @param version 数据库模型版本的整数
* 会调用父类 SQLiteOpenHelper的构造函数
*/
public UserDBHelper(Context context, int version) {
super(context, DB_NAME, null, version);
}
//利用单例模式获取SQLiteOpenHelper的唯一实例
public static UserDBHelper getInstance(Context context, int version) {
if (version > 0 && mHelper == null) {
//创建数据库
mHelper = new UserDBHelper(context, version);
}
return mHelper;
}
//创建数据库表,执行建表语句
@Override
public void onCreate(SQLiteDatabase db) {
}
/**
* 当数据库需要修改的时候(两个数据库版本不同),Android系统会主动的调用这个方法。
* 一般我们在这个方法里边删除数据库表,并建立新的数据库表.
*/
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
}
@Override
public void onOpen(SQLiteDatabase db) {
//每次成功打开数据库后首先被执行
super.onOpen(db);
}
}
userDBHelper = UserDBHelper.getInstance(SQLiteActivity.this, 1);
2.2 创建表
表格的创建动作由create命令完成,格式为“CREATE TABLE IFNOT EXISTS表格名称(以逗号分隔的各字段定义);”。以用户信息表为例,它的建表语句如下所示:
public class UserDBHelper extends SQLiteOpenHelper {
//创建数据库,执行建表语句
@Override
public void onCreate(SQLiteDatabase db) {
Log.e(getClass().getName(), "onCreate");
//创建表语句
String SQL_CREATE_ENTRIES = "CREATE TABLE IF NOT EXISTS "
+ TABLE_NAME + "("
+ _ID + " INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL,"
+ COLUMN_NAME+" VARCHAR NOT NULL,"
+ COLUMN_AGE+" INTEGER NOT NULL,"
+ COLUMN_UPDATE_TIME+" VARCHAR NOT NULL" + "); ";
//执行完整的sQL语句
db.execSQL(SQL_CREATE_ENTRIES);
}
}
上面的SQL语法与其他数据库的SQL语法有所出入,相关的注意点说明见下:
-
1.SQL语句不区分大小写,无论是create与table这类关键词,还是表格名称、字段名称,都不区分大小写。唯一区分大小写的是被单引号括起来的字符串值。
-
2.为避免重复建表,应加上IF NOT EXISTS关键词,例如CREATE TABLE IFNOT EXISTS表格名称......
-
3.SQLite支持整型INTEGER、长整型LONG、字符串VARCHAR、浮点数FLOAT,但不支持布尔类型。布尔类型的数据要使用整型保存,如果直接保存布尔数据,在入库时sQLite会自动将它转为0或1,其中0表示false,1表示true。
-
4.建表时需要唯一标识字段,它的字段名为_id。创建新表都要加上该字段定义,例如_id lNTEGER PRIMARY KEY AUTOINCREMENT NOT NULL。
2.3 删除表
表格的删除动作由drop命令完成,格式为“DROP TABLE IFEXISTS表格名称;”。下面是删除用户信息表的SQL语句例子:
//删除表
public void deleteTable(SQLiteDatabase db) {
String SQL_DELETE_ENTRIES = "DROP TABLE IF EXISTS " + TABLE_NAME;
db.execSQL(SQL_DELETE_ENTRIES);
}
2.4 打开数据库表
下面这段代码会返回一个 SQLiteDatabase 类的实例,使用这个对象,你就可以查询或者修改数据库。
//打开数据库的读连接(查询数据库)
public SQLiteDatabase openReadLink() {
if (mDB == null || !mDB.isOpen()) {
mDB = mHelper.getReadableDatabase();
}
return mDB;
}
//打开数据库的写连接(可写数据库)
public SQLiteDatabase openwriteLink() {
if (mDB == null || !mDB.isOpen()) {
mDB = mHelper.getWritableDatabase();
}
return mDB;
}
2.5 关闭数据库
由于在数据库关闭时,调用getWritableDatabase()和getReadableDatabase()的成本比较高,因此只要你有可能需要访问数据库,就应保持数据库连接处于打开状态。通常情况下,最好在调用的Activity的onDestroy()中关闭数据库。
@Override
protected void onDestroy() {
userDBHelper.closeLink();
super.onDestroy();
}
2.6 数据的增删改查
2.6.1 添加数据
使用 SQLiteDatabase 对象的insert()。
//往该表添加多条记录
public long insert(List<UserInfoBean> infoList) {
long result = -1;
for (int i = 0; i < infoList.size(); i++) {
UserInfoBean info = infoList.get(i);
//不存在唯一性重复的记录,则插入新记录
ContentValues cv = new ContentValues();
cv.put(_ID, info.get_id());
cv.put(COLUMN_NAME, info.getName());
cv.put(COLUMN_AGE, info.getAge());
cv.put(COLUMN_UPDATE_TIME, info.getUpdate_time());
//执行插入记录动作,该语句返回插入记录的行号
result = mDB.insert(TABLE_NAME, "", cv);
if (result == -1) {//添加成功则返回行号,添加失败则返回-1
return result;
}
}
return result;
}
调用方法添加数据:
List<UserInfoBean> list = new ArrayList<>();
list.add(new UserInfoBean("10", "帅次次", 20, "09:00"));
list.add(new UserInfoBean("12", "朱元璋", 30, "11:00"));
list.add(new UserInfoBean("15", "赵匡胤", 40, "13:00"));
list.add(new UserInfoBean("18", "李世民", 50, "15:00"));
long l = userDBHelper.insert(list);
sqliteBinding.tvSql.setText("插入成功:" + l);
2.6.2 修改数据
使用SQLiteDatabase 对象的update()方法。
//根据条件更新指定的表记录
public int update(UserInfoBean info, String condition) {
ContentValues cv = new ContentValues();
cv.put(COLUMN_NAME, info.getName());
cv.put(COLUMN_AGE, info.getAge());
cv.put(COLUMN_UPDATE_TIME, info.getUpdate_time());
//执行更新记录动作,该语句返回更新的记录数量
return mDB.update(TABLE_NAME, cv, condition, null);
}
调用方法修改数据:
UserInfoBean bean = new UserInfoBean("武媚娘", 32,"12:00");
userDBHelper.update(bean, "_id=18");
2.6.3 查找数据
使用SQLiteDatabase 对象的query()方法。
//根据指定条件查询记录,并返回结果数据列表
public List<UserInfoBean> query() {
List<UserInfoBean> infoList = new ArrayList<UserInfoBean>();
//执行记录查询动作,该语句返回结果集的游标
//SELECT语句内容作为 query()方法的参数,比如:要查询的表名,要获取的字段名,WHERE条件,
//包含可选的位置参数,去替代WHERE条件中位置参数的值,GROUP BY条件,HAVING条件。
//除了表名,其他参数可以是null
Cursor cursor = mDB.query(TABLE_NAME, null, null, null, null, null, null);
//循环取出游标指向的每条记录
while (cursor.moveToNext()) {
UserInfoBean info = new UserInfoBean();
info._id = cursor.getString(0);//取出字符串
info.name = cursor.getString(1);//取出字符串
info.age = cursor.getInt(2);//取出整型数
info.update_time = cursor.getString(3);//取出字符串
infoList.add(info);
}
cursor.close();
// 查询完毕,关闭数据库游标
return infoList;
}
调用方法查找数据:
StringBuilder sql = new StringBuilder();
List<UserInfoBean> list = userDBHelper.query();
sql.append(list.size());
2.6.4 删除数据
使用SQLiteDatabase 对象的delete()方法。
//根据指定条件删除表记录
public int delete(String condition) {
Log.e(getClass().getName(), "delete:" + condition);
//执行删除记录动作,该语句返回删除记录的数目
return mDB.delete(TABLE_NAME, condition, null);
}
调用方法删除数据:
userDBHelper.delete("_id=12");
2.6.6 删除表
//删除表
public void deleteTable(SQLiteDatabase db) {
String SQL_DELETE_ENTRIES = "DROP TABLE IF EXISTS " + TABLE_NAME;
db.execSQL(SQL_DELETE_ENTRIES);
}
调用方法删除表:
userDBHelper.deleteTable(db));
注意:这里删除的是表,而不是数据库,所以你在
2.6.6 操作表报错
在未创建表或者删除表后不要对表进行操作,否则会报错
1、添加数据失败(Error)程序报错
E/SQLiteLog: (1) no such table: user_info in "INSERT INTO user_info(update_time,_id,age,name) VALUES (?,?,?,?)"
E/SQLiteDatabase: Error inserting update_time=09:00 _id=10 age=20 name=帅次次
android.database.sqlite.SQLiteException: no such table: user_info (code 1 SQLITE_ERROR): , while compiling: INSERT INTO user_info(update_time,_id,age,name) VALUES (?,?,?,?)
2、删改查数据(AndroidRuntime)程序崩溃
E/SQLiteLog: (1) no such table: user_info in "SELECT * FROM user_info"
D/AndroidRuntime: Shutting down VM
E/AndroidRuntime: FATAL EXCEPTION: main
Process: com.scc.datastorage, PID: 15093
android.database.sqlite.SQLiteException: no such table: user_info (code 1 SQLITE_ERROR): , while compiling: SELECT * FROM user_info
三、各参数说明
-
table:表名称
-
colums:列名称数组
-
selection:条件子句,相当于where
-
selectionArgs:条件语句的参数数组
-
groupBy:分组
-
having:分组条件
-
orderBy:排序类
-
limit:分页查询的限制
-
Cursor:返回值,相当于结果集ResultSet
使用游标
不管你如何执行查询,都会返回一个 Cursor,这是 Android 的 SQLite 数据库游标,使用游标,你可以:
-
通过getCount() 方法:得到结果集中有多少记录;
-
通过 moveToFirst(), moveToNext(), 和 isAfterLast() 方法:遍历所有记录;
-
通过 getColumnNames() 方法:得到字段名;
-
通过 getColumnIndex() 方法:转换成字段号;
-
通过 getString(),getInt() 等方法:得到给定字段当前记录的值;
-
通过 requery() 方法:重新执行查询得到游标;
-
通过 close() 方法:释放游标资源;
四、相关链接
- 点赞
- 收藏
- 关注作者
评论(0)