android数据库框架room1对多,GitHub - xieyangxuejun/sample-android-room: room数据库框架使用...

sample-android-room

room数据库框架使用

基本介绍

Room中有三个主要的组件：

Database:你可以用这个组件来创建一个database holder。注解定义实体的列表，类的内容定义从数据库中获取数据的对象(DAO)。它也是底层连接的主要入口。这个被注解的类是一个继承RoomDatabase的抽象类。在运行时，可以通过调用Room.databaseBuilder() 或者 Room.inMemoryDatabaseBuilder()来得到它的实例。

Entity:这个组件代表一个持有数据库的一个表的类。对每一个entity，都会创建一个表来持有这些item。你必须在Database类中的entities数组中引用这些entity类。entity中的每一个field都将被持久化到数据库，除非使用了@Ignore注解。

DAO:这个组件代表一个作为Data Access Objec的类或者接口。DAO是Room的主要组件，负责定义查询(添加或者删除等)数据库的方法。使用@Database注解的类必须包含一个0参数的，返回类型为@Dao注解过的类的抽象方法。Room会在编译时生成这个类的实现。

主要注解使用

@Entity, 将这个类转换成数据表, indices表指数, primaryKeys主键[]数组类型,和其他

@Igore,如果不喜欢存数据

@Entity(tableName = "user")

data class User(

val name: String,

val sex: Int,

@PrimaryKey(autoGenerate = true)

val id: Long = 0,

val createAt: Long = System.currentTimeMillis()

)

@Dao, 数据操作接口.

@Dao

interface UserDao {

//多个数据

@Insert(onConflict = OnConflictStrategy.REPLACE)

fun insert(vararg user: User): List

@Delete

fun delete(vararg user: User): Int

@Update

fun update(vararg user: User): Int

@Query("SELECT * FROM user")

fun queryAll(): List

@Query("SELECT * FROM user WHERE id IN (:userIDs)")

fun queryByUserIds(vararg userIDs: Long): List

@Query("SELECT * FROM user WHERE id = :id")

fun queryById(id: Long): User

}

@Database, 新建数据表在这里添加,和版本号,如果数据改变一定要改变版本号

@Database(entities = arrayOf(

User::class

), version = databaseVersion)

abstract class AppDatabase : RoomDatabase() {

abstract fun getUserDao(): UserDao

}

创建, 使用单例,这样不用每次创建了,但是room给了一方法==>Room.inMemoryDatabaseBuilder(context, User::class.java)

@SuppressLint("StaticFieldLeak")

class AppDatabaseManager {

private var mContext: Context? = null

private var mAppDatabase: AppDatabase? = null

companion object {

@Volatile

private var mInstance: AppDatabaseManager? = null

fun getInstance(): AppDatabaseManager {

if (mInstance == null) {

synchronized(AppDatabaseManager::class.java) {

if (mInstance == null) {

mInstance = AppDatabaseManager()

}

}

}

return mInstance!!

}

}

fun init(app: Application) {

mInstance?.run {

if (mContext == null) {

mContext = app.applicationContext

}

mAppDatabase = Room.databaseBuilder(

mContext!!, AppDatabase::class.java, databaseName

).build()

}

}

fun getUserDao(): UserDao = mAppDatabase?.getUserDao()!!

}

注意

如果id自增, 需要放在data class 后面赋值为0, 网上说需要无参数的构造函数,不需要

注解@field: SerializedName("user_name")和@ColumnInfo(name = "user_name"),前者是序列化的变量名,后者是数据表的变量名.如果不写就用类成员变量名.

重点:不要在主线程操作数据(CRUD).....

Insert插入多个数据返回的是List ids

delete也有返回值是Int,删除的个数, 同update

查询就有很多了..order..like..=..

使用

初始化

override fun onCreate(savedInstanceState: Bundle?) {

super.onCreate(savedInstanceState)

setContentView(R.layout.activity_main)

Stetho.initializeWithDefaults(this)

AppDatabaseManager.getInstance().init(this.application)

}

增删改查

fun clickInsert(view: View) {

getFlowable({

AppDatabaseManager.getInstance().getUserDao().insert(*arrayOf(

User("谢杨学君", 1, 1),

User("谢杨学君", 1, 2),

User("谢杨学君", 1),

User("谢杨学君", 1),

User("谢杨学君", 1)

))

}).subscribe({

Log.d("===>", "success (size= ${it.size} and ${it.joinToString()})")

}).isDisposed

}

fun clickDelete(view: View) {

getFlowable({

AppDatabaseManager.getInstance().getUserDao().delete(*arrayOf(

User("谢杨学君", 1, 1),

User("谢杨学君", 1, 2)

))

}).subscribe({

Log.d("===>", "success (count = $it)")

}).isDisposed

}

fun clickUpdate(view: View) {

getFlowable({

AppDatabaseManager.getInstance().getUserDao().delete(*arrayOf(

User("谢杨学君", 1),

User("谢杨学君", 2)

))

}).subscribe({

Log.d("===>", "success (count = $it)")

}).isDisposed

}

fun clickQueryAll(view: View) {

getFlowable({

AppDatabaseManager.getInstance().getUserDao().queryAll()

}).subscribe({

val fromList = JsonParserUtil.fromList(it)

tv_message.text = fromList

}).isDisposed

}

fun getFlowable(method: () -> T): Flowable {

return object : Flowable() {

override fun subscribeActual(s: Subscriber) {

try {

s.onNext(method.invoke())

} catch (e: Exception) {

e.printStackTrace()

s.onError(e)

}

s.onComplete()

}

}.subscribeOn(Schedulers.io())

.observeOn(AndroidSchedulers.mainThread())

}

总结一下

可以当成单独的模块来使用, fork然后写自己的Entities就行了.