概述
在项目的开发过程中,有很多功能都需要我们将数据保存到我们的手机本地来提升app的性能,常见的有图片缓存、消息的离线缓存等;
Android端常见的本地数据缓存方式有:
- SharedPreference:缓存轻量级的 key-value 类型的数据,例如:账号、密码等;
- File:用来存储文件,例如:图片,音乐等;
- SQLite:用来存储大量复杂的关系型数据;
我们知道现在的app都是数据量比较大的,例如我们每天使用的qq,少的来说也有几百条消息记录,多的有可能是上万条的消息数据,如果我们使用 SharedPreference 或者 File 来存储显然是不合适的,这时候就应该轮到SQLite数据库上场了;
本片文章着重讲的是如何使用,关于 SQLite 的概念大家可以自己去找资料;
关于SQLiteOpenHelper的使用
Android 官方帮我们封装了一个SQLiteOpenHelper类来帮助我们操作数据库;我们只需要写一个类继承它,重写抽象方法即可;
public class DbOpenHelper extends SQLiteOpenHelper {
public static DbOpenHelper mInstance;
private DbOpenHelper() {
super(AppApplication.mContext, getUserDatabaseName(), null, Constant.DATABASE_VERSION);
}
/**
* @param context 我们可以使用ApplicationContext,因此我们在设计单例的时候可以设置成无参
* @param name 创建的数据库的名称
* @param factory 游标工厂,直接传入null就好
* @param version 创建的数据库版本 >= 1
*/
private DbOpenHelper(Context context, String name, SQLiteDatabase.CursorFactory factory, int version) {
super(context, name, factory, version);
}
public static DbOpenHelper getInstance() {
if (mInstance == null) {
synchronized (DbOpenHelper.class) {
if (mInstance == null) {
mInstance = new DbOpenHelper();
}
}
}
return mInstance;
}
/**
* 当数据库创建(db文件)的时候调用(此处我们执行当前版本所有的表的创建语句)
*
* @param db 数据库对象
*/
@Override
public void onCreate(SQLiteDatabase db) {
Log.e("TAG", "-----onCreate-----");
}
/**
* 当数据库有版本更新的时候调用,在这里我们根据不同的版本对数据库进行相关修改
*
* @param db 数据库对象
* @param oldVersion 数据库旧版本
* @param newVersion 数据库更新
*/
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
Log.e("TAG", "-----onUpgrade-----");
}
/**
* 拼接生成不同的db文件(如果是IM项目,不同的账号登录应该对应不同的db文件)
*
* @return
*/
private static String getUserDatabaseName() {
return Constant.DATABASE_NAME + "_demo.db";
}
}
相关方法的解析大家可以查看注释,还是比较容易理解的,这里我们需要注意的是默认的数据库db文件保存的位置为 /data/data/'项目包名'/databases/***.db
,如果使用模拟器测试,最好将模拟器版本控制在5.0及以下,这样可以直接查看文件,否则需要自己修改权限;
DbManager 管理/执行 sql 语句
在打开了数据库后,通常我们会再建立一个数据库管理工具类 DbManager
,来管理和执行我们的业务相关的SQL,这样有助于我们管理项目,同样我们可以将其设置为单例模式,我们在DbManager
类中,通过我们自己定义的DbOpenHelper
类,调用getWritableDatabase()
或者getReadableDatabase()
方法,拿到数据库读写操作的SQLiteDatabase
对象来执行SQL语句,个人比较推荐大家使用sql语句,DbManager
类里面就是一些数据的增删改查的方法,这里就不贴代码了,在文章的末尾会给出项目的github地址;
还有一点就是数据库的名称、字段名称在sql语句中出现的频率非常的高,这里推荐大家给不同的表都建立一个 Dao 类,将 数据库的表名称,字段名称写成静态成员变量的形式,这样可以避免我们在写 sql 语句的时候发生数据库表名称、字段名称拼写错误的问题,同时我们可以在此类里面写入对应表的增删改查操作(实际还是引用DbManager类里面的方法),在具体的业务的地方,直接调用此对象,这样也可以让我们的代码更加明确,例如:
public class UserDao {
// 将数据库表中的相关字段名称定义到这里,防止拼写错误
public static final String TABLE_NAME = "users";
public static final String COLUMN_NAME_ID = "id";
public static final String COLUMN_NAME_USER = "user_name";
public static final String COLUMN_NAME_PASSWORD = "password";
public static final String COLUMN_NAME_EMAIL = "email";
public void insert(User user) {
DbManager.getInstance().insertUser(user);
}
public ArrayList<User> selectAll() {
return DbManager.getInstance().selectAllUsers();
}
public void updateByName(User user) {
DbManager.getInstance().updateUserByName(user);
}
public void deleteByUserName(String userName) {
DbManager.getInstance().deleteUserByName(userName);
}
}
关于db文件
类似IM之类的app,通常表的结构是已经拟定好了的,用于区分不同账号的最好的方式就是根据登录的用户,创建单独的db文件,因为SQLiteOpenHelper
类打开的是一个db文件,在用户登录的时候判断创建/打开具体的db文件:
具体的写法可以参考上面类中的
getUserDatabaseName()
方法;
关于数据库的版本更新
随着业务改变,应用的版本也在更新,如果在业务更新的同时,数据库表的数据结构发生了修改,或者增加了新表(通常只有增加表或字段,基本不会删除表和字段),我们需要将我们的数据库的版本往上增加,此时:
- 新用户:调用 onCreate 方法,在此方法内完成数据库表的创建;
-
旧版本用户: 调用 onUpgrade 方法,在此方法内判断旧版的数据库版本,然后逐版本的更新数据库中的表,直至更新到当前新安装的数据库的版本;
@A@
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
Log.e("TAG", "-----onUpgrade-----");
if (oldVersion < 2) {
// 删除原来的表,新建数据库表(基本不会有此操作)
String sql = "drop table user";
db.execSQL(sql);
db.execSQL(USER_CREATE_TABLE);
}
if (oldVersion < 3) {
// 增加列
Log.e("TAG", "-----------onUpgrade--------- 增加 email 列");
String sql = "alter table " + UserDao.TABLE_NAME + " add " + UserDao.COLUMN_NAME_EMAIL + " text";
db.execSQL(sql);
}
if (oldVersion < 4) {
// 删除列(基本不会有此操作)
// SQLite不支持删除列操作,需要进行以下操作来完成
Log.e("TAG", "-----------onUpgrade--------- 删除 password 列");
// 1.创建一张临时表
String sql = "create table temp as select " + UserDao.COLUMN_NAME_ID + ", " + UserDao.COLUMN_NAME_USER + ", " + UserDao.COLUMN_NAME_EMAIL + " from " + UserDao.TABLE_NAME + " where 1 = 1";
db.execSQL(sql);
// 2.删除原来的表
sql = "drop table " + UserDao.TABLE_NAME;
db.execSQL(sql);
// 3.修改临时表的名称
sql = "alter table temp rename to " + UserDao.TABLE_NAME;
db.execSQL(sql);
}
if (oldVersion < 5) {
// 增加表
Log.e("TAG", "-----------onUpgrade--------- 增加表 performance");
db.execSQL(PERFORMANCE_CREATE_TABLE);
String sql = "insert into " + PerformanceDao.TABLE_NAME + "(" + PerformanceDao.COLUMN_NAME_USER_ID + ", " + PerformanceDao.COLUMN_NAME_SALARY + ") values(1, 20.00)";
db.execSQL(sql);
}
}
总结
本案例主要还是偏向于SQLite数据库的使用而不是原理解析,主要是想先知其然,然后知其所以然,如果想要深入了解的,大家可以google下,这方面的资料还是比较多的;
其实Android中SQLite用起来还是比较简单的,不需要向Java中其它数据库连接使用jdbc一样,直接通过 SQLiteOpenHelper 类就可以帮助我们很快速的进行操作数据库;