本文是对SQLite操作的文章，分两种操作方式：一种是传统的SQLiteOpenHelper，另一种是性能表现较好的第三方GreenDao。
SQLiteOpenHelper
SQLiteOpenHelper 表示一个连接，每个连接对应着一个数据库，数据库内有多张表。
使用数据库时需继承SQLiteOpenHelper抽象类
- onCreate
在onCreate方法中创建或打开数据库，如果DB存在则连接，若不存在则会执行onCreate中创建表的SQL语句，所以create table时不需要if not exists
原话： this class takes care of opening the database if it exists, creating it if it does not, and upgrading it as necessary
- onUpgrade
升级的是DB，并不是表。DB的升级表示表数量或结构会有变化，至于是一张表还是多张表都可以。
通过oldVersion和newVersion的比较，程序员需要手动一级一级的升，这与GreenDao的升级比，还是繁琐很多，需要程序员注意各version的差异。
/**
* Created by mr.lin on 2018/5/28.
*/
class OpenHelper(context: Context?, var name: String?, factory: SQLiteDatabase.CursorFactory?, version: Int) : SQLiteOpenHelper(context, name, factory, version) {
override fun onCreate(db: SQLiteDatabase?) {
db?.execSQL("create table Animal (id integer primary key,name text,age integer)")
}
override fun onUpgrade(db: SQLiteDatabase?, oldVersion: Int, newVersion: Int) {
if (newVersion == 2) {
db?.execSQL("alert table Animal add gender integer")
}
}
}
SQLiteOpenHelper只是一个连接，实际的操作还需要SQLiteDatabase
private var link: SQLiteOpenHelper = OpenHelper(App.instance(), "animal.db", null, 1)
link.writableDatabase
link.readableDatabase
增
public long insert(String table, String nullColumnHack, ContentValues values)
当插入的一条数据，每个字段都为空时是插入不成功的，如果发生此情况nullColumnHack所指的字段将会插入Null以保证这条数据插入的成功
SQL doesn't allow inserting a completely empty row without naming at least one column name. If your provided <code>values</code> is empty, no column names are known and an empty row can't be inserted. If not set to null, the <code>nullColumnHack</code> parameter provides the name of nullable column name to explicitly insert a NULL into in the case where your <code>values</code> is empty.
val values = ContentValues()
values.put("name", animal.name)
values.put("age", animal.age)
return link.writableDatabase.insert("Animal", null, values)//返回行号，-1出错
删
public int delete(String table, String whereClause, String[] whereArgs)
参数分别为表名、查询条件、查询参数，返回影响的行数
link.writableDatabase.delete("Animal", "name=?", arrayOf(animal.name))
改
public int update(String table, ContentValues values, String whereClause, String[] whereArgs)
参数分别为表名、要更新为的记录、查询条件、查询参数，返回影响的行数
link.writableDatabase.update("Animal", values, "name=?", arrayOf(animal.name))
查
个人喜欢用rawQuery，
public Cursor rawQuery(String sql, String[] selectionArgs)
传入sql查询语句与参数，返回游标
link.writableDatabase.rawQuery("select * from Animal", null)
注
如果游标不为空，最初在-1位置，需要moveToFirst到0位置
线程问题
- 当多个线程使用SQLiteOpenHelper时，其中一个线程关闭了DB则其他正在读写的线程会报异常
- 当表中数据多时查询操作会耗时
方案：
SQLiteOpenHelper采用单例的模式与DB对应
所有增删改查的操作使用先进先出线程池，并设置回调回主线程
GreenDao
添加库
第三个红框mavenCentral()依个人选择
创建实体类添加红框中的注解，不要引错包！！
第四步结果为第三步图和
至此GreenDao已引入成功。
注意
实体类不要用kotlin写，可能与greenDAO的Code generation(代码生成)方式有关，否则实体类不会自动Generated且greendaobao目录下的相关类也不会生成。
猜测：GreenDAO的性能与java的字节码有关，所以导致实体不能使用java以外的，纯属猜测
private val helper = DaoOpenHelper(App.instance(), "animal.db", null)
private val session = DaoMaster(helper.writableDb).newSession()
private val dao = session.animalDao
helper：DaoOpenHelper的父类为SQLiteOpenHelper，因此它是一个连接
session：直译会话，其下包含了此DB下的所有表
dao：需要操作的表
增
public long insert(T entity)
传入实体直接插入表，返回行号
dao.insert(animal)
删
public void delete(T entity)
传入实体删除记录，删除依据主键判断
dao.delete(animal)
改
dao.update(animal)
查
return dao.queryBuilder().where(AnimalDao.Properties.Name.eq(animal.name)).list()//类似build条件，将属性视为对象进行范围设置
return dao.queryRaw("where name = ?",animal.name)//同sql
return dao.loadAll()//加载全部
由于增删改的参数都为实体，所以最好将主键设置为实体类中的变量，自增变量会导致操作异常。
升级
private val helper = DaoOpenHelper(App.instance(), "animal.db", null)//这里没有使用默认提供的DevOpenHelper，它会在升级的时候删除所有旧表
DevOpenHelper的内部
@Override
public void onUpgrade(Database db, int oldVersion, int newVersion) {
Log.i("greenDAO", "Upgrading schema from version " + oldVersion + " to " + newVersion + " by dropping all tables");
dropAllTables(db, true);//删除
onCreate(db);//重建
}
DaoOpenHelper
/**
* Created by mr.lin on 2018/5/29.
*/
class DaoOpenHelper(context: Context?, name: String?, factory: SQLiteDatabase.CursorFactory?) : DaoMaster.OpenHelper(context, name, factory) {
override fun onUpgrade(db: Database?, oldVersion: Int, newVersion: Int) {
if (oldVersion<newVersion){
MigrationHelper.getInstance().migrate(db,AnimalDao::class.java)
}
}
}
升级的时候调用MigrationHelper将DB更新且数据不丢失，这里不详解了，MigrationHelper是常见的解决方式网上分析的很多。
原理：
- 创建临时表
- 旧表中的数据迁移到临时表
- 删除旧表
- 创建新表
- 将临时表中的数据迁移到新表
- 删除临时表
升级注意事项
升级时若表增加字段
注意重新make project，实体类会重新Generated，构造函数会与之前不同需要手动重载
若增加的字段为int，需要设置默认值不能为空，也可设为String。为什么呢？？
public static void createTable(Database db, boolean ifNotExists) {
String constraint = ifNotExists? "IF NOT EXISTS ": "";
db.execSQL("CREATE TABLE " + constraint + "\"ANIMAL\" (" + //
"\"NAME\" TEXT," + // 0: name
"\"AGE\" INTEGER NOT NULL ," + // 1: age
"\"GENDER\" TEXT);"); // 2: gender
}
Dao类在创建表时产生的SQL语句INTEGER NOT NULL，若新增字段为int，旧表中无此字段，则临时表数据迁移时就会出错。
同时使用SQLiteOpenHelper和GreenDao
GreenDao除DB的名称是按要求起的外，其他表名、字段名都是大写，即使你create table 中的表名是小写。如果SQLiteOpenHelper与GreenDao同时使用注意字段名。
DB的version，升级时两者需要有相同的版本号，否则同一DB不同类型的连接会
android.database.sqlite.SQLiteException: Can't downgrade database from version 26 to 1
